2 * Copyright (C) 2008 - 2016 The Geeqie Team
4 * Authors: Vladimir Nadvornik, Laurent Monin
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
26 #include <gdk-pixbuf/gdk-pixbuf.h>
28 #include <glib-object.h>
34 #include "main-defines.h"
38 #include "pixbuf-util.h"
39 #include "ui-fileops.h"
42 #include "ui-utildlg.h"
44 GtkWidget *window_new(const gchar *role, const gchar *icon, const gchar *icon_file, const gchar *subtitle)
50 window = gtk_window_new();
52 window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
54 if (!window) return nullptr;
58 title = g_strdup_printf("%s - %s", subtitle, GQ_APPNAME);
62 title = g_strdup_printf("%s", GQ_APPNAME);
65 gtk_window_set_title(GTK_WINDOW(window), title);
68 window_set_icon(window, icon, icon_file);
69 gtk_window_set_role(GTK_WINDOW(window), role);
74 void window_set_icon(GtkWidget *window, const gchar *icon, const gchar *file)
76 if (!icon && !file) icon = PIXBUF_INLINE_ICON;
82 pixbuf = pixbuf_inline(icon);
85 gtk_window_set_icon(GTK_WINDOW(window), pixbuf);
86 g_object_unref(pixbuf);
91 gtk_window_set_icon_from_file(GTK_WINDOW(window), file, nullptr);
95 gboolean window_maximized(GtkWidget *window)
99 if (!window || !gtk_widget_get_window(window)) return FALSE;
101 state = gdk_window_get_state(gtk_widget_get_window(window));
102 return !!(state & GDK_WINDOW_STATE_MAXIMIZED);
106 *-----------------------------------------------------------------------------
107 * Open browser with the help Documentation
108 *-----------------------------------------------------------------------------
111 static gchar *command_result(const gchar *binary, const gchar *command)
113 gchar *result = nullptr;
118 if (!binary || binary[0] == '\0') return nullptr;
119 if (!file_in_path(binary)) return nullptr;
121 if (!command || command[0] == '\0') return g_strdup(binary);
122 if (command[0] == '!') return g_strdup(command + 1);
124 f = popen(command, "r");
125 if (!f) return nullptr;
127 while ((l = fread(buf, sizeof(gchar), sizeof(buf), f)) > 0)
133 while (n < l && buf[n] != '\n' && buf[n] != '\r') n++;
134 if (n > 0) result = g_strndup(buf, n);
143 static int help_browser_command(const gchar *command, const gchar *path)
151 if (!command || !path) return retval;
153 DEBUG_1("Help command pre \"%s\", \"%s\"", command, path);
155 buf = g_strdup(command);
156 begin = strstr(buf, "%s");
163 result = g_strdup_printf("%s%s%s &", begin, path, end);
167 result = g_strdup_printf("%s \"%s\" &", command, path);
171 DEBUG_1("Help command post [%s]", result);
173 retval = runcmd(result);
174 DEBUG_1("Help command exit code: %d", retval);
181 * each set of 2 strings is one browser:
182 * the 1st is the binary to look for in the path
183 * the 2nd has 3 capabilities:
184 * NULL exec binary with html file path as command line
185 * string exec string and use results for command line
186 * !string use text following ! as command line, replacing optional %s with html file path
188 static const gchar *html_browsers[] =
190 /* Our specific script */
191 GQ_APPNAME_LC "_html_browser", nullptr,
192 /* Redhat has a nifty htmlview script to start the user's preferred browser */
194 /* Debian has even better approach with alternatives */
195 "sensible-browser", nullptr,
197 "gconftool-2", "gconftool-2 -g /desktop/gnome/url-handlers/http/command",
199 "kfmclient", "!kfmclient exec \"%s\"",
203 "konqueror", nullptr,
205 "opera", "!opera --remote 'openURL(%s,new-page)'",
209 static void help_browser_run(const gchar *path)
211 const gchar *name = options->helpers.html_browser.command_name;
212 const gchar *cmd = options->helpers.html_browser.command_line;
213 gchar *result = nullptr;
219 if ((name && *name) || (cmd && *cmd)) {
220 DEBUG_1("Trying browser: name=%s command=%s", name, cmd);
221 result = command_result(name, cmd);
222 DEBUG_1("Result: %s", result);
225 int ret = help_browser_command(result, path);
232 if (!html_browsers[i]) break;
233 name = html_browsers[i++];
234 cmd = html_browsers[i++];
239 log_printf("Unable to detect an installed browser.\n");
247 *-----------------------------------------------------------------------------
249 *-----------------------------------------------------------------------------
252 static GtkWidget *help_window = nullptr;
254 static void help_window_destroy_cb(GtkWidget *, gpointer)
256 help_window = nullptr;
259 void help_window_show(const gchar *key)
263 if (key && strstr(key, ".html") != nullptr)
265 path = g_build_filename(gq_htmldir, key, NULL);
268 if (g_strcmp0(key, "index.html") == 0)
270 path = g_build_filename("https://www.geeqie.org/help/", "GuideIndex.html", NULL);
274 path = g_build_filename("https://www.geeqie.org/help/", key, NULL);
277 help_browser_run(path);
284 gtk_window_present(GTK_WINDOW(help_window));
285 if (key) help_window_set_key(help_window, key);
289 if (!strcmp(key, "release_notes"))
291 path = g_build_filename(gq_helpdir, "README.html", NULL);
295 path = g_build_filename("file://", gq_helpdir, "README.html", NULL);
296 help_browser_run(path);
302 path = g_build_filename(gq_helpdir, "README.md", NULL);
303 help_window = help_window_new(_("Help"), "help", path, key);
306 g_signal_connect(G_OBJECT(help_window), "destroy",
307 G_CALLBACK(help_window_destroy_cb), NULL);
312 path = g_build_filename(gq_helpdir, "ChangeLog.html", NULL);
316 path = g_build_filename("file://", gq_helpdir, "ChangeLog.html", NULL);
317 help_browser_run(path);
323 path = g_build_filename(gq_helpdir, "ChangeLog", NULL);
324 help_window = help_window_new(_("Help"), "help", path, key);
327 g_signal_connect(G_OBJECT(help_window), "destroy",
328 G_CALLBACK(help_window_destroy_cb), NULL);
335 *-----------------------------------------------------------------------------
336 * on-line help search dialog
337 *-----------------------------------------------------------------------------
340 struct HelpSearchData {
342 GtkWidget *edit_widget;
346 static void help_search_window_show_icon_press(GtkEntry *, GtkEntryIconPosition, GdkEvent *, gpointer userdata)
348 auto hsd = static_cast<HelpSearchData *>(userdata);
350 g_free(hsd->text_entry);
351 hsd->text_entry = g_strdup("");
352 gq_gtk_entry_set_text(GTK_ENTRY(hsd->edit_widget), hsd->text_entry);
355 static void help_search_window_ok_cb(GenericDialog *, gpointer data)
357 auto hsd = static_cast<HelpSearchData *>(data);
358 gchar *search_command;
360 search_command = g_strconcat(options->help_search_engine,
361 gq_gtk_entry_get_text(GTK_ENTRY(hsd->edit_widget)),
363 help_browser_run(search_command);
364 g_free(search_command);
369 static void help_search_window_cancel_cb(GenericDialog *, gpointer data)
371 auto hsd = static_cast<HelpSearchData *>(data);
376 void help_search_window_show()
383 auto hsd = g_new0(HelpSearchData, 1);
384 hsd->gd = gd = generic_dialog_new(_("On-line help search"), "help_search",
386 help_search_window_cancel_cb, hsd);
387 generic_dialog_add_message(gd, nullptr, _("Search the on-line help files.\n"), nullptr, FALSE);
389 generic_dialog_add_button(gd, GQ_ICON_OK, "OK",
390 help_search_window_ok_cb, TRUE);
392 label1 = pref_label_new(GENERIC_DIALOG(gd)->vbox, _("Search engine:"));
393 gtk_label_set_xalign(GTK_LABEL(label1), 0.0);
394 gtk_label_set_yalign(GTK_LABEL(label1), 0.5);
396 label2 = pref_label_new(GENERIC_DIALOG(gd)->vbox, options->help_search_engine);
397 gtk_label_set_xalign(GTK_LABEL(label2), 0.0);
398 gtk_label_set_yalign(GTK_LABEL(label2), 0.5);
400 pref_spacer(GENERIC_DIALOG(gd)->vbox, 0);
402 table = pref_table_new(gd->vbox, 3, 1, FALSE, TRUE);
403 pref_table_label(table, 0, 0, _("Search terms:"), GTK_ALIGN_END);
404 hsd->edit_widget = gtk_entry_new();
405 gtk_widget_set_size_request(hsd->edit_widget, 300, -1);
406 gq_gtk_grid_attach_default(GTK_GRID(table), hsd->edit_widget, 1, 2, 0, 1);
407 generic_dialog_attach_default(gd, hsd->edit_widget);
408 gtk_widget_show(hsd->edit_widget);
410 gtk_entry_set_icon_from_icon_name(GTK_ENTRY(hsd->edit_widget),
411 GTK_ENTRY_ICON_SECONDARY, GQ_ICON_CLEAR);
412 gtk_entry_set_icon_tooltip_text (GTK_ENTRY(hsd->edit_widget),
413 GTK_ENTRY_ICON_SECONDARY, _("Clear"));
414 g_signal_connect(GTK_ENTRY(hsd->edit_widget), "icon-press",
415 G_CALLBACK(help_search_window_show_icon_press), hsd);
417 gtk_widget_grab_focus(hsd->edit_widget);
419 gtk_widget_show(gd->dialog);
421 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */