glfs/pst/typesetting/dvisvgm.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY dvisvgm-download-http "https://github.com/mgieseki/dvisvgm/releases/download/&dvisvgm-version;/dvisvgm-&dvisvgm-version;.tar.gz">
  <!ENTITY dvisvgm-download-ftp  " ">
  <!ENTITY dvisvgm-md5sum        "2eb037bd599c7f9af9fc3d176de97b86">
  <!ENTITY dvisvgm-size          "3.0 MB">
  <!ENTITY dvisvgm-buildsize     "334 MB (49 MB installed, add 959 MB for the tests)">
  <!ENTITY dvisvgm-time          "0.8 SBU (add 0.6 SBU for the tests, both using parallelism=4)">
]>

<sect1 id="dvisvgm" xreflabel="dvisvgm-&dvisvgm-version;">
  <?dbhtml filename="dvisvgm.html"?>

  <sect1info>
    <date>$Date$</date>
  </sect1info>

  <title>dvisvgm-&dvisvgm-version;</title>

  <indexterm zone="dvisvgm">
    <primary sortas="a-dvisvgm">dvisvgm</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to dvisvgm</title>

    <para>
      The <application>dvisvgm</application> package converts DVI, EPS and
      PDF files to SVG format.
    </para>

    &lfs101_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&dvisvgm-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&dvisvgm-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &dvisvgm-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &dvisvgm-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &dvisvgm-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &dvisvgm-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">dvisvgm Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <!-- EDITORS: the docs say it needs clipper, but it uses an internal
       modified version and cannot be built with system clipper -->
      <xref linkend="brotli"/>,
      <xref linkend="gs"/> and
      <xref linkend="potrace"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="woff2"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="asciidoc"/> with
      <xref linkend="xmlto"/> and
      <xref linkend="libxslt"/> (see command explanations),
      <ulink url="http://dblatex.sourceforge.net/">dblatex</ulink> (with the above) and
      <!-- version checked for dvisvgm-2.9, 0.7.3 is mentioned in the
           news and is the latest version at 2020-03-21
           maybe change to 'a recent version' if that releases faster -->
      <ulink url="https://github.com/Cyan4973/xxHash/releases/latest">xxHash</ulink>
      (the current version is included in the tarball)
    </para>

    <para condition="html" role="usernotes">
      User Notes: <ulink url="&blfs-wiki;/dvisvgm"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of dvisvgm</title>

<!-- Editors: This is in the book for svg output from asymptote. tested in
 http://www.linuxfromscratch.org/~ken/asy-nontex-testfiles/asy-test-20200123.tar.xz
-->
    <para>
      To enable the build system to link to
      <filename class="libraryfile">libkpathsea.so</filename>, as the
      <systemitem class="username">root</systemitem> user create a symlink from
      <filename class="directory">/usr/lib</filename>:
    </para>

<screen role="root"><userinput>ln -svf /opt/texlive/&texlive-year;/lib/libkpathsea.so /usr/lib</userinput></screen>

<!--<para>
      The testsuite assumes that a modern version of <application>Python</application>
      has been installed as plain <command>python</command>. Adjust it to use
      <command>python3</command> with the following sed:
    </para>

<screen><userinput>sed -i 's/python/&amp;3/' tests/Makefile.in</userinput></screen>

-->
    <para>
      The testsuite assumes that a modern version of <application>Python</application>
      has been installed as plain <command>python</command>. Changing this to use
      <command>python3</command> requires a sed to one of <filename>Makefile.in</filename>
      files, but that gets regenerated when <command>autoreconf</command> is run, so
      the sed must come after that.
    </para>

    <para>
<!--  Now install <application>dvisvgm</application> by running the following-->
      Install <application>dvisvgm</application> by running the following
      commands:
    </para>

<screen><userinput>sed -i 's/python/&amp;3/' tests/Makefile.in       &amp;&amp;
autoreconf -fiv                               &amp;&amp;
./configure                                    \
 --bindir=/opt/texlive/&texlive-year;/bin/${TEXARCH}     \
 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
 --with-kpathsea=/opt/texlive/&texlive-year;            &amp;&amp;
make</userinput></screen>

    <para>
      To test the results, issue: <command>make check</command>.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <command>ln -svf /opt/texlive/&texlive-year;/lib/libkpathsea.so /usr/lib</command>:
      Without this, the program will not link correctly,
    </para>

    <para>
      <command>autoreconf -fiv</command>: The versions of
      <application>autoconf</application> and <application>automake</application>
      used when this package was created are older than the current versions in
      LFS. That causes 'make' to fail when it reaches the 'tests' subdirectory
      unless autoreconf is forced to install missing (i.e. newer) auxiliary
      files.
    </para>

    <!-- EDITORS: the doc target to rebuild the manpage (make man) is not
      recognised unless invoked from the doc directory (unlike make pdf which
      can be invoked from top-level but needs dblatex), and I see no utility
      in explaining how to regenerate it. ken -->
    <para>
      <command>--with-kpathsea=/opt/texlive/&texlive-year;</command>: This allows
      the build system to find the headers for <filename
      class="libraryfile">kpathsea</filename>
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          dvisvgm
        </seg>
        <seg>
          None
        </seg>
        <seg>
          None
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="dvisvgm-prog">
        <term><command>dvisvgm</command></term>
        <listitem>
          <para>
            converts DVI, EPS and PDF files to the SVG format
          </para>
          <indexterm zone="dvisvgm dvisvgm-prog">
            <primary sortas="b-dvisvgm">dvisvgm</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>
  </sect2>

</sect1>