source: pst/ps/mupdf.xml

trunk
Last change on this file was 12b6e53, checked in by Xi Ruoyao <xry111@…>, 11 days ago

mupdf: fix a typo producing bad hyperlink

  • Property mode set to 100644
File size: 8.5 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<!--Using archive URL, because when a new version is released, older and new
8can be found there, no need to change directory -->
9 <!ENTITY mupdf-download-http "https://www.mupdf.com/downloads/archive/mupdf-&mupdf-version;-source.tar.gz">
10 <!ENTITY mupdf-download-ftp " ">
11 <!ENTITY mupdf-md5sum "5b27f800ea926996f428505b93fdd1e0">
12 <!ENTITY mupdf-size "87 MB">
13 <!ENTITY mupdf-buildsize "387 MB">
14 <!ENTITY mupdf-time "0.2 SBU (Using parallelism=4)">
15]>
16
17<sect1 id="mupdf" xreflabel="mupdf-&mupdf-version;">
18 <?dbhtml filename="mupdf.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>MuPDF-&mupdf-version;</title>
25
26 <indexterm zone="mupdf">
27 <primary sortas="a-mupdf">mupdf</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to MuPDF</title>
32
33 <para>
34 <application>MuPDF</application> is a lightweight PDF and XPS viewer.
35 </para>
36
37 &lfs110a_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&mupdf-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&mupdf-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &mupdf-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &mupdf-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &mupdf-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &mupdf-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73<!--
74 <bridgehead renderas="sect3">Required Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Required patch: <ulink
79 url="&patch-root;/mupdf-&mupdf-version;-security_fix-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83-->
84
85 <bridgehead renderas="sect3">MuPDF Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89 <xref linkend="glu"/> and <!-- previously recommended via system freeglut -->
90 <xref linkend="xorg7-lib"/>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <!--<xref linkend="freeglut"/>, use of the bundled glut is preferred -->
96 <xref linkend="harfbuzz"/>,
97 <!-- This no-longer gets linked in with our system libs patch
98 <xref linkend="lcms2"/>, -->
99 <xref linkend="libjpeg"/>,
100 <xref linkend="openjpeg2"/>, and
101 <xref linkend="curl"/>
102 </para>
103
104 <bridgehead renderas="sect4">Optional</bridgehead>
105 <para role="optional">
106 <xref role="runtime" linkend="xdg-utils"/> (runtime),
107 <ulink url="https://jbig2dec.com">jbig2dec</ulink>, and
108 <ulink url="https://mujs.com/">MuJS</ulink>
109 </para>
110
111 <bridgehead renderas="sect4">Required (runtime)</bridgehead>
112 <para role="required">
113 <xref role="runtime" linkend="x-window-system"/>
114 </para>
115
116 <para condition="html" role="usernotes">
117 User Notes: <ulink url="&blfs-wiki;/mupdf"/>
118 </para>
119 </sect2>
120
121 <sect2 role="installation">
122 <title>Installation of MuPDF</title>
123
124 <para>First, fix the Makefile to link properly with the shared library:</para>
125
126<screen><userinput>sed -i '/MU.*_EXE. :/{
127 s/\(.(MUPDF_LIB)\)\(.*\)$/\2 | \1/
128 N
129 s/$/ -lmupdf -L$(OUT)/
130 }' Makefile</userinput></screen>
131
132 <para>
133 Install <application>MuPDF</application> by running the following
134 commands:
135 </para>
136
137<screen><userinput>cat &gt; user.make &lt;&lt; EOF &amp;&amp;
138USE_SYSTEM_FREETYPE := yes
139USE_SYSTEM_HARFBUZZ := yes
140USE_SYSTEM_JBIG2DEC := no
141USE_SYSTEM_JPEGXR := no # not used without HAVE_JPEGXR
142USE_SYSTEM_LCMS2 := no # need lcms2-art fork
143USE_SYSTEM_LIBJPEG := yes
144USE_SYSTEM_MUJS := no # build needs source anyways
145USE_SYSTEM_OPENJPEG := yes
146USE_SYSTEM_ZLIB := yes
147USE_SYSTEM_GLUT := no # need freeglut2-art fork
148USE_SYSTEM_CURL := yes
149USE_SYSTEM_GUMBO := no
150EOF
151
152export XCFLAGS=-fPIC &amp;&amp;
153make build=release shared=yes &amp;&amp;
154unset XCFLAGS</userinput></screen>
155
156 <para>
157 This package does not come with a test suite.
158 </para>
159
160 <para>
161 Now, as the <systemitem class="username">root</systemitem> user:
162 </para>
163
164<screen role="root"><userinput>make prefix=/usr \
165 shared=yes \
166 docdir=/usr/share/doc/mupdf-&mupdf-version; \
167 install &amp;&amp;
168
169chmod 755 /usr/lib/libmupdf.so &amp;&amp;
170ln -sfv mupdf-x11 /usr/bin/mupdf</userinput></screen>
171
172 </sect2>
173
174 <sect2 role="commands">
175 <title>Command Explanations</title>
176
177 <para>
178 <command>ln -sfv mupdf-x11 /usr/bin/mupdf </command>:
179 This symbolic link chooses between <command>mupdf-gl</command>
180 and <command>mupdf-x11</command> when running <command>mupdf</command>.
181 </para>
182
183 </sect2>
184
185 <sect2 role="content">
186 <title>Contents</title>
187
188 <segmentedlist>
189 <segtitle>Installed Program</segtitle>
190 <segtitle>Installed Libraries</segtitle>
191 <segtitle>Installed Directories</segtitle>
192
193 <seglistitem>
194 <seg>
195 mupdf (symlink),
196 mupdf-gl,
197 mupdf-x11,
198 mupdf-x11-curl,
199 muraster, and
200 mutool
201 </seg>
202 <seg>
203 libmupdf.so
204 </seg>
205 <seg>
206 /usr/include/mupdf,
207 /usr/share/doc/mupdf-&mupdf-version;
208 </seg>
209 </seglistitem>
210 </segmentedlist>
211
212 <variablelist>
213 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
214 <?dbfo list-presentation="list"?>
215 <?dbhtml list-presentation="table"?>
216
217 <varlistentry id="mupdf-prog">
218 <term><command>mupdf</command></term>
219 <listitem>
220 <para>
221 is a program for viewing PDF, XPS, EPUB, and CBZ documents,
222 and various image formats such as PNG, JPEG, GIFF, and TIFF
223 </para>
224 <indexterm zone="mupdf mupdf-prog">
225 <primary sortas="b-mupdf">mupdf</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="mupdf-gl">
231 <term><command>mupdf-gl</command></term>
232 <listitem>
233 <para>
234 same as <command>mupdf</command>, using an opengl renderer
235 </para>
236 <indexterm zone="mupdf mupdf-gl">
237 <primary sortas="b-mupdf-gl">mupdf-gl</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="mupdf-x11">
243 <term><command>mupdf-x11</command></term>
244 <listitem>
245 <para>
246 same as <command>mupdf</command>, using an X Window renderer
247 </para>
248 <indexterm zone="mupdf mupdf-x11">
249 <primary sortas="b-mupdf-x11">mupdf-x11</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="muraster">
255 <term><command>muraster</command></term>
256 <listitem>
257 <para>
258 is a program used to perform rasterization tasks with PDF
259 documents
260 </para>
261 <indexterm zone="mupdf muraster">
262 <primary sortas="b-muraster">muraster</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="mutool">
268 <term><command>mutool</command></term>
269 <listitem>
270 <para>
271 is a program to perform various operations on PDF files, such
272 as merging and cleaning PDF documents
273 </para>
274 <indexterm zone="mupdf mutool">
275 <primary sortas="b-mutool">mutool</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="libmupdf">
281 <term><filename class="libraryfile">libmupdf.so</filename></term>
282 <listitem>
283 <para>
284 contains the mupdf API functions
285 </para>
286 <indexterm zone="mupdf libmupdf">
287 <primary sortas="c-libmupdf">libmupdf.so</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 </variablelist>
293
294 </sect2>
295
296</sect1>
Note: See TracBrowser for help on using the repository browser.