source: general/graphlib/poppler.xml@ 9847c28

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 9847c28 was 9847c28, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to bluez-5.38.
Update to LVM2-22.02.147.
Update to poppler-0.42.0.
Update to libxkbcommon-0.6.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17174 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 16.8 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 "c63efcde7d52b4135bb7463b04790862">
10 <!ENTITY poppler-size "1.6 MB">
11 <!ENTITY poppler-buildsize "52 MB (with Qt4 and Qt5 libraries)">
12 <!ENTITY poppler-time "1.5 SBU (with Qt4 and Qt5 libraries)">
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<!-- as of 0.41.0, nothing to be done for check
161 <para>
162 In order to optionally run the test suite, an additional download using
163 <xref linkend="git"/> is necessary.
164 </para>
165
166<screen><userinput>rm -rf testfiles &amp;&amp;
167git clone git://git.freedesktop.org/git/poppler/test testfiles</userinput></screen>
168-->
169
170 <note>
171 <para>
172 This package can be optionally built with support for only one version
173 of Qt4 or Qt5 or without any Qt support. You can selectively disable
174 support for one or both, see "Command Explanations" section, below.
175 </para>
176 </note>
177
178 <para>
179 Install <application>Poppler</application> by running the following
180 commands:
181 </para>
182
183<screen><userinput>./configure --prefix=/usr \
184 --sysconfdir=/etc \
185 --disable-static \
186 --enable-build-type=release \
187 --enable-cmyk \
188 --enable-xpdf-headers \
189 --with-testdatadir=$PWD/testfiles &amp;&amp;
190make</userinput></screen>
191
192<!--<para>
193 To test the results, issue: <command>LC_ALL=en_US.UTF-8 make check</command>.
194 </para>-->
195
196 <para>
197 Now, as the <systemitem class="username">root</systemitem> user:
198 </para>
199
200<screen role="root"><userinput>make install</userinput></screen>
201
202 <para>
203 To install the documentation, run the following commands as
204 <systemitem class="username">root</systemitem>:
205 </para>
206
207<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/poppler-&poppler-version; &amp;&amp;
208install -v -m644 README* /usr/share/doc/poppler-&poppler-version; &amp;&amp;
209cp -vr glib/reference/html /usr/share/doc/poppler-&poppler-version;</userinput></screen>
210
211<!-- ==== Poppler Data ====== -->
212 <bridgehead renderas="sect3">Poppler Data</bridgehead>
213
214 <para>
215 If you downloaded the additional encoding data package, install it by
216 issuing the following commands as the
217 <systemitem class="username">root</systemitem> user:
218 </para>
219
220<screen><userinput>tar -xf ../poppler-data-&poppler-data-version;.tar.gz &amp;&amp;
221cd poppler-data-&poppler-data-version;</userinput></screen>
222
223 <para>
224 Now, as the <systemitem class="username">root</systemitem> user:
225 </para>
226
227<screen role="root"><userinput>make prefix=/usr install</userinput></screen>
228
229 </sect2>
230
231 <sect2 role="commands">
232 <title>Command Explanations</title>
233
234 <para>
235 <parameter>--enable-build-type=release</parameter>: This switch is used
236 to apply a higher level of compiler optimizations. Other options are:
237 [<option>relwithdebinfo/debug/debugfull/profile</option>]
238 </para>
239
240 <para>
241 <parameter>--enable-cmyk</parameter>:
242 Include support for CMYK rasterization.
243 </para>
244
245 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
246 href="../../xincludes/static-libraries.xml"/>
247
248 <para>
249 <parameter>--enable-xpdf-headers</parameter>: Install some old
250 <application>Xpdf</application> headers required by certain programs (e.g.
251 <application>Okular</application>, <application>LibreOffice</application>
252 and <application>Inkscape</application>).
253 </para>
254
255 <para>
256 <parameter>--with-testdatadir=$PWD/testfiles</parameter>: Tell the test
257 programs where the auxillary files are located.
258 </para>
259
260 <para>
261 <option>--enable-libcurl</option>: Use libcurl for HTTP support.
262 </para>
263
264 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
265 href="../../xincludes/gtk-doc-rebuild.xml"/>
266
267 <para>
268 <option>--disable-poppler-qt4</option>: Don't compile poppler Qt4 wrapper.
269 </para>
270
271 <para>
272 <option>--disable-poppler-qt5</option>: Don't compile poppler Qt5 wrapper.
273 </para>
274
275 <para>
276 <command>LC_ALL=en_US.UTF-8 make check</command>: Run the test suite.
277 The environment variable LC_ALL=en_US.UTF-8 is only needed if the
278 default locale does not include UTF-8.
279 </para>
280
281 </sect2>
282
283 <sect2 role="content">
284 <title>Contents</title>
285
286 <segmentedlist>
287 <segtitle>Installed Programs</segtitle>
288 <segtitle>Installed Libraries</segtitle>
289 <segtitle>Installed Directories</segtitle>
290
291 <seglistitem>
292 <seg>
293 pdfdetach, pdffonts, pdfimages, pdfinfo, pdfseparate,
294 pdftocairo, pdftohtml, pdftoppm, pdftops, pdftotext,
295 pdfunite, and poppler-glib-demo
296 </seg>
297 <seg>
298 libpoppler.so,
299 libpoppler-cpp.so,
300 libpoppler-glib.so,
301 libpoppler-qt4.so, and
302 libpoppler-qt5.so
303 </seg>
304 <seg>
305 /usr/{include,share,share/gtk-doc/html}/poppler and
306 /usr/share/doc/poppler-&poppler-version;
307 </seg>
308 </seglistitem>
309 </segmentedlist>
310
311 <variablelist>
312 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
313 <?dbfo list-presentation="list"?>
314 <?dbhtml list-presentation="table"?>
315
316 <varlistentry id="pdfdetach">
317 <term><command>pdfdetach</command></term>
318 <listitem>
319 <para>
320 lists or extracts embedded files from PDF files.
321 </para>
322 <indexterm zone="poppler pdfdetach">
323 <primary sortas="b-pdfdetach">pdfdetach</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="pdffonts">
329 <term><command>pdffonts</command></term>
330 <listitem>
331 <para>
332 lists the fonts used in a PDF file along with various information
333 for each font.
334 </para>
335 <indexterm zone="poppler pdffonts">
336 <primary sortas="b-pdffonts">pdffonts</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="pdfimages">
342 <term><command>pdfimages</command></term>
343 <listitem>
344 <para>
345 saves images from a PDF file as PPM, PBM, or JPEG files.
346 </para>
347 <indexterm zone="poppler pdfimages">
348 <primary sortas="b-pdfimages">pdfimages</primary>
349 </indexterm>
350 </listitem>
351 </varlistentry>
352
353 <varlistentry id="pdfinfo">
354 <term><command>pdfinfo</command></term>
355 <listitem>
356 <para>
357 prints the contents of the 'Info' dictionary (plus some other useful
358 information) from a PDF file.
359 </para>
360 <indexterm zone="poppler pdfinfo">
361 <primary sortas="b-pdfinfo">pdfinfo</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="pdfseparate">
367 <term><command>pdfseparate</command></term>
368 <listitem>
369 <para>
370 extracts single pages from a PDF file.
371 </para>
372 <indexterm zone="poppler pdfseparate">
373 <primary sortas="b-pdseparate">pdfseparate</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="pdftocairo">
379 <term><command>pdftocairo</command></term>
380 <listitem>
381 <para>
382 converts a PDF file to one of several formats (PNG, JPEG, PDF, PS,
383 EPS, SVG) using the cairo output device of the poppler library.
384 </para>
385 <indexterm zone="poppler pdftocairo">
386 <primary sortas="b-pdftocairo">pdftocairo</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="pdftohtml">
392 <term><command>pdftohtml</command></term>
393 <listitem>
394 <para>
395 converts a PDF file to HTML.
396 </para>
397 <indexterm zone="poppler pdftohtml">
398 <primary sortas="b-pdftohtml">pdftohtml</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 <varlistentry id="pdftoppm">
404 <term><command>pdftoppm</command></term>
405 <listitem>
406 <para>
407 converts PDF files to PBM, PGM and PPM formats.
408 </para>
409 <indexterm zone="poppler pdftoppm">
410 <primary sortas="b-pdftoppm">pdftoppm</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="pdftops">
416 <term><command>pdftops</command></term>
417 <listitem>
418 <para>
419 converts PDF files to Postscript format.
420 </para>
421 <indexterm zone="poppler pdftops">
422 <primary sortas="b-pdftops">pdftops</primary>
423 </indexterm>
424 </listitem>
425 </varlistentry>
426
427 <varlistentry id="pdftotext">
428 <term><command>pdftotext</command></term>
429 <listitem>
430 <para>
431 converts PDF files to plain text.
432 </para>
433 <indexterm zone="poppler pdftotext">
434 <primary sortas="b-pdftotext">pdftotext</primary>
435 </indexterm>
436 </listitem>
437 </varlistentry>
438
439 <varlistentry id="pdfunite">
440 <term><command>pdfunite</command></term>
441 <listitem>
442 <para>
443 merges several PDF files, in the order of their occurrence on the
444 command line, to one PDF output file.
445 </para>
446 <indexterm zone="poppler pdfunite">
447 <primary sortas="b-pdfunite">pdfunite</primary>
448 </indexterm>
449 </listitem>
450 </varlistentry>
451
452 <varlistentry id="poppler-glib-demo">
453 <term><command>poppler-glib-demo</command></term>
454 <listitem>
455 <para>
456 is a tool to demonstrate the API, and for use when debugging and
457 testing <application>Poppler</application>.
458 </para>
459 <indexterm zone="poppler poppler-glib-demo">
460 <primary sortas="b-poppler-glib-demo">poppler-glib-demo</primary>
461 </indexterm>
462 </listitem>
463 </varlistentry>
464
465 <varlistentry id="libpoppler">
466 <term><filename class="libraryfile">libpoppler.so</filename></term>
467 <listitem>
468 <para>
469 contains the API functions to render PDF files.
470 </para>
471 <indexterm zone="poppler libpoppler">
472 <primary sortas="c-libpoppler">libpoppler.so</primary>
473 </indexterm>
474 </listitem>
475 </varlistentry>
476
477 <varlistentry id="libpoppler-cpp">
478 <term><filename class="libraryfile">libpoppler-cpp.so</filename></term>
479 <listitem>
480 <para>
481 is a C++ backend for rendering PDF files.
482 </para>
483 <indexterm zone="poppler libpoppler-cpp">
484 <primary sortas="c-libpoppler-cpp">libpoppler-cpp.so</primary>
485 </indexterm>
486 </listitem>
487 </varlistentry>
488
489 <varlistentry id="libpoppler-glib">
490 <term><filename class="libraryfile">libpoppler-glib.so</filename></term>
491 <listitem>
492 <para>
493 is a wrapper library used to interface the PDF rendering functions
494 with <application>GTK+</application>.
495 </para>
496 <indexterm zone="poppler libpoppler-glib">
497 <primary sortas="c-libpoppler-glib">libpoppler-glib.so</primary>
498 </indexterm>
499 </listitem>
500 </varlistentry>
501
502 <varlistentry id="libpoppler-qt4">
503 <term><filename class="libraryfile">libpoppler-qt4.so</filename></term>
504 <listitem>
505 <para>
506 is a wrapper library used to interface the PDF rendering functions
507 with <application>Qt</application>4.
508 </para>
509 <indexterm zone="poppler libpoppler-qt4">
510 <primary sortas="c-libpoppler-qt4">libpoppler-qt4.so</primary>
511 </indexterm>
512 </listitem>
513 </varlistentry>
514
515 <varlistentry id="libpoppler-qt5">
516 <term><filename class="libraryfile">libpoppler-qt5.so</filename></term>
517 <listitem>
518 <para>
519 is a wrapper library used to interface the PDF rendering functions
520 with <application>Qt</application>5.
521 </para>
522 <indexterm zone="poppler libpoppler-qt5">
523 <primary sortas="c-libpoppler-qt5">libpoppler-qt5.so</primary>
524 </indexterm>
525 </listitem>
526 </varlistentry>
527
528 </variablelist>
529
530 </sect2>
531
532</sect1>
Note: See TracBrowser for help on using the repository browser.