Include a Other Software section in Help file
[geeqie.git] / src / window.c
index 18da4ff..7495759 100644 (file)
@@ -1,22 +1,34 @@
 /*
- * Geeqie
- * Copyright (C) 2008 The Geeqie Team
+ * Copyright (C) 2008 - 2016 The Geeqie Team
  *
- * Authors: Vladimir Nadvornik / Laurent Monin
+ * Authors: Vladimir Nadvornik, Laurent Monin
  *
- * This software is released under the GNU General Public License (GNU GPL).
- * Please read the included file COPYING for more information.
- * This software comes with no warranty of any kind, use at your own risk!
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
 #include "main.h"
 #include "window.h"
 
+#include "misc.h"
 #include "pixbuf_util.h"
 #include "ui_fileops.h"
 #include "ui_help.h"
+#include "ui_misc.h"
+#include "ui_utildlg.h"
 
-GtkWidget *window_new(GtkWindowType type, const gchar *name, const gchar *icon,
+GtkWidget *window_new(GtkWindowType type, const gchar *role, const gchar *icon,
                      const gchar *icon_file, const gchar *subtitle)
 {
        gchar *title;
@@ -38,8 +50,7 @@ GtkWidget *window_new(GtkWindowType type, const gchar *name, const gchar *icon,
        g_free(title);
 
        window_set_icon(window, icon, icon_file);
-       gtk_window_set_role(GTK_WINDOW(window), name);
-       gtk_window_set_wmclass(GTK_WINDOW(window), name, GQ_WMCLASS);
+       gtk_window_set_role(GTK_WINDOW(window), role);
 
        return window;
 }
@@ -65,14 +76,14 @@ void window_set_icon(GtkWidget *window, const gchar *icon, const gchar *file)
                }
 }
 
-gint window_maximized(GtkWidget *window)
+gboolean window_maximized(GtkWidget *window)
 {
        GdkWindowState state;
 
-       if (!window || !window->window) return FALSE;
+       if (!window || !gtk_widget_get_window(window)) return FALSE;
 
-       state = gdk_window_get_state(window->window);
-       return (state & GDK_WINDOW_STATE_MAXIMIZED);
+       state = gdk_window_get_state(gtk_widget_get_window(window));
+       return !!(state & GDK_WINDOW_STATE_MAXIMIZED);
 }
 
 /*
@@ -113,14 +124,15 @@ static gchar *command_result(const gchar *binary, const gchar *command)
        return result;
 }
 
-static void help_browser_command(const gchar *command, const gchar *path)
+static int help_browser_command(const gchar *command, const gchar *path)
 {
        gchar *result;
        gchar *buf;
        gchar *begin;
        gchar *end;
+       int retval = -1;
 
-       if (!command || !path) return;
+       if (!command || !path) return retval;
 
        DEBUG_1("Help command pre \"%s\", \"%s\"", command, path);
 
@@ -142,9 +154,11 @@ static void help_browser_command(const gchar *command, const gchar *path)
 
        DEBUG_1("Help command post [%s]", result);
 
-       system(result);
+       retval = runcmd(result);
+       DEBUG_1("Help command exit code: %d", retval);
 
        g_free(result);
+       return retval;
 }
 
 /*
@@ -172,22 +186,36 @@ static gchar *html_browsers[] =
        "mozilla",      NULL,
        "konqueror",    NULL,
        "netscape",     NULL,
+       "opera",        "!opera --remote 'openURL(%s,new-page)'",
        NULL,           NULL
 };
 
-static void help_browser_run(void)
+static void help_browser_run(const gchar *path)
 {
-       gchar *path;
-       gchar *result;
+       gchar *name = options->helpers.html_browser.command_name;
+       gchar *cmd = options->helpers.html_browser.command_line;
+       gchar *result = NULL;
        gint i;
 
-       result = command_result(options->helpers.html_browser.command_name, options->helpers.html_browser.command_line);
-
        i = 0;
-       while (!result && html_browsers[i])
+       while (!result)
                {
-               result = command_result(html_browsers[i], html_browsers[i+1]);
-               i += 2;
+               if ((name && *name) || (cmd && *cmd)) {
+                       DEBUG_1("Trying browser: name=%s command=%s", name, cmd);
+                       result = command_result(name, cmd);
+                       DEBUG_1("Result: %s", result);
+                       if (result)
+                               {
+                               int ret = help_browser_command(result, path);
+
+                               if (ret == 0) break;
+                               g_free(result);
+                               result = NULL;
+                       }
+               }
+               if (!html_browsers[i]) break;
+               name = html_browsers[i++];
+               cmd = html_browsers[i++];
                }
 
        if (!result)
@@ -196,10 +224,6 @@ static void help_browser_run(void)
                return;
                }
 
-       path = g_build_filename(options->documentation.htmldir, "index.html", NULL);
-       help_browser_command(result, path);
-       g_free(path);
-
        g_free(result);
 }
 
@@ -220,9 +244,22 @@ void help_window_show(const gchar *key)
 {
        gchar *path;
 
-       if (key && strcmp(key, "html_contents") == 0)
+       if (key && strstr(key, ".html") != 0)
                {
-               help_browser_run();
+               path = g_build_filename(gq_htmldir, key, NULL);
+               if (!isfile(path))
+                       {
+                       if (g_strcmp0(key, "index.html") == 0)
+                               {
+                               path = g_build_filename("http://geeqie.org/help/", "GuideIndex.html", NULL);
+                               }
+                       else
+                               {
+                               path = g_build_filename("http://geeqie.org/help/", key, NULL);
+                               }
+                       }
+               help_browser_run(path);
+               g_free(path);
                return;
                }
 
@@ -233,11 +270,146 @@ void help_window_show(const gchar *key)
                return;
                }
 
-       path = g_build_filename(options->documentation.helpdir, "README", NULL);
-       help_window = help_window_new(_("Help"), GQ_WMCLASS, "help", path, key);
-       g_free(path);
+       if (!strcmp(key, "release_notes"))
+               {
+               path = g_build_filename(gq_helpdir, "README.html", NULL);
+               if (isfile(path))
+                       {
+                       g_free(path);
+                       path = g_build_filename("file://", gq_helpdir, "README.html", NULL);
+                       help_browser_run(path);
+                       g_free(path);
+                       }
+               else
+                       {
+                       g_free(path);
+                       path = g_build_filename(gq_helpdir, "README.md", NULL);
+                       help_window = help_window_new(_("Help"), "help", path, key);
+                       g_free(path);
+
+                       g_signal_connect(G_OBJECT(help_window), "destroy",
+                                        G_CALLBACK(help_window_destroy_cb), NULL);
+                       }
+               }
+       else
+               {
+               path = g_build_filename(gq_helpdir, "ChangeLog.html", NULL);
+               if (isfile(path))
+                       {
+                       g_free(path);
+                       path = g_build_filename("file://", gq_helpdir, "ChangeLog.html", NULL);
+                       help_browser_run(path);
+                       g_free(path);
+                       }
+               else
+                       {
+                       g_free(path);
+                       path = g_build_filename(gq_helpdir, "ChangeLog", NULL);
+                       help_window = help_window_new(_("Help"), "help", path, key);
+                       g_free(path);
+
+                       g_signal_connect(G_OBJECT(help_window), "destroy",
+                                        G_CALLBACK(help_window_destroy_cb), NULL);
+                       }
+
+               }
+}
+
+/*
+ *-----------------------------------------------------------------------------
+ * on-line help search dialog
+ *-----------------------------------------------------------------------------
+ */
+
+typedef struct _HelpSearchData HelpSearchData;
+struct _HelpSearchData {
+       GenericDialog *gd;
+       GtkWidget *edit_widget;
+       gchar *text_entry;
+};
+
+static void help_search_window_show_icon_press(GtkEntry *entry, GtkEntryIconPosition pos,
+                                                                       GdkEvent *event, gpointer userdata)
+{
+       HelpSearchData *hsd = userdata;
+
+       g_free(hsd->text_entry);
+       hsd->text_entry = g_strdup("");
+       gtk_entry_set_text(GTK_ENTRY(hsd->edit_widget), hsd->text_entry);
+}
+
+static void help_search_window_ok_cb(GenericDialog *gd, gpointer data)
+{
+       HelpSearchData *hsd = data;
+       gchar *search_command;
+
+       search_command = g_strconcat(options->help_search_engine,
+                                               gtk_entry_get_text(GTK_ENTRY(hsd->edit_widget)),
+                                               NULL);
+       help_browser_run(search_command);
+       g_free(search_command);
 
-       g_signal_connect(G_OBJECT(help_window), "destroy",
-                        G_CALLBACK(help_window_destroy_cb), NULL);
+       g_free(hsd);
 }
 
+static void help_search_window_cancel_cb(GenericDialog *gd, gpointer data)
+{
+       HelpSearchData *hsd = data;
+
+       g_free(hsd);
+}
+
+void help_search_window_show()
+{
+       HelpSearchData *hsd;
+       GenericDialog *gd;
+       GtkWidget *table;
+       GtkWidget *label1;
+       GtkWidget *label2;
+
+       hsd = g_new0(HelpSearchData, 1);
+       hsd->gd = gd = generic_dialog_new(_("On-line help search"), "help_search",
+                               NULL, TRUE,
+                               help_search_window_cancel_cb, hsd);
+       generic_dialog_add_message(gd, NULL, _("Search the on-line help files.\n"), NULL, FALSE);
+
+       generic_dialog_add_button(gd, GTK_STOCK_OK, NULL,
+                                 help_search_window_ok_cb, TRUE);
+
+       label1 = pref_label_new(GENERIC_DIALOG(gd)->vbox, _("Search engine:"));
+#if GTK_CHECK_VERSION(3,16,0)
+       gtk_label_set_xalign(GTK_LABEL(label1), 0.0);
+       gtk_label_set_yalign(GTK_LABEL(label1), 0.5);
+#else
+   gtk_misc_set_alignment(GTK_MISC(label1), 0.0, 0.5);
+#endif
+
+       label2 = pref_label_new(GENERIC_DIALOG(gd)->vbox, options->help_search_engine);
+#if GTK_CHECK_VERSION(3,16,0)
+       gtk_label_set_xalign(GTK_LABEL(label2), 0.0);
+       gtk_label_set_yalign(GTK_LABEL(label2), 0.5);
+#else
+   gtk_misc_set_alignment(GTK_MISC(label2), 0.0, 0.5);
+#endif
+       pref_spacer(GENERIC_DIALOG(gd)->vbox, 0);
+
+       table = pref_table_new(gd->vbox, 3, 1, FALSE, TRUE);
+       pref_table_label(table, 0, 0, _("Search terms:"), 1.0);
+       hsd->edit_widget = gtk_entry_new();
+       gtk_widget_set_size_request(hsd->edit_widget, 300, -1);
+       gtk_table_attach_defaults(GTK_TABLE(table), hsd->edit_widget, 1, 2, 0, 1);
+       generic_dialog_attach_default(gd, hsd->edit_widget);
+       gtk_widget_show(hsd->edit_widget);
+
+       gtk_entry_set_icon_from_stock(GTK_ENTRY(hsd->edit_widget),
+                                               GTK_ENTRY_ICON_SECONDARY, GTK_STOCK_CLEAR);
+       gtk_entry_set_icon_tooltip_text (GTK_ENTRY(hsd->edit_widget),
+                                               GTK_ENTRY_ICON_SECONDARY, _("Clear"));
+       g_signal_connect(GTK_ENTRY(hsd->edit_widget), "icon-press",
+                                               G_CALLBACK(help_search_window_show_icon_press), hsd);
+
+       gtk_widget_grab_focus(hsd->edit_widget);
+
+       gtk_widget_show(gd->dialog);
+}
+/* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */