glfs/general/graphlib/librsvg.xml
Bruce Dubbs 3470d743f2 Speling
2022-04-11 20:26:55 -05:00

239 lines
7.2 KiB
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 librsvg-download-http "&gnome-download-http;/librsvg/&librsvg-minor;/librsvg-&librsvg-version;.tar.xz">
<!ENTITY librsvg-download-ftp "&gnome-download-ftp;/librsvg/&librsvg-minor;/librsvg-&librsvg-version;.tar.xz">
<!ENTITY librsvg-md5sum "22328b7922ab04836959f669ecef1ea7">
<!ENTITY librsvg-size "23 MB">
<!ENTITY librsvg-buildsize "920 MB (28 MB installed), add 213 MB for tests">
<!ENTITY librsvg-time "1.2 SBU (Using parallelism=4), add 1.7 SBU for tests">
]>
<sect1 id="librsvg" xreflabel="librsvg-&librsvg-version;">
<?dbhtml filename="librsvg.html"?>
<sect1info>
<date>$Date$</date>
</sect1info>
<title>librsvg-&librsvg-version;</title>
<indexterm zone="librsvg">
<primary sortas="a-librsvg">librsvg</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to librsvg</title>
<para>
The <application>librsvg</application> package contains
a library and tools used to manipulate, convert and view
Scalable Vector Graphic (SVG) images.
</para>
&lfs111_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&librsvg-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&librsvg-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &librsvg-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &librsvg-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &librsvg-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &librsvg-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">librsvg Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="cairo"/>,
<xref linkend="docutils"/>,
<xref linkend="gdk-pixbuf"/>,
<xref linkend="pango"/>, and
<xref linkend="rust"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="gobject-introspection"/> and
<xref linkend="vala"/>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/librsvg"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of librsvg</title>
<para>
This package needs <command>gi-docgen</command> to be built. Set up
a Python virtual environment to run it:
</para>
<screen><userinput remap="pre">python3 -m venv pyvenv &amp;&amp;
./pyvenv/bin/pip3 install gi-docgen</userinput></screen>
<para>
Install <application>librsvg</application> by running the following
commands:
</para>
<screen><userinput>GI_DOCGEN=$PWD/pyvenv/bin/gi-docgen \
./configure --prefix=/usr \
--enable-vala \
--disable-static \
--docdir=/usr/share/doc/librsvg-&librsvg-version; &amp;&amp;
make</userinput></screen>
<para>
To test the results, issue: <command>make -k check</command>. During
testing some binaries are rebuilt with a different debug level, so you
should run <command>make</command> again after the tests are complete
to ensure everything is ready to be installed.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<note>
<para>
If you installed the package on to your system using a
<quote>DESTDIR</quote> method, an important file was not installed and
should be copied and/or generated. Generate it using the following
command as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>gdk-pixbuf-query-loaders --update-cache</userinput></screen>
</note>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<parameter>--enable-vala</parameter>: This switch enables
building of the Vala bindings. Remove this switch if you don't have
<xref linkend="vala"/> installed.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/static-libraries.xml"/>
<para>
<option>--disable-introspection</option>: Use this switch if you have
not installed <application>Gobject Introspection</application>.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
rsvg-convert
</seg>
<seg>
librsvg-2.so and libpixbufloader-svg.so
(in <filename class='directory'>/usr/lib/gdk-pixbuf-2.0/2.10.0/</filename>)
</seg>
<seg>
/usr/include/librsvg-2.0,
/usr/share/doc/librsvg-&librsvg-version;, and
/usr/share/gtk-doc/html/rsvg-2.0
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="rsvg-convert">
<term><command>rsvg-convert</command></term>
<listitem>
<para>
is used to convert images into PNG, PDF, PS, SVG and other formats
</para>
<indexterm zone="librsvg rsvg-convert">
<primary sortas="b-rsvg-convert">rsvg-convert</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="librsvg-2">
<term><filename class="libraryfile">librsvg-2.so</filename></term>
<listitem>
<para>
provides the functions to render Scalable Vector Graphics
</para>
<indexterm zone="librsvg librsvg-2">
<primary sortas="c-librsvg-2">librsvg-2.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libpixbufloader-svg">
<term><filename class="libraryfile">libpixbufloader-svg.so</filename></term>
<listitem>
<para>
is the <application>Gdk Pixbuf</application> plugin that allows
<application>GTK+</application> applications to render Scalable
Vector Graphics images
</para>
<indexterm zone="librsvg libpixbufloader-svg">
<primary sortas="c-libpixbufloader-svg">libpixbufloader-svg.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>