glfs/gnome/applications/evince.xml
Xi Ruoyao c0bc0a9eac
Update to glib-2.80.0 and gobject-introspection-1.80.0
Merge gobject-introspection into glib page to better handle a circular
dependency between these two packages.
2024-03-10 23:41:04 +08:00

292 lines
9.0 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!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 evince-download-http
"&gnome-download-http;/evince/&gnome-45;/evince-&evince-version;.tar.xz">
<!ENTITY evince-download-ftp " ">
<!ENTITY evince-md5sum "494cdeef8898a2479aa86f8def7a63bc">
<!ENTITY evince-size "2.8 MB">
<!ENTITY evince-buildsize "45 MB">
<!ENTITY evince-time "0.2 SBU (Using parallelism=4)">
]>
<sect1 id="evince" xreflabel="Evince-&evince-version;">
<?dbhtml filename="evince.html"?>
<title>Evince-&evince-version;</title>
<indexterm zone="evince">
<primary sortas="a-Evince">Evince</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Evince</title>
<para>
<application>Evince</application> is a document viewer for multiple
document formats. It supports PDF, Postscript, DjVu, TIFF and DVI.
It is useful for viewing documents of various types using one simple
application instead of the multiple document viewers that once existed
on the <application>GNOME</application> Desktop.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&evince-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&evince-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &evince-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &evince-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &evince-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &evince-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Evince Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="adwaita-icon-theme"/>,
<xref linkend="gsettings-desktop-schemas"/>,
<xref linkend="gtk3"/>,
<xref linkend="itstool"/>,
<xref linkend="libhandy1"/>,
<xref linkend="libxml2"/>, and
<xref linkend="openjpeg2"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="gnome-keyring"/>,
&gobject-introspection;,
<xref linkend="libarchive"/>,
<xref linkend="libsecret"/>, and
<xref linkend="poppler"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="cups"/> (to enable printing if support is built into
<application>GTK+ 3</application>),
<xref linkend="gnome-desktop"/>,
<xref linkend="gspell"/>,
<xref linkend="gst10-plugins-base"/>,
<xref linkend="gi-docgen"/>,
<xref linkend="libgxps"/>,
<xref linkend="libtiff"/>,
<xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
<ulink url="https://djvu.sourceforge.net/">DjVuLibre</ulink>,
<ulink url="https://www.freedesktop.org/wiki/Software/libspectre/">libspectre</ulink>, and
<ulink url="https://github.com/jlaurens/synctex">Synctex</ulink>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of Evince</title>
<para>
Install <application>Evince</application> by running the following
commands:
</para>
<screen revision="sysv"><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
CPPFLAGS+=" -I/opt/texlive/&texlive-year;/include" \
meson setup --prefix=/usr \
--buildtype=release \
-Dgtk_doc=false \
--wrap-mode=nodownload \
-Dsystemduserunitdir=no .. &amp;&amp;
ninja</userinput></screen>
<screen revision="systemd"><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
CPPFLAGS+=" -I/opt/texlive/&texlive-year;/include" \
meson setup --prefix=/usr \
--buildtype=release \
-Dgtk_doc=false \
--wrap-mode=nodownload \
.. &amp;&amp;
ninja</userinput></screen>
<para>
If you have <xref linkend='gi-docgen'/> installed and wish to build
the API documentation for this package, issue:
</para>
<screen role='nodump'><userinput>sed "/docs_dir/s@\$@ / 'evince-&evince-version;'@" -i ../help/meson.build &amp;&amp;
meson configure -Dgtk_doc=true &amp;&amp;
ninja</userinput></screen>
<para>
This package does not have a working test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gsettings-destdir.xml"/>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/meson-buildtype-release.xml"/>
<para>
<parameter>CPPFLAGS+=" -I/opt/texlive/&texlive-year;/include"</parameter>:
Make sure that meson can find libkpathsea headers from TeXLive if it
is installed. This has no effect on systems without TeXLive installed.
</para>
<para>
<parameter>--wrap-mode=nodownload</parameter>: This switch disables
fetching any dependency: the build system tries to fetch gi-docgen
even if <parameter>-Dgtk_doc=false</parameter> is passed.
</para>
<para>
<parameter>-Dgtk_doc=false</parameter>: &gi-doc-disable;
</para>
<para>
<option>-Dgspell=false</option>: This switch turns off support
for the spell checking plugin.
</para>
<para>
<option>-Dintrospection=false</option>: Use this option if you
don't have built <xref linkend='glib2'/> with GObject Introspection
and don't wish to have introspection support built into Evince.
</para>
<para>
<option>-Dnautilus=false</option>: This switch disables building
the <application>Nautilus</application> Plugin. Use this switch
if <application>Nautilus</application> is not installed.
</para>
<para>
<option>-Dkeyring=false</option>: This switch disables the use of
<application>libsecret</application>. Use this switch
if <application>libsecret</application> is not installed.
</para>
<para>
<option>-Dps=enabled</option>: Use this switch if
<application>libspectre</application> is installed and you want to
view PostScript files with <application>Evince</application>.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
evince, evince-previewer, and evince-thumbnailer
</seg>
<seg>
libevdocument3.so and
libevview3.so
</seg>
<seg>
/usr/{include,lib,share}/evince,
/usr/share/gtk-doc/html/{evince,libevdocument-3.0,libevview-3.0}
(optional), and
/usr/share/help/*/evince
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="evince-prog">
<term><command>evince</command></term>
<listitem>
<para>
is a multiple format document viewer
</para>
<indexterm zone="evince evince-prog">
<primary sortas="b-evince">evince</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="evince-previewer">
<term><command>evince-previewer</command></term>
<listitem>
<para>
is an application that implements the printing previewer
</para>
<indexterm zone="evince evince-previewer">
<primary sortas="b-evince-previewer">evince-previewer</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="evince-thumbnailer">
<term><command>evince-thumbnailer</command></term>
<listitem>
<para>
is a simple program used to create thumbnail images of
supported documents
</para>
<indexterm zone="evince evince-thumbnailer">
<primary sortas="b-evince-thumbnailer">evince-thumbnailer</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>