source: xsoft/other/inkscape.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 10.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6 <!ENTITY inkscape-download-http "https://media.inkscape.org/dl/resources/file/inkscape-&inkscape-version;.tar.xz">
7 <!ENTITY inkscape-download-ftp " ">
8 <!ENTITY inkscape-md5sum "ec90e0c1e4c7e3dba8f46b16c73462b3">
9 <!ENTITY inkscape-size "31 MB">
10 <!ENTITY inkscape-buildsize "723 MB (166 MB installed)">
11 <!ENTITY inkscape-time "5.7 SBU (with parallelism=4)">
12]>
13
14<sect1 id="inkscape" xreflabel="Inkscape-&inkscape-version;">
15 <?dbhtml filename="inkscape.html"?>
16
17 <sect1info>
18 <date>$Date$</date>
19 </sect1info>
20
21 <title>Inkscape-&inkscape-version;</title>
22
23 <indexterm zone="inkscape">
24 <primary sortas="a-Inkscape">Inkscape</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to Inkscape</title>
29
30 <para>
31 <application>Inkscape</application> is a what you see is what you get
32 Scalable Vector Graphics editor. It is useful for creating, viewing and
33 changing SVG images.
34 </para>
35
36 &lfs101_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&inkscape-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&inkscape-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &inkscape-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &inkscape-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &inkscape-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &inkscape-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>
76 Required patch: <ulink
77 url="&patch-root;/inkscape-&inkscape-version;-glib_2.68-1.patch"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81 <!-- These are not needed right now. Inkscape builds/runs fine with the
82 latest poppler as of this update (0.87.0). However, history says
83 that almost every poppler version has broke inkscape, and history
84 tends to repeat itself ;-). Keep these patches commented until
85 they are inevitably needed.
86 <listitem>
87 <para>
88 Required patch: <ulink
89 url="&patch-root;/inkscape-&inkscape-version;-upstream_fixes-1.patch"/>
90 </para>
91 </listitem>
92 <listitem>
93 <para>
94 Required patch: <ulink
95 url="&patch-root;/inkscape-&inkscape-version;-poppler_0_83_0_fixes-1.patch"/>
96 </para>
97 </listitem>
98 </itemizedlist>
99 -->
100
101 <!-- I've asked upstream about this and was unable to find an answer. -renodr -->
102 <note>
103 <para>
104 The tarball <emphasis>inkscape-&inkscape-version;.tar.xz</emphasis>
105 will extract to
106 <emphasis>inkscape-&inkscape-version;_2021-01-15_e86c870879</emphasis>.
107 </para>
108 </note>
109
110 <bridgehead renderas="sect3">Inkscape Dependencies</bridgehead>
111
112 <bridgehead renderas="sect4">Required</bridgehead>
113 <para role="required">
114 <xref linkend="boost"/>,
115 <xref linkend="double-conversion"/>,
116 <xref linkend="gc"/>,
117 <xref linkend="gdl"/>,
118 <xref linkend="gsl"/>,
119 <xref linkend="gtkmm3"/>,
120 <xref linkend="libsoup"/>,
121 <xref linkend="libxslt"/>,
122 <xref linkend="poppler"/>,
123 <xref linkend="popt"/> and
124 <xref linkend="wget"/> (to download the test dependencies)
125 </para>
126
127 <bridgehead renderas="sect4">Recommended</bridgehead>
128 <para role="recommended">
129 <xref linkend="imagemagick"/>,
130 <xref linkend="lcms2"/> or
131 <xref role="nodep" linkend="lcms"/>,
132 <xref linkend="libcanberra"/> (to eliminate plugin warnings),
133 <xref linkend="potrace"/> (for the bucket-fill tool),
134 <xref role="runtime" linkend="lxml"/> and
135 <xref role="runtime" linkend="scour"/> (both at runtime, for Save As
136 Optimized SVG).
137 </para>
138
139 <bridgehead renderas="sect4">Optional</bridgehead>
140 <para role="optional">
141 <xref linkend="aspell"/>,
142 <xref linkend="dbus"/> (to run inkscape from scripts),
143 <xref linkend="doxygen"/>,
144
145 <!-- these document foundation links work from firefox's address bar, or
146 from google (pages telling you how to get it from git), but when I link
147 them here I get "There is currently no text in this page...". Ken or
148 developer: wiki.documentfoundation.org pages don't like trailing / -->
149 <!--<ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libcdr">libcdr</ulink>,
150 <ulink url="https://wiki.documentfoundation.org/DLP/Libraries/libvisio">libvisio</ulink>,-->
151 <ulink url="http://gtkspell.sourceforge.net">gtkspell</ulink>,
152 <ulink url="https://github.com/LibreOffice/libcdr">libcdr</ulink>,
153 <ulink url="https://github.com/LibreOffice/libvisio">libvisio</ulink>,
154 <ulink url="http://libwpg.sourceforge.net/">libwpg</ulink> (or
155 <ulink url="http://libwpd.sourceforge.net/">libwpd</ulink>) and
156 <ulink role="runtime"
157 url="https://sourceforge.net/projects/NumPy/files/">NumPy</ulink>
158 (at runtime for some extensions)
159 </para>
160
161 <bridgehead renderas="sect4">Optional Runtime Dependencies
162 (for some of the Inkscape extensions)</bridgehead>
163 <para role="optional">
164 <ulink role="runtime"
165 url="https://metacpan.org/pod/release/TJMATHER/XML-XQL-0.68/lib/XML/XQL.pm">XML::XQL</ulink>
166 </para>
167
168 <para condition="html" role="usernotes">
169 User Notes: <ulink url="&blfs-wiki;/inkscape"/>
170 </para>
171 </sect2>
172
173 <sect2 role="installation">
174 <title>Installation of Inkscape</title>
175
176 <!-- Not needed with 1.0, but let's keep the template.
177
178 <para>
179 Now fix Inkscape to build with poppler-0.83.0:
180 </para>
181
182<screen><userinput remap="pre">patch -Np1 -i ../inkscape-&inkscape-version;-poppler_0_83_0_fixes-1.patch</userinput></screen>
183 -->
184
185<!-- If there is no test suite, then this is not needed.
186 There is none if the command below is not run.
187 With 1.0, this support is broken, so let's comment it out for now to
188 prevent confusion.
189 <para>
190 If you wish to run the testsuite, download the required versions of
191 <application>googletest</application> and
192 <application>googlemock</application> by running:
193 </para>
194
195<screen remap="test"><userinput>bash download-gtest.sh</userinput></screen>
196 -->
197
198<!--
199 <para>
200 First, fix build failure with glibc-2.32:
201 </para>
202
203<screen><userinput remap="pre">sed -i '/#include &lt;iostream&gt;/a #include &lt;atomic&gt;' src/ui/tool/node.cpp</userinput></screen>
204-->
205
206 <para>
207 Install <application>Inkscape</application> by running the following
208 commands:
209 </para>
210<screen><userinput remap="pre">patch -Np1 -i ../inkscape-&inkscape-version;-glib_2.68-1.patch &amp;&amp;
211mkdir build &amp;&amp;
212cd build &amp;&amp;
213
214cmake -DCMAKE_INSTALL_PREFIX=/usr \
215 -DCMAKE_BUILD_TYPE=Release \
216 .. &amp;&amp;
217make</userinput></screen>
218
219<!--
220 <para>
221 To test the results, issue: <command>make check</command>.<!- - Ken or
222 other devs, there is no test suite in this package. -renodr
223 A small test suite is built if you download the necessary programs
224 with the command above (bash download-gtest.sh) -pierre
225 This package does not come with a test suite. - ->
226
227 At the moment, the test suite does not function with the
228 "bash download-gtest.sh". CMake is unable to find gtest.
229 </para>
230-->
231
232 <para>
233 This package does not come with a working test suite.
234 </para>
235
236 <para>
237 Now, as the <systemitem class="username">root</systemitem> user:
238 </para>
239
240<screen role="root"><userinput>make install</userinput></screen>
241
242 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
243 href="../../xincludes/update-icons-and-desktop.xml"/>
244
245 </sect2>
246
247 <sect2 role="commands">
248 <title>Command Explanations</title>
249
250 <para>
251 <parameter>-DCMAKE_BUILD_TYPE=Release</parameter>: This switch is used to
252 build the release library without any debug `assert` in the code.
253 </para>
254
255 <para>
256 <option>-DWITH_DBUS=ON</option>: use this if you wish to use
257 <command>inkscape</command> in interactive scripts which manipulate
258 images.
259 </para>
260
261 </sect2>
262
263 <sect2 role="content">
264 <title>Contents</title>
265
266 <segmentedlist>
267 <segtitle>Installed Programs</segtitle>
268 <segtitle>Installed Library</segtitle>
269 <segtitle>Installed Directories</segtitle>
270
271 <seglistitem>
272 <seg>
273 inkscape and inkview
274 </seg>
275 <seg>
276 libinkscape_base.so
277 </seg>
278 <seg>
279 /usr/lib/inkscape and /usr/share/inkscape
280 </seg>
281 </seglistitem>
282 </segmentedlist>
283
284 <variablelist>
285 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
286 <?dbfo list-presentation="list"?>
287 <?dbhtml list-presentation="table"?>
288
289 <varlistentry id="inkscape-prog">
290 <term><command>inkscape</command></term>
291 <listitem>
292 <para>
293 is a SVG (Scalable Vector Graphics) editing program
294 </para>
295 <indexterm zone="inkscape inkscape-prog">
296 <primary sortas="b-inkscape">inkscape</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="inkview">
302 <term><command>inkview</command></term>
303 <listitem>
304 <para>
305 is a simple program for displaying SVG files
306 </para>
307 <indexterm zone="inkscape inkview">
308 <primary sortas="b-inkview">inkview</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="libinkscape_base">
314 <term><filename class="libraryfile">libinkscape_base.so</filename></term>
315 <listitem>
316 <para>
317 provides the routines used by inkscape and inkview
318 </para>
319 <indexterm zone="inkscape libinkscape_base">
320 <primary sortas="c-libinkscape_base">libinkscape_base.so</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 </variablelist>
326
327 </sect2>
328
329</sect1>
Note: See TracBrowser for help on using the repository browser.