source: pst/typesetting/dvisvgm.xml@ 4c24eb0

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 4c24eb0 was 4c24eb0, checked in by Pierre Labastie <pieere@…>, 8 months ago

Remove period at the end of short descriptions.
In the process, some attributes in single quotes have been changed to double
quotes, and a few attribute lists have been written on one line instead of
several lines.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24236 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.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
7 <!ENTITY dvisvgm-download-http "https://github.com/mgieseki/dvisvgm/releases/download/&dvisvgm-version;/dvisvgm-&dvisvgm-version;.tar.gz">
8 <!ENTITY dvisvgm-download-ftp " ">
9 <!ENTITY dvisvgm-md5sum "2eb037bd599c7f9af9fc3d176de97b86">
10 <!ENTITY dvisvgm-size "3.0 MB">
11 <!ENTITY dvisvgm-buildsize "334 MB (49 MB installed, add 959 MB for the tests)">
12 <!ENTITY dvisvgm-time "0.8 SBU (add 0.6 SBU for the tests, both using parallelism=4)">
13]>
14
15<sect1 id="dvisvgm" xreflabel="dvisvgm-&dvisvgm-version;">
16 <?dbhtml filename="dvisvgm.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>dvisvgm-&dvisvgm-version;</title>
24
25 <indexterm zone="dvisvgm">
26 <primary sortas="a-dvisvgm">dvisvgm</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to dvisvgm</title>
31
32 <para>
33 The <application>dvisvgm</application> package converts DVI, EPS and
34 PDF files to SVG format.
35 </para>
36
37 &lfs10_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&dvisvgm-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&dvisvgm-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &dvisvgm-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &dvisvgm-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &dvisvgm-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &dvisvgm-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">dvisvgm Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <!-- EDITORS: the docs say it needs clipper, but it uses an internal
78 modified version and cannot be built with system clipper -->
79 <xref linkend="brotli"/>,
80 <xref linkend="gs"/> and
81 <xref linkend="potrace"/>
82 </para>
83
84 <bridgehead renderas="sect4">Recommended</bridgehead>
85 <para role="recommended">
86 <xref linkend="woff2"/>
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <xref linkend="asciidoc"/> with
92 <xref linkend="xmlto"/> and
93 <xref linkend="libxslt"/> (see command explanations),
94 <ulink url="http://dblatex.sourceforge.net/">dblatex</ulink> (with the above) and
95 <!-- version checked for dvisvgm-2.9, 0.7.3 is mentioned in the
96 news and is the latest version at 2020-03-21
97 maybe change to 'a recent version' if that releases faster -->
98 <ulink url="https://github.com/Cyan4973/xxHash/releases/latest">xxHash</ulink>
99 (the current version is included in the tarball)
100 </para>
101
102 <para condition="html" role="usernotes">
103 User Notes: <ulink url="&blfs-wiki;/dvisvgm"/>
104 </para>
105 </sect2>
106
107 <sect2 role="installation">
108 <title>Installation of dvisvgm</title>
109
110<!-- Editors: This is in the book for svg output from asymptote. tested in
111 http://www.linuxfromscratch.org/~ken/asy-nontex-testfiles/asy-test-20200123.tar.xz
112-->
113 <para>
114 To enable the build system to link to
115 <filename class="libraryfile">libkpathsea.so</filename>, as the
116 <systemitem class="username">root</systemitem> user create a symlink from
117 <filename class="directory">/usr/lib</filename>:
118 </para>
119
120<screen role="root"><userinput>ln -svf /opt/texlive/&texlive-year;/lib/libkpathsea.so /usr/lib</userinput></screen>
121
122<!--<para>
123 The testsuite assumes that a modern version of <application>Python</application>
124 has been installed as plain <command>python</command>. Adjust it to use
125 <command>python3</command> with the following sed:
126 </para>
127
128<screen><userinput>sed -i 's/python/&amp;3/' tests/Makefile.in</userinput></screen>
129
130-->
131 <para>
132 The testsuite assumes that a modern version of <application>Python</application>
133 has been installed as plain <command>python</command>. Changing this to use
134 <command>python3</command> requires a sed to one of <filename>Makefile.in</filename>
135 files, but that gets regenerated when <command>autoreconf</command> is run, so
136 the sed must come after that.
137 </para>
138
139 <para>
140<!-- Now install <application>dvisvgm</application> by running the following-->
141 Install <application>dvisvgm</application> by running the following
142 commands:
143 </para>
144
145<screen><userinput>sed -i 's/python/&amp;3/' tests/Makefile.in &amp;&amp;
146autoreconf -fiv &amp;&amp;
147./configure \
148 --bindir=/opt/texlive/&texlive-year;/bin/${TEXARCH} \
149 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
150 --with-kpathsea=/opt/texlive/&texlive-year; &amp;&amp;
151make</userinput></screen>
152
153 <para>
154 To test the results, issue: <command>make check</command>.
155 </para>
156
157 <para>
158 Now, as the <systemitem class="username">root</systemitem> user:
159 </para>
160
161<screen role="root"><userinput>make install</userinput></screen>
162
163 </sect2>
164
165 <sect2 role="commands">
166 <title>Command Explanations</title>
167
168 <para>
169 <command>ln -svf /opt/texlive/&texlive-year;/lib/libkpathsea.so /usr/lib</command>:
170 Without this, the program will not link correctly,
171 </para>
172
173 <para>
174 <command>autoreconf -fiv</command>: The versions of
175 <application>autoconf</application> and <application>automake</application>
176 used when this package was created are older than the current versions in
177 LFS. That causes 'make' to fail when it reaches the 'tests' subdirectory
178 unless autoreconf is forced to install missing (i.e. newer) auxiliary
179 files.
180 </para>
181
182 <!-- EDITORS: the doc target to rebuild the manpage (make man) is not
183 recognised unless invoked from the doc directory (unlike make pdf which
184 can be invoked from top-level but needs dblatex), and I see no utility
185 in explaining how to regenerate it. ken -->
186 <para>
187 <command>--with-kpathsea=/opt/texlive/&texlive-year;</command>: This allows
188 the build system to find the headers for <filename
189 class="libraryfile">kpathsea</filename>
190 </para>
191
192 </sect2>
193
194 <sect2 role="content">
195 <title>Contents</title>
196
197 <segmentedlist>
198 <segtitle>Installed Programs</segtitle>
199 <segtitle>Installed Libraries</segtitle>
200 <segtitle>Installed Directories</segtitle>
201
202 <seglistitem>
203 <seg>
204 dvisvgm
205 </seg>
206 <seg>
207 None
208 </seg>
209 <seg>
210 None
211 </seg>
212 </seglistitem>
213 </segmentedlist>
214
215 <variablelist>
216 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
217 <?dbfo list-presentation="list"?>
218 <?dbhtml list-presentation="table"?>
219
220 <varlistentry id="dvisvgm-prog">
221 <term><command>dvisvgm</command></term>
222 <listitem>
223 <para>
224 converts DVI, EPS and PDF files to the SVG format
225 </para>
226 <indexterm zone="dvisvgm dvisvgm-prog">
227 <primary sortas="b-dvisvgm">dvisvgm</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 </variablelist>
233 </sect2>
234
235</sect1>
Note: See TracBrowser for help on using the repository browser.