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.
27 #include "main-defines.h"
31 #include "pixbuf-util.h"
32 #include "ui-fileops.h"
35 #include "ui-utildlg.h"
37 GtkWidget *window_new(const gchar *role, const gchar *icon, const gchar *icon_file, const gchar *subtitle)
43 window = gtk_window_new();
45 window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
47 if (!window) return nullptr;
51 title = g_strdup_printf("%s - %s", subtitle, GQ_APPNAME);
55 title = g_strdup_printf("%s", GQ_APPNAME);
58 gtk_window_set_title(GTK_WINDOW(window), title);
61 window_set_icon(window, icon, icon_file);
62 gtk_window_set_role(GTK_WINDOW(window), role);
67 void window_set_icon(GtkWidget *window, const gchar *icon, const gchar *file)
69 if (!icon && !file) icon = PIXBUF_INLINE_ICON;
75 pixbuf = pixbuf_inline(icon);
78 gtk_window_set_icon(GTK_WINDOW(window), pixbuf);
79 g_object_unref(pixbuf);
84 gtk_window_set_icon_from_file(GTK_WINDOW(window), file, nullptr);
88 gboolean window_maximized(GtkWidget *window)
92 if (!window || !gtk_widget_get_window(window)) return FALSE;
94 state = gdk_window_get_state(gtk_widget_get_window(window));
95 return !!(state & GDK_WINDOW_STATE_MAXIMIZED);
99 *-----------------------------------------------------------------------------
100 * Open browser with the help Documentation
101 *-----------------------------------------------------------------------------
104 static gchar *command_result(const gchar *binary, const gchar *command)
106 gchar *result = nullptr;
111 if (!binary || binary[0] == '\0') return nullptr;
112 if (!file_in_path(binary)) return nullptr;
114 if (!command || command[0] == '\0') return g_strdup(binary);
115 if (command[0] == '!') return g_strdup(command + 1);
117 f = popen(command, "r");
118 if (!f) return nullptr;
120 while ((l = fread(buf, sizeof(gchar), sizeof(buf), f)) > 0)
126 while (n < l && buf[n] != '\n' && buf[n] != '\r') n++;
127 if (n > 0) result = g_strndup(buf, n);
136 static int help_browser_command(const gchar *command, const gchar *path)
144 if (!command || !path) return retval;
146 DEBUG_1("Help command pre \"%s\", \"%s\"", command, path);
148 buf = g_strdup(command);
149 begin = strstr(buf, "%s");
156 result = g_strdup_printf("%s%s%s &", begin, path, end);
160 result = g_strdup_printf("%s \"%s\" &", command, path);
164 DEBUG_1("Help command post [%s]", result);
166 retval = runcmd(result);
167 DEBUG_1("Help command exit code: %d", retval);
174 * each set of 2 strings is one browser:
175 * the 1st is the binary to look for in the path
176 * the 2nd has 3 capabilities:
177 * NULL exec binary with html file path as command line
178 * string exec string and use results for command line
179 * !string use text following ! as command line, replacing optional %s with html file path
181 static const gchar *html_browsers[] =
183 /* Our specific script */
184 GQ_APPNAME_LC "_html_browser", nullptr,
185 /* Redhat has a nifty htmlview script to start the user's preferred browser */
187 /* Debian has even better approach with alternatives */
188 "sensible-browser", nullptr,
190 "gconftool-2", "gconftool-2 -g /desktop/gnome/url-handlers/http/command",
192 "kfmclient", "!kfmclient exec \"%s\"",
196 "konqueror", nullptr,
198 "opera", "!opera --remote 'openURL(%s,new-page)'",
202 static void help_browser_run(const gchar *path)
204 const gchar *name = options->helpers.html_browser.command_name;
205 const gchar *cmd = options->helpers.html_browser.command_line;
206 gchar *result = nullptr;
212 if ((name && *name) || (cmd && *cmd)) {
213 DEBUG_1("Trying browser: name=%s command=%s", name, cmd);
214 result = command_result(name, cmd);
215 DEBUG_1("Result: %s", result);
218 int ret = help_browser_command(result, path);
225 if (!html_browsers[i]) break;
226 name = html_browsers[i++];
227 cmd = html_browsers[i++];
232 log_printf("Unable to detect an installed browser.\n");
240 *-----------------------------------------------------------------------------
242 *-----------------------------------------------------------------------------
245 static GtkWidget *help_window = nullptr;
247 static void help_window_destroy_cb(GtkWidget *, gpointer)
249 help_window = nullptr;
252 void help_window_show(const gchar *key)
256 if (key && strstr(key, ".html") != nullptr)
258 path = g_build_filename(gq_htmldir, key, NULL);
261 if (g_strcmp0(key, "index.html") == 0)
263 path = g_build_filename("https://www.geeqie.org/help/", "GuideIndex.html", NULL);
267 path = g_build_filename("https://www.geeqie.org/help/", key, NULL);
270 help_browser_run(path);
277 gtk_window_present(GTK_WINDOW(help_window));
278 if (key) help_window_set_key(help_window, key);
282 if (!strcmp(key, "release_notes"))
284 path = g_build_filename(gq_helpdir, "README.html", NULL);
288 path = g_build_filename("file://", gq_helpdir, "README.html", NULL);
289 help_browser_run(path);
295 path = g_build_filename(gq_helpdir, "README.md", NULL);
296 help_window = help_window_new(_("Help"), "help", path, key);
299 g_signal_connect(G_OBJECT(help_window), "destroy",
300 G_CALLBACK(help_window_destroy_cb), NULL);
305 path = g_build_filename(gq_helpdir, "ChangeLog.html", NULL);
309 path = g_build_filename("file://", gq_helpdir, "ChangeLog.html", NULL);
310 help_browser_run(path);
316 path = g_build_filename(gq_helpdir, "ChangeLog", NULL);
317 help_window = help_window_new(_("Help"), "help", path, key);
320 g_signal_connect(G_OBJECT(help_window), "destroy",
321 G_CALLBACK(help_window_destroy_cb), NULL);
328 *-----------------------------------------------------------------------------
329 * on-line help search dialog
330 *-----------------------------------------------------------------------------
333 struct HelpSearchData {
335 GtkWidget *edit_widget;
339 static void help_search_window_show_icon_press(GtkEntry *, GtkEntryIconPosition, GdkEvent *, gpointer userdata)
341 auto hsd = static_cast<HelpSearchData *>(userdata);
343 g_free(hsd->text_entry);
344 hsd->text_entry = g_strdup("");
345 gq_gtk_entry_set_text(GTK_ENTRY(hsd->edit_widget), hsd->text_entry);
348 static void help_search_window_ok_cb(GenericDialog *, gpointer data)
350 auto hsd = static_cast<HelpSearchData *>(data);
351 gchar *search_command;
353 search_command = g_strconcat(options->help_search_engine,
354 gq_gtk_entry_get_text(GTK_ENTRY(hsd->edit_widget)),
356 help_browser_run(search_command);
357 g_free(search_command);
362 static void help_search_window_cancel_cb(GenericDialog *, gpointer data)
364 auto hsd = static_cast<HelpSearchData *>(data);
369 void help_search_window_show()
376 auto hsd = g_new0(HelpSearchData, 1);
377 hsd->gd = gd = generic_dialog_new(_("On-line help search"), "help_search",
379 help_search_window_cancel_cb, hsd);
380 generic_dialog_add_message(gd, nullptr, _("Search the on-line help files.\n"), nullptr, FALSE);
382 generic_dialog_add_button(gd, GQ_ICON_OK, "OK",
383 help_search_window_ok_cb, TRUE);
385 label1 = pref_label_new(GENERIC_DIALOG(gd)->vbox, _("Search engine:"));
386 gtk_label_set_xalign(GTK_LABEL(label1), 0.0);
387 gtk_label_set_yalign(GTK_LABEL(label1), 0.5);
389 label2 = pref_label_new(GENERIC_DIALOG(gd)->vbox, options->help_search_engine);
390 gtk_label_set_xalign(GTK_LABEL(label2), 0.0);
391 gtk_label_set_yalign(GTK_LABEL(label2), 0.5);
393 pref_spacer(GENERIC_DIALOG(gd)->vbox, 0);
395 table = pref_table_new(gd->vbox, 3, 1, FALSE, TRUE);
396 pref_table_label(table, 0, 0, _("Search terms:"), GTK_ALIGN_END);
397 hsd->edit_widget = gtk_entry_new();
398 gtk_widget_set_size_request(hsd->edit_widget, 300, -1);
399 gq_gtk_grid_attach_default(GTK_GRID(table), hsd->edit_widget, 1, 2, 0, 1);
400 generic_dialog_attach_default(gd, hsd->edit_widget);
401 gtk_widget_show(hsd->edit_widget);
403 gtk_entry_set_icon_from_icon_name(GTK_ENTRY(hsd->edit_widget),
404 GTK_ENTRY_ICON_SECONDARY, GQ_ICON_CLEAR);
405 gtk_entry_set_icon_tooltip_text (GTK_ENTRY(hsd->edit_widget),
406 GTK_ENTRY_ICON_SECONDARY, _("Clear"));
407 g_signal_connect(GTK_ENTRY(hsd->edit_widget), "icon-press",
408 G_CALLBACK(help_search_window_show_icon_press), hsd);
410 gtk_widget_grab_focus(hsd->edit_widget);
412 gtk_widget_show(gd->dialog);
414 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */