source: gnome/applications/evince.xml@ c3f0e44

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since c3f0e44 was c3f0e44, checked in by Xi Ruoyao <xry111@…>, 4 months ago

evince: mention -Dps=enabled

  • Property mode set to 100644
File size: 9.9 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 evince-download-http
8 "&gnome-download-http;/evince/&gnome-40;/evince-&evince-version;.tar.xz">
9 <!ENTITY evince-download-ftp
10 "&gnome-download-ftp;/evince/&gnome-40;/evince-&evince-version;.tar.xz">
11 <!ENTITY evince-md5sum "7c22be5af9d4594a6356150a14b06d47">
12 <!ENTITY evince-size "2.8 MB">
13 <!ENTITY evince-buildsize "80 MB">
14 <!ENTITY evince-time "0.4 SBU (Using parallelism=4)">
15]>
16
17<sect1 id="evince" xreflabel="Evince-&evince-version;">
18 <?dbhtml filename="evince.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Evince-&evince-version;</title>
25
26 <indexterm zone="evince">
27 <primary sortas="a-Evince">Evince</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Evince</title>
32
33 <para>
34 <application>Evince</application> is a document viewer for multiple
35 document formats. It supports PDF, Postscript, DjVu, TIFF and DVI.
36 It is useful for viewing documents of various types using one simple
37 application instead of the multiple document viewers that once existed
38 on the <application>GNOME</application> Desktop.
39 </para>
40
41 &lfs101_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&evince-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&evince-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &evince-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &evince-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &evince-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &evince-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Evince Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="adwaita-icon-theme"/>,
82 <xref linkend="gsettings-desktop-schemas"/>,
83 <xref linkend="gtk3"/>,
84 <xref linkend="itstool"/>,
85 <xref linkend="libhandy1"/>,
86 <xref linkend="libxml2"/>, and
87 <xref linkend="openjpeg2"/>
88 </para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="gnome-keyring"/>,
93 <xref linkend="gobject-introspection"/>,
94 <xref linkend="libarchive"/>,
95 <xref linkend="libsecret"/>,
96 <xref linkend="nautilus"/> (to build the plugin), and
97 <xref linkend="poppler"/>
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <xref linkend="cups"/> (to enable printing if support is built into
103 <application>GTK+ 3</application>),
104 <xref linkend="gnome-desktop"/>,
105 <xref linkend="gspell"/>,
106 <xref linkend="gst10-plugins-base"/>,
107 <xref linkend="gtk-doc"/>,
108 <xref linkend="libgxps"/>,
109 <xref linkend="libtiff"/>,
110 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
111 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
112 <!--<ulink url="https://wiki.gnome.org/action/show/Projects/libgxps">libgxps</ulink>,-->
113 <ulink url="http://www.freedesktop.org/wiki/Software/libspectre/">libspectre</ulink>,
114 <ulink url="https://github.com/jlaurens/synctex">Synctex</ulink>, and
115 <ulink url="https://www.t1lib.org/">t1lib</ulink>
116 </para>
117
118 <para condition="html" role="usernotes">User Notes:
119 <ulink url="&blfs-wiki;/evince"/>
120 </para>
121 </sect2>
122
123 <sect2 role="installation">
124 <title>Installation of Evince</title>
125
126 <para>
127 First, make sure that meson can find TeXLive if it is installed.
128 This has no effect on systems without TeXLive installed.
129 </para>
130
131<screen><userinput remap="pre">export CPPFLAGS="-I/opt/texlive/&texlive-year;/include" &amp;&amp;
132export LDFLAGS="$LDFLAGS -L/opt/texlive/&texlive-year;/lib"</userinput></screen>
133
134 <para>
135 Install <application>Evince</application> by running the following
136 commands:
137 </para>
138
139<screen revision="sysv"><userinput>mkdir build &amp;&amp;
140cd build &amp;&amp;
141
142meson --prefix=/usr \
143 --buildtype=release \
144 -Dgtk_doc=false \
145 -Dsystemduserunitdir=no .. &amp;&amp;
146ninja</userinput></screen>
147
148<screen revision="systemd"><userinput>mkdir build &amp;&amp;
149cd build &amp;&amp;
150
151meson --prefix=/usr --buildtype=release -Dgtk_doc=false .. &amp;&amp;
152ninja</userinput></screen>
153
154 <para>
155 This package does not have a working testsuite.
156 </para>
157
158 <para>
159 Now, as the <systemitem class="username">root</systemitem> user:
160 </para>
161
162<screen role="root"><userinput>ninja install</userinput></screen>
163
164 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
165 href="../../xincludes/gsettings-destdir.xml"/>
166
167 </sect2>
168
169 <sect2 role="commands">
170 <title>Command Explanations</title>
171
172 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
173 href="../../xincludes/meson-buildtype-release.xml"/>
174
175 <!--
176 <para>
177 <parameter>- -enable-compile-warnings=minimum</parameter>: This
178 switch prevents a warning about a date format being treated as an error by
179 <application>gcc-6.1</application>.
180 </para>
181 -->
182
183 <para>
184 <parameter>CPPFLAGS="..." LDFLAGS="$LDFLAGS ..."</parameter>: If
185 <application>TeXLive</application> has been installed in
186 <filename class="directory">/opt/texlive-&texlive-year;</filename> the
187 configure script will find <filename class='libraryfile'>libkpathsea.so</filename>
188 and enable the DVI backend, but without this addition the compile will fail
189 because it cannot find the required headers. Adding this to a system where
190 <application>TeXLive</application> has not been installed does not break the
191 build.
192 </para>
193
194 <para>
195 <parameter>-Dgtk_doc=false</parameter>: This switch disables generating
196 the gtk-doc API reference documentation. If you have
197 <xref role="nodep" linkend="gtk-doc"/> installed and wish to generate
198 the API reference documentation, remove this switch.
199 </para>
200
201 <para>
202 <option>-Dgspell=false</option>: This switch turns off support
203 for the spell checking plugin.
204 </para>
205
206 <para>
207 <option>-Dintrospection=false</option>: Use this option if you
208 don't have <xref role="nodep" linkend="gobject-introspection"/>
209 installed and don't wish to have introspection support built into Evince.
210 </para>
211
212<!--
213 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
214 href="../../xincludes/static-libraries.xml"/>
215
216 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
217 href="../../xincludes/gtk-doc-rebuild.xml"/>
218-->
219
220 <para>
221 <option>-Dnautilus=false</option>: This switch disables building
222 the <application>Nautilus</application> Plugin. Use this switch
223 if <application>Nautilus</application> is not installed.
224 </para>
225
226 <para>
227 <option>-Dkeyring=false</option>: This switch disables the use of
228 <application>libsecret</application>. Use this switch
229 if <application>libsecret</application> is not installed.
230 </para>
231
232 <para>
233 <option>-Dps=enabled</option>: Use this switch if
234 <application>libspectre</application> is installed and you want to
235 view PostScript files with <application>Evince</application>.
236 </para>
237
238 </sect2>
239
240 <sect2 role="content">
241 <title>Contents</title>
242
243 <segmentedlist>
244 <segtitle>Installed Programs</segtitle>
245 <segtitle>Installed Libraries</segtitle>
246 <segtitle>Installed Directories</segtitle>
247
248 <seglistitem>
249 <seg>
250 evince, evince-previewer, and evince-thumbnailer
251 </seg>
252 <seg>
253 libevdocument3.so,
254 libevview3.so, and
255 /usr/lib/nautilus/extensions-3.0/libevince-properties-page.so
256 </seg>
257 <seg>
258 /usr/{include,lib,share}/evince,
259 /usr/share/gtk-doc/html/{evince,libevdocument-3.0,libevview-3.0}, and
260 /usr/share/help/*/evince
261 </seg>
262 </seglistitem>
263 </segmentedlist>
264
265 <variablelist>
266 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
267 <?dbfo list-presentation="list"?>
268 <?dbhtml list-presentation="table"?>
269
270 <varlistentry id="evince-prog">
271 <term><command>evince</command></term>
272 <listitem>
273 <para>
274 is a multiple format document viewer
275 </para>
276 <indexterm zone="evince evince-prog">
277 <primary sortas="b-evince">evince</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="evince-previewer">
283 <term><command>evince-previewer</command></term>
284 <listitem>
285 <para>
286 is an applicaton that implements the printing previewer
287 </para>
288 <indexterm zone="evince evince-previewer">
289 <primary sortas="b-evince-previewer">evince-previewer</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="evince-thumbnailer">
295 <term><command>evince-thumbnailer</command></term>
296 <listitem>
297 <para>
298 is a simple program used to create thumbnail images of
299 supported documents
300 </para>
301 <indexterm zone="evince evince-thumbnailer">
302 <primary sortas="b-evince-thumbnailer">evince-thumbnailer</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 </variablelist>
308
309 </sect2>
310
311</sect1>
Note: See TracBrowser for help on using the repository browser.