summaryrefslogtreecommitdiffstats
path: root/src/actions/actions-help-url.cpp
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/actions/actions-help-url.cpp153
1 files changed, 153 insertions, 0 deletions
diff --git a/src/actions/actions-help-url.cpp b/src/actions/actions-help-url.cpp
new file mode 100644
index 0000000..732c7cc
--- /dev/null
+++ b/src/actions/actions-help-url.cpp
@@ -0,0 +1,153 @@
+// SPDX-License-Identifier: GPL-2.0-or-later
+/** \file
+ *
+ * Actions for Help Url
+ *
+ * Authors:
+ * Sushant A A <sushant.co19@gmail.com>
+ *
+ * Copyright (C) 2021 Authors
+ *
+ * Released under GNU GPL v2+, read the file 'COPYING' for more information.
+ */
+
+#include <giomm.h>
+#include <glibmm/i18n.h>
+
+#include "actions-help-url.h"
+#include "inkscape-application.h"
+#include "inkscape-window.h"
+#include "desktop.h"
+#include "inkscape-version.h"
+
+/** Open an URL in the the default application
+ *
+ * See documentation of gtk_show_uri_on_window() for details
+ *
+ * @param url URL to be opened
+ * @param window Parent window for which the URL is opened
+ */
+// TODO: Do we really need a window reference here? It's the way recommended by gtk, though.
+void help_open_url(const Glib::ustring &url, Gtk::Window *window)
+{
+ try {
+ window->show_uri(url, GDK_CURRENT_TIME);
+ } catch (const Glib::Error &e) {
+ g_warning("Unable to show '%s': %s", url.c_str(), e.what().c_str());
+ }
+}
+
+void
+help_url_ask_question(InkscapeWindow* win, const char *lang)
+{
+ Glib::ustring url = Glib::ustring::compose("https://inkscape.org/%1/community/", lang);
+ help_open_url(url, win);
+}
+
+void
+help_url_man(InkscapeWindow* win, const char *lang, const Glib::ustring branch)
+{
+ Glib::ustring url = Glib::ustring::compose("https://inkscape.org/%1/doc/inkscape-man-%2.html", lang, branch);
+ help_open_url(url, win);
+}
+
+void
+help_url_faq(InkscapeWindow* win, const char *lang)
+{
+ Glib::ustring url = Glib::ustring::compose("https://inkscape.org/%1/learn/faq/", lang);
+ help_open_url(url, win);
+}
+
+void
+help_url_keys(InkscapeWindow* win, const char *lang, const Glib::ustring branch)
+{
+ Glib::ustring url = Glib::ustring::compose("https://inkscape.org/%1/doc/keys-%2.html", lang, branch);
+ help_open_url(url, win);
+}
+
+void
+help_url_release_notes(InkscapeWindow* win, const char *lang, const char *version, const bool development_version)
+{
+ Glib::ustring url = Glib::ustring::compose("https://inkscape.org/%1/release/inkscape-%2", lang, development_version ? "master" : version);
+ help_open_url(url, win);
+}
+
+void
+help_url_report_bug(InkscapeWindow* win, const char *lang)
+{
+ Glib::ustring url = Glib::ustring::compose("https://inkscape.org/%1/contribute/report-bugs/", lang);
+ help_open_url(url, win);
+}
+
+void
+help_url_manual(InkscapeWindow* win)
+{
+ Glib::ustring url = "http://tavmjong.free.fr/INKSCAPE/MANUAL/html/index.php";
+ help_open_url(url, win);
+}
+
+void
+help_url_donate(InkscapeWindow* win, const char *lang, const char *version)
+{
+ Glib::ustring url = Glib::ustring::compose("https://inkscape.org/%1/donate#lang=%1&version=%2", lang, version);
+ help_open_url(url, win);
+}
+
+void
+help_url_svg11_spec(InkscapeWindow* win)
+{
+ Glib::ustring url = "http://www.w3.org/TR/SVG11/";
+ help_open_url(url, win);
+}
+
+void
+help_url_svg2_spec(InkscapeWindow* win)
+{
+ Glib::ustring url = "http://www.w3.org/TR/SVG2/";
+ help_open_url(url, win);
+}
+
+std::vector<std::vector<Glib::ustring>> raw_data_help_url =
+{
+ // clang-format off
+ { "win.help-url-ask-question", N_("Ask Us a Question"), "Help Url", N_("Ask Us a Question") },
+ { "win.help-url-man", N_("Command Line Options"), "Help Url", N_("Command Line Options")},
+ { "win.help-url-faq", N_("FAQ"), "Help Url", N_("FAQ")},
+ { "win.help-url-keys", N_("Keys and Mouse Reference"), "Help Url", N_("Keys and Mouse Reference")},
+ { "win.help-url-release-notes", N_("New in This Version"), "Help Url", N_("New in This Version")},
+ { "win.help-url-report-bug", N_("Report a Bug"), "Help Url", N_("Report a Bug")},
+ { "win.help-url-manual", N_("Inkscape Manual"), "Help Url", N_("Inkscape Manual")},
+ { "win.help-url-donate", N_("Donate"), "Help Url", N_("Donate to Inkscape")},
+ { "win.help-url-svg11-spec", N_("SVG 1.1 Specification"), "Help Url", N_("SVG 1.1 Specification")},
+ { "win.help-url-svg2-spec", N_("SVG 2 Specification"), "Help Url", N_("SVG 2 Specification")}
+ // clang-format on
+};
+
+void
+add_actions_help_url(InkscapeWindow* win)
+{
+ const char *lang = _("en"); // TODO: strip /en/ for English version?
+ const char *version = Inkscape::version_string_without_revision;
+ const bool development_version = g_str_has_suffix(version, "-dev"); // this detection is not perfect but should be close enough
+ const Glib::ustring branch = development_version ? "master" : Glib::ustring::compose("%1.%2.x", Inkscape::version_major, Inkscape::version_minor);
+
+ // clang-format off
+ win->add_action( "help-url-ask-question", sigc::bind<InkscapeWindow*, const char*>(sigc::ptr_fun(&help_url_ask_question), win, lang));
+ win->add_action( "help-url-man", sigc::bind<InkscapeWindow*, const char*, const Glib::ustring>(sigc::ptr_fun(&help_url_man), win, lang,branch));
+ win->add_action( "help-url-faq", sigc::bind<InkscapeWindow*, const char*>(sigc::ptr_fun(&help_url_faq), win, lang));
+ win->add_action( "help-url-keys", sigc::bind<InkscapeWindow*, const char*, const Glib::ustring>(sigc::ptr_fun(&help_url_keys), win, lang, branch));
+ win->add_action( "help-url-release-notes", sigc::bind<InkscapeWindow*, const char*, const char*, const bool>(sigc::ptr_fun(&help_url_release_notes), win, lang, version, development_version));
+ win->add_action( "help-url-report-bug", sigc::bind<InkscapeWindow*, const char*>(sigc::ptr_fun(&help_url_report_bug), win, lang));
+ win->add_action( "help-url-manual", sigc::bind<InkscapeWindow*>(sigc::ptr_fun(&help_url_manual), win));
+ win->add_action( "help-url-donate", sigc::bind<InkscapeWindow*, const char*, const char*>(sigc::ptr_fun(&help_url_donate), win, lang, version));
+ win->add_action( "help-url-svg11-spec", sigc::bind<InkscapeWindow*>(sigc::ptr_fun(&help_url_svg11_spec), win));
+ win->add_action( "help-url-svg2-spec", sigc::bind<InkscapeWindow*>(sigc::ptr_fun(&help_url_svg2_spec), win));
+ // clang-format on
+
+ auto app = InkscapeApplication::instance();
+ if (!app) {
+ std::cerr << "add_actions_help_url: no app!" << std::endl;
+ return;
+ }
+ app->get_action_extra_data().add_data(raw_data_help_url);
+}