source: general/graphlib/poppler.xml@ 03da570f

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 03da570f was 03da570f, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Update to openssl-1.0.2d.
Update to bluez-5.32.
Update to poppler-0.34.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16226 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 16.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 <!ENTITY poppler-download-http
8 "http://poppler.freedesktop.org/poppler-&poppler-version;.tar.xz">
9 <!ENTITY poppler-download-ftp " ">
10 <!ENTITY poppler-md5sum "7d788f85bca1c03d71773af0b902e203">
11 <!ENTITY poppler-size "1.5 MB">
12 <!ENTITY poppler-buildsize "185 MB (building Qt4 and 5 libraries, add'l 63 MB for tests)">
13 <!ENTITY poppler-time "1.4 SBU (building Qt4 and 5 libraries, add'l 0.4 SBU for tests)">
14
15 <!ENTITY poppler-data-version "0.4.7">
16
17 <!ENTITY poppler-data-download-http
18 "http://poppler.freedesktop.org/poppler-data-&poppler-data-version;.tar.gz">
19 <!ENTITY poppler-data-md5sum "636a8f2b9f6df9e7ced8ec0946961eaf">
20 <!ENTITY poppler-data-size "4.0 MB">
21]>
22
23<sect1 id="poppler" xreflabel="Poppler-&poppler-version;">
24 <?dbhtml filename="poppler.html"?>
25
26 <sect1info>
27 <othername>$LastChangedBy$</othername>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>Poppler-&poppler-version;</title>
32
33 <indexterm zone="poppler">
34 <primary sortas="a-Poppler">Poppler</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to Poppler</title>
39
40 <para>
41 The <application>Poppler</application> package contains a PDF rendering
42 library and command line tools used to manipulate PDF files. This is
43 useful for providing PDF rendering functionality as a shared library.
44 </para>
45
46 &lfs77_checked; &gcc5_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&poppler-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&poppler-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &poppler-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &poppler-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &poppler-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &poppler-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
83
84 <itemizedlist spacing="compact">
85 <title>Poppler Encoding Data</title>
86 <listitem>
87 <para>
88 Download (HTTP): <ulink url="&poppler-data-download-http;"/>
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Download MD5 sum: &poppler-data-md5sum;
94 </para>
95 </listitem>
96 <listitem>
97 <para>
98 Download size: &poppler-data-size;
99 </para>
100 </listitem>
101 </itemizedlist>
102
103 <para>
104 The additional package consists of encoding files for use with
105 <application>Poppler</application>. The encoding files are optional and
106 <application>Poppler</application> will automatically read them if they
107 are present. When installed, they enable
108 <application>Poppler</application> to render CJK and Cyrillic properly.
109 </para>
110
111 <bridgehead renderas="sect3">Poppler Dependencies</bridgehead>
112
113 <bridgehead renderas="sect4">Required</bridgehead>
114 <para role="required">
115 <xref linkend="fontconfig"/>
116 </para>
117
118 <bridgehead renderas="sect4">Recommended</bridgehead>
119 <para role="recommended">
120 <xref linkend="cairo"/>,
121 <xref linkend="libjpeg"/>,
122 <xref linkend="libpng"/>, and
123 <xref linkend="openjpeg"/>
124 </para>
125
126 <bridgehead renderas="sect4">Optional</bridgehead>
127 <para role="optional">
128 <xref linkend="curl"/>,
129 <xref linkend="gobject-introspection"/>,
130 <xref linkend="gtk-doc"/>,
131 <xref linkend="gtk2"/>,
132 <xref linkend="lcms"/> or <xref linkend="lcms2"/>,
133 <xref linkend="libtiff"/>,
134 <xref linkend="openjpeg2"/>
135 (preference is for OpenJPEG1, due to regressions with OpenJPEG2),
136 <xref linkend="qt4"/> (the <filename>libpoppler-qt4.so</filename> library
137 is needed for PDF support in <application>Okular</application>), and
138 <xref linkend="qt5"/>
139 </para>
140
141 <para condition="html" role="usernotes">
142 User Notes: <ulink url="&blfs-wiki;/poppler"/>
143 </para>
144 </sect2>
145
146 <sect2 role="installation">
147 <title>Installation of Poppler</title>
148
149 <para>
150 In order to optionally run the test suite, an additional download of about
151 9 MB using <xref linkend="git"/> is necessary.
152 </para>
153
154<screen><userinput>rm -rf testfiles &amp;&amp;
155git clone git://git.freedesktop.org/git/poppler/test testfiles</userinput></screen>
156
157 <note><para>
158
159 This package can be optionally built with support for only one version of
160 Qt4 or Qt5. If you have only one, no modification is necessary. If both
161 are installed, and you wish support for only one, before executing the
162 <command>configure</command> command given below, use this command to
163 select Qt4:
164
165 <screen><userinput>source /usr/bin/setqt4</userinput></screen>
166
167 or this to select Qt5:
168
169 <screen><userinput>source /usr/bin/setqt5</userinput></screen>
170 </para></note>
171
172 <para>
173 Install <application>Poppler</application> by running the following
174 commands:
175 </para>
176
177<screen><userinput>MOCQT4=$QT4DIR/bin/moc \
178MOCQT5=$QT5DIR/bin/moc \
179./configure --prefix=/usr \
180 --sysconfdir=/etc \
181 --disable-static \
182 --enable-xpdf-headers \
183 --with-testdatadir=$PWD/testfiles &amp;&amp;
184make</userinput></screen>
185
186 <para>
187 To test the results, issue: <command>LC_ALL=en_US.UTF-8 make check</command>.
188 </para>
189
190 <para>
191 Now, as the <systemitem class="username">root</systemitem> user:
192 </para>
193
194<screen role="root"><userinput>make install</userinput></screen>
195
196 <para>
197 To install the documentation, run the following commands as
198 <systemitem class="username">root</systemitem>:
199 </para>
200
201<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/poppler-&poppler-version; &amp;&amp;
202install -v -m644 README* /usr/share/doc/poppler-&poppler-version; &amp;&amp;
203cp -vr glib/reference/html /usr/share/doc/poppler-&poppler-version;</userinput></screen>
204
205<!-- ==== Poppler Data ====== -->
206 <bridgehead renderas="sect3">Poppler Data</bridgehead>
207
208 <para>
209 If you downloaded the additional encoding data package, install it by
210 issuing the following commands as the
211 <systemitem class="username">root</systemitem> user:
212 </para>
213
214<screen><userinput>tar -xf ../poppler-data-&poppler-data-version;.tar.gz &amp;&amp;
215cd poppler-data-&poppler-data-version;</userinput></screen>
216
217 <para>
218 Now, as the <systemitem class="username">root</systemitem> user:
219 </para>
220
221<screen role="root"><userinput>make prefix=/usr install</userinput></screen>
222
223 </sect2>
224
225 <sect2 role="commands">
226 <title>Command Explanations</title>
227
228 <para>
229 <envar>MOCQT4=$QT4DIR/bin/moc</envar> and
230 <envar>MOCQT5=$QT5DIR/bin/moc</envar>:
231 These environment variables are necessary, for linking with the two Qt
232 versions, if both are installed. If only one Qt version is installed or
233 you wish to link to only one version, you can remove them, although this
234 is not necessary.
235 </para>
236
237 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
238 href="../../xincludes/static-libraries.xml"/>
239
240 <para>
241 <option>--enable-xpdf-headers</option>: Install some old
242 <application>Xpdf</application> headers required by certain programs (e.g.
243 <application>Okular</application>, <application>LibreOffice</application>
244 and <application>Inkscape</application>).
245 </para>
246
247 <para>
248 <option>--with-testdatadir=$PWD/testfiles</option>: Tell the test
249 programs where the auxillary files are located.
250 </para>
251
252 <para>
253 <option>--enable-libcurl</option>: Use libcurl for HTTP support.
254 </para>
255
256 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
257 href="../../xincludes/gtk-doc-rebuild.xml"/>
258
259 <para>
260 <command>LC_ALL=en_US.UTF-8 make check</command>: Run the test suite.
261 The environment variable LC_ALL=en_US.UTF-8 is only needed if the
262 default locale does not include UTF-8.
263 </para>
264
265 </sect2>
266
267 <sect2 role="content">
268 <title>Contents</title>
269
270 <segmentedlist>
271 <segtitle>Installed Programs</segtitle>
272 <segtitle>Installed Libraries</segtitle>
273 <segtitle>Installed Directories</segtitle>
274
275 <seglistitem>
276 <seg>
277 pdfdetach, pdffonts, pdfimages, pdfinfo, pdfseparate,
278 pdftocairo, pdftohtml, pdftoppm, pdftops, pdftotext,
279 pdfunite, and poppler-glib-demo
280 </seg>
281 <seg>
282 libpoppler.so, libpoppler-cpp.so,
283 libpoppler-glib.so,
284 libpoppler-qt4.so, and
285 libpoppler-qt5.so
286 </seg>
287 <seg>
288 /usr/include/poppler,
289 /usr/share/doc/poppler-&poppler-version;,
290 /usr/share/gtk-doc/html/poppler, and
291 /usr/share/poppler
292 </seg>
293 </seglistitem>
294 </segmentedlist>
295
296 <variablelist>
297 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
298 <?dbfo list-presentation="list"?>
299 <?dbhtml list-presentation="table"?>
300
301 <varlistentry id="pdfdetach">
302 <term><command>pdfdetach</command></term>
303 <listitem>
304 <para>
305 lists or extracts embedded files from PDF files.
306 </para>
307 <indexterm zone="poppler pdfdetach">
308 <primary sortas="b-pdfdetach">pdfdetach</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="pdffonts">
314 <term><command>pdffonts</command></term>
315 <listitem>
316 <para>
317 lists the fonts used in a PDF file along with various information
318 for each font.
319 </para>
320 <indexterm zone="poppler pdffonts">
321 <primary sortas="b-pdffonts">pdffonts</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="pdfimages">
327 <term><command>pdfimages</command></term>
328 <listitem>
329 <para>
330 saves images from a PDF file as PPM, PBM, or JPEG files.
331 </para>
332 <indexterm zone="poppler pdfimages">
333 <primary sortas="b-pdfimages">pdfimages</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 <varlistentry id="pdfinfo">
339 <term><command>pdfinfo</command></term>
340 <listitem>
341 <para>
342 prints the contents of the 'Info' dictionary (plus some other useful
343 information) from a PDF file.
344 </para>
345 <indexterm zone="poppler pdfinfo">
346 <primary sortas="b-pdfinfo">pdfinfo</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="pdfseparate">
352 <term><command>pdfseparate</command></term>
353 <listitem>
354 <para>
355 extracts single pages from a PDF file.
356 </para>
357 <indexterm zone="poppler pdfseparate">
358 <primary sortas="b-pdseparate">pdfseparate</primary>
359 </indexterm>
360 </listitem>
361 </varlistentry>
362
363 <varlistentry id="pdftocairo">
364 <term><command>pdftocairo</command></term>
365 <listitem>
366 <para>
367 converts a PDF file to one of several formats (PNG, JPEG, PDF, PS,
368 EPS, SVG) using the cairo output device of the poppler library.
369 </para>
370 <indexterm zone="poppler pdftocairo">
371 <primary sortas="b-pdftocairo">pdftocairo</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="pdftohtml">
377 <term><command>pdftohtml</command></term>
378 <listitem>
379 <para>
380 converts a PDF file to HTML.
381 </para>
382 <indexterm zone="poppler pdftohtml">
383 <primary sortas="b-pdftohtml">pdftohtml</primary>
384 </indexterm>
385 </listitem>
386 </varlistentry>
387
388 <varlistentry id="pdftoppm">
389 <term><command>pdftoppm</command></term>
390 <listitem>
391 <para>
392 converts PDF files to PBM, PGM and PPM formats.
393 </para>
394 <indexterm zone="poppler pdftoppm">
395 <primary sortas="b-pdftoppm">pdftoppm</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 <varlistentry id="pdftops">
401 <term><command>pdftops</command></term>
402 <listitem>
403 <para>
404 converts PDF files to Postscript format.
405 </para>
406 <indexterm zone="poppler pdftops">
407 <primary sortas="b-pdftops">pdftops</primary>
408 </indexterm>
409 </listitem>
410 </varlistentry>
411
412 <varlistentry id="pdftotext">
413 <term><command>pdftotext</command></term>
414 <listitem>
415 <para>
416 converts PDF files to plain text.
417 </para>
418 <indexterm zone="poppler pdftotext">
419 <primary sortas="b-pdftotext">pdftotext</primary>
420 </indexterm>
421 </listitem>
422 </varlistentry>
423
424 <varlistentry id="pdfunite">
425 <term><command>pdfunite</command></term>
426 <listitem>
427 <para>
428 merges several PDF files, in the order of their occurrence on the
429 command line, to one PDF output file.
430 </para>
431 <indexterm zone="poppler pdfunite">
432 <primary sortas="b-pdfunite">pdfunite</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 <varlistentry id="poppler-glib-demo">
438 <term><command>poppler-glib-demo</command></term>
439 <listitem>
440 <para>
441 is a tool to demonstrate the API, and for use when debugging and
442 testing <application>Poppler</application>.
443 </para>
444 <indexterm zone="poppler poppler-glib-demo">
445 <primary sortas="b-poppler-glib-demo">poppler-glib-demo</primary>
446 </indexterm>
447 </listitem>
448 </varlistentry>
449
450 <varlistentry id="libpoppler">
451 <term><filename class="libraryfile">libpoppler.so</filename></term>
452 <listitem>
453 <para>
454 contains the API functions to render PDF files.
455 </para>
456 <indexterm zone="poppler libpoppler">
457 <primary sortas="c-libpoppler">libpoppler.so</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="libpoppler-cpp">
463 <term><filename class="libraryfile">libpoppler-cpp.so</filename></term>
464 <listitem>
465 <para>
466 is a C++ backend for rendering PDF files.
467 </para>
468 <indexterm zone="poppler libpoppler-cpp">
469 <primary sortas="c-libpoppler-cpp">libpoppler-cpp.so</primary>
470 </indexterm>
471 </listitem>
472 </varlistentry>
473
474 <varlistentry id="libpoppler-glib">
475 <term><filename class="libraryfile">libpoppler-glib.so</filename></term>
476 <listitem>
477 <para>
478 is a wrapper library used to interface the PDF rendering functions
479 with <application>GTK+</application>.
480 </para>
481 <indexterm zone="poppler libpoppler-glib">
482 <primary sortas="c-libpoppler-glib">libpoppler-glib.so</primary>
483 </indexterm>
484 </listitem>
485 </varlistentry>
486
487 <varlistentry id="libpoppler-qt4">
488 <term><filename class="libraryfile">libpoppler-qt4.so</filename></term>
489 <listitem>
490 <para>
491 is a wrapper library used to interface the PDF rendering functions
492 with <application>Qt</application>4.
493 </para>
494 <indexterm zone="poppler libpoppler-qt4">
495 <primary sortas="c-libpoppler-qt4">libpoppler-qt4.so</primary>
496 </indexterm>
497 </listitem>
498 </varlistentry>
499
500 <varlistentry id="libpoppler-qt5">
501 <term><filename class="libraryfile">libpoppler-qt5.so</filename></term>
502 <listitem>
503 <para>
504 is a wrapper library used to interface the PDF rendering functions
505 with <application>Qt</application>5.
506 </para>
507 <indexterm zone="poppler libpoppler-qt5">
508 <primary sortas="c-libpoppler-qt5">libpoppler-qt5.so</primary>
509 </indexterm>
510 </listitem>
511 </varlistentry>
512
513 </variablelist>
514
515 </sect2>
516
517</sect1>
Note: See TracBrowser for help on using the repository browser.