// SPDX-License-Identifier: GPL-2.0-or-later /** \file * * Actions for Help Url * * Authors: * Sushant A A * * Copyright (C) 2021 Authors * * Released under GNU GPL v2+, read the file 'COPYING' for more information. */ #include #include #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> 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(sigc::ptr_fun(&help_url_ask_question), win, lang)); win->add_action( "help-url-man", sigc::bind(sigc::ptr_fun(&help_url_man), win, lang,branch)); win->add_action( "help-url-faq", sigc::bind(sigc::ptr_fun(&help_url_faq), win, lang)); win->add_action( "help-url-keys", sigc::bind(sigc::ptr_fun(&help_url_keys), win, lang, branch)); win->add_action( "help-url-release-notes", sigc::bind(sigc::ptr_fun(&help_url_release_notes), win, lang, version, development_version)); win->add_action( "help-url-report-bug", sigc::bind(sigc::ptr_fun(&help_url_report_bug), win, lang)); win->add_action( "help-url-manual", sigc::bind(sigc::ptr_fun(&help_url_manual), win)); win->add_action( "help-url-donate", sigc::bind(sigc::ptr_fun(&help_url_donate), win, lang, version)); win->add_action( "help-url-svg11-spec", sigc::bind(sigc::ptr_fun(&help_url_svg11_spec), win)); win->add_action( "help-url-svg2-spec", sigc::bind(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); }