Adding upstream version 1.2.2.upstream/1.2.2upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

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);
+}