source: pst/typesetting/dvisvgm.xml@ eede1a3

11.0 ken/refactor-virt lazarus qt5new trunk upgradedb
Last change on this file since eede1a3 was 6dbf705, checked in by Douglas R. Reno <renodr@…>, 7 months ago

Restructure the autoreconf and sed commands in dvisvgm so that the
changes actually take effect

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