source: general/graphlib/poppler.xml@ 697c45ec

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 697c45ec was 697c45ec, checked in by Pierre Labastie <pieere@…>, 8 years ago

Poppler-0.44.0

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