diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 18:24:48 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 18:24:48 +0000 |
commit | cca66b9ec4e494c1d919bff0f71a820d8afab1fa (patch) | |
tree | 146f39ded1c938019e1ed42d30923c2ac9e86789 /src/actions/actions-help-url.cpp | |
parent | Initial commit. (diff) | |
download | inkscape-cca66b9ec4e494c1d919bff0f71a820d8afab1fa.tar.xz inkscape-cca66b9ec4e494c1d919bff0f71a820d8afab1fa.zip |
Adding upstream version 1.2.2.upstream/1.2.2upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | src/actions/actions-help-url.cpp | 153 |
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); +} |