Include a Other Software section in Help file
[geeqie.git] / src / window.c
index c1887f4..7495759 100644 (file)
@@ -1,12 +1,21 @@
 /*
- * Geeqie
- * Copyright (C) 2008 - 2010 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"
@@ -16,6 +25,8 @@
 #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 *role, const gchar *icon,
                      const gchar *icon_file, const gchar *subtitle)
@@ -69,9 +80,9 @@ 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);
+       state = gdk_window_get_state(gtk_widget_get_window(window));
        return !!(state & GDK_WINDOW_STATE_MAXIMIZED);
 }
 
@@ -179,15 +190,14 @@ static gchar *html_browsers[] =
        NULL,           NULL
 };
 
-static void help_browser_run(void)
+static void help_browser_run(const gchar *path)
 {
        gchar *name = options->helpers.html_browser.command_name;
        gchar *cmd = options->helpers.html_browser.command_line;
-       gchar *path = g_build_filename(GQ_HTMLDIR, "index.html", NULL);
        gchar *result = NULL;
        gint i;
 
-       i = 0;  
+       i = 0;
        while (!result)
                {
                if ((name && *name) || (cmd && *cmd)) {
@@ -197,7 +207,7 @@ static void help_browser_run(void)
                        if (result)
                                {
                                int ret = help_browser_command(result, path);
-                               
+
                                if (ret == 0) break;
                                g_free(result);
                                result = NULL;
@@ -214,7 +224,6 @@ static void help_browser_run(void)
                return;
                }
 
-       g_free(path);
        g_free(result);
 }
 
@@ -235,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;
                }
 
@@ -248,12 +270,146 @@ void help_window_show(const gchar *key)
                return;
                }
 
-       path = g_build_filename(GQ_HELPDIR, "README", NULL);
-       help_window = help_window_new(_("Help"), "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: */