1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
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);
}
|
