source: general/graphlib/poppler.xml@ 56be7ef2

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 56be7ef2 was 56be7ef2, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to poppler-0.48.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17865 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 16.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 poppler-download-http "http://poppler.freedesktop.org/poppler-&poppler-version;.tar.xz">
8 <!ENTITY poppler-download-ftp " ">
9 <!ENTITY poppler-md5sum "8d61c91cb9e99ad38bba1b0b4432f174">
10 <!ENTITY poppler-size "1.6 MB">
11 <!ENTITY poppler-buildsize "49 MB (with Qt5 library)">
12 <!ENTITY poppler-time "1.3 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 &lfs7a_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"/>,
134 <xref linkend="nss"/>, and
135 <xref linkend="openjpeg"/>
136 </para>
137
138 <bridgehead renderas="sect4">Optional</bridgehead>
139 <para role="optional">
140 <xref linkend="curl"/>,
141 <xref linkend="gobject-introspection"/>,
142 <xref linkend="gtk-doc"/>,
143 <xref linkend="gtk2"/>,
144 <xref linkend="lcms"/> or <xref linkend="lcms2"/>,
145 <xref linkend="libtiff"/>,
146 <xref linkend="openjpeg2"/>
147 (preference is for OpenJPEG1, due to regressions with OpenJPEG2), and
148 <xref linkend="qt5"/>
149 </para>
150
151 <para condition="html" role="usernotes">
152 User Notes: <ulink url="&blfs-wiki;/poppler"/>
153 </para>
154 </sect2>
155
156 <sect2 role="installation">
157 <title>Installation of Poppler</title>
158
159 <note>
160 <para>
161 This package can be optionally built with support for only one version
162 of Qt4 or Qt5 or without any Qt support. You can selectively disable
163 support for one or both, see "Command Explanations" section, below.
164 </para>
165 </note>
166
167 <para>
168 Install <application>Poppler</application> by running the following
169 commands:
170 </para>
171
172<screen><userinput>./configure --prefix=/usr \
173 --sysconfdir=/etc \
174 --disable-static \
175 --enable-build-type=release \
176 --enable-cmyk \
177 --enable-xpdf-headers \
178 --with-testdatadir=$PWD/testfiles &amp;&amp;
179make</userinput></screen>
180
181 <para>
182 In order to run the test suite, some testcases are needed and can
183 be obtained only from a git repository. The command to download
184 them is:
185<command>git clone git://git.freedesktop.org/git/poppler/test testfiles</command>.
186 Then issue: <command>LC_ALL=en_US.UTF-8 make check</command>. It seems
187 that only the Qt4/5 libraries are tested.
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 <parameter>--enable-build-type=release</parameter>: This switch is used
230 to apply a higher level of compiler optimizations. Other options are:
231 [<option>relwithdebinfo/debug/debugfull/profile</option>]
232 </para>
233
234 <para>
235 <parameter>--enable-cmyk</parameter>:
236 Include support for CMYK rasterization.
237 </para>
238
239 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
240 href="../../xincludes/static-libraries.xml"/>
241
242 <para>
243 <parameter>--enable-xpdf-headers</parameter>: Install some old
244 <application>Xpdf</application> headers required by certain programs (e.g.
245 <application>Okular</application>, <application>LibreOffice</application>
246 and <application>Inkscape</application>).
247 </para>
248
249 <para>
250 <parameter>--with-testdatadir=$PWD/testfiles</parameter>: Tell the test
251 programs where the auxiliary files are located.
252 </para>
253
254 <para>
255 <option>--enable-libcurl</option>: Use libcurl for HTTP support.
256 </para>
257
258 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
259 href="../../xincludes/gtk-doc-rebuild.xml"/>
260
261 <para>
262 <option>--disable-poppler-qt4</option>: Don't compile poppler Qt4 wrapper.
263 </para>
264
265 <para>
266 <option>--disable-poppler-qt5</option>: Don't compile poppler Qt5 wrapper.
267 </para>
268
269 <para>
270 <command>LC_ALL=en_US.UTF-8 make check</command>: Run the test suite.
271 The environment variable LC_ALL=en_US.UTF-8 is only needed if the
272 default locale does not include UTF-8.
273 </para>
274
275 </sect2>
276
277 <sect2 role="content">
278 <title>Contents</title>
279
280 <segmentedlist>
281 <segtitle>Installed Programs</segtitle>
282 <segtitle>Installed Libraries</segtitle>
283 <segtitle>Installed Directories</segtitle>
284
285 <seglistitem>
286 <seg>
287 pdfdetach, pdffonts, pdfimages, pdfinfo, pdfseparate, pdfsig,
288 pdftocairo, pdftohtml, pdftoppm, pdftops, pdftotext,
289 pdfunite, and poppler-glib-demo
290 </seg>
291 <seg>
292 libpoppler.so,
293 libpoppler-cpp.so,
294 libpoppler-glib.so, and
295 libpoppler-qt5.so
296 </seg>
297 <seg>
298 /usr/{include,share,share/gtk-doc/html}/poppler and
299 /usr/share/doc/poppler-&poppler-version;
300 </seg>
301 </seglistitem>
302 </segmentedlist>
303
304 <variablelist>
305 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
306 <?dbfo list-presentation="list"?>
307 <?dbhtml list-presentation="table"?>
308
309 <varlistentry id="pdfdetach">
310 <term><command>pdfdetach</command></term>
311 <listitem>
312 <para>
313 lists or extracts embedded files from PDF files.
314 </para>
315 <indexterm zone="poppler pdfdetach">
316 <primary sortas="b-pdfdetach">pdfdetach</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="pdffonts">
322 <term><command>pdffonts</command></term>
323 <listitem>
324 <para>
325 lists the fonts used in a PDF file along with various information
326 for each font.
327 </para>
328 <indexterm zone="poppler pdffonts">
329 <primary sortas="b-pdffonts">pdffonts</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="pdfimages">
335 <term><command>pdfimages</command></term>
336 <listitem>
337 <para>
338 saves images from a PDF file as PPM, PBM, or JPEG files.
339 </para>
340 <indexterm zone="poppler pdfimages">
341 <primary sortas="b-pdfimages">pdfimages</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="pdfinfo">
347 <term><command>pdfinfo</command></term>
348 <listitem>
349 <para>
350 prints the contents of the 'Info' dictionary (plus some other useful
351 information) from a PDF file.
352 </para>
353 <indexterm zone="poppler pdfinfo">
354 <primary sortas="b-pdfinfo">pdfinfo</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="pdfseparate">
360 <term><command>pdfseparate</command></term>
361 <listitem>
362 <para>
363 extracts single pages from a PDF file.
364 </para>
365 <indexterm zone="poppler pdfseparate">
366 <primary sortas="b-pdseparate">pdfseparate</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370
371 <varlistentry id="pdfsig">
372 <term><command>pdfsig</command></term>
373 <listitem>
374 <para>
375 verifies the digital signatures in a PDF document.
376 </para>
377 <indexterm zone="poppler pdfsig">
378 <primary sortas="b-pdseparate">pdfsig</primary>
379 </indexterm>
380 </listitem>
381 </varlistentry>
382
383 <varlistentry id="pdftocairo">
384 <term><command>pdftocairo</command></term>
385 <listitem>
386 <para>
387 converts a PDF file to one of several formats (PNG, JPEG, PDF, PS,
388 EPS, SVG) using the cairo output device of the poppler library.
389 </para>
390 <indexterm zone="poppler pdftocairo">
391 <primary sortas="b-pdftocairo">pdftocairo</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="pdftohtml">
397 <term><command>pdftohtml</command></term>
398 <listitem>
399 <para>
400 converts a PDF file to HTML.
401 </para>
402 <indexterm zone="poppler pdftohtml">
403 <primary sortas="b-pdftohtml">pdftohtml</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407
408 <varlistentry id="pdftoppm">
409 <term><command>pdftoppm</command></term>
410 <listitem>
411 <para>
412 converts PDF files to PBM, PGM and PPM formats.
413 </para>
414 <indexterm zone="poppler pdftoppm">
415 <primary sortas="b-pdftoppm">pdftoppm</primary>
416 </indexterm>
417 </listitem>
418 </varlistentry>
419
420 <varlistentry id="pdftops">
421 <term><command>pdftops</command></term>
422 <listitem>
423 <para>
424 converts PDF files to Postscript format.
425 </para>
426 <indexterm zone="poppler pdftops">
427 <primary sortas="b-pdftops">pdftops</primary>
428 </indexterm>
429 </listitem>
430 </varlistentry>
431
432 <varlistentry id="pdftotext">
433 <term><command>pdftotext</command></term>
434 <listitem>
435 <para>
436 converts PDF files to plain text.
437 </para>
438 <indexterm zone="poppler pdftotext">
439 <primary sortas="b-pdftotext">pdftotext</primary>
440 </indexterm>
441 </listitem>
442 </varlistentry>
443
444 <varlistentry id="pdfunite">
445 <term><command>pdfunite</command></term>
446 <listitem>
447 <para>
448 merges several PDF files, in the order of their occurrence on the
449 command line, to one PDF output file.
450 </para>
451 <indexterm zone="poppler pdfunite">
452 <primary sortas="b-pdfunite">pdfunite</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="poppler-glib-demo">
458 <term><command>poppler-glib-demo</command></term>
459 <listitem>
460 <para>
461 is a tool to demonstrate the API, and for use when debugging and
462 testing <application>Poppler</application>.
463 </para>
464 <indexterm zone="poppler poppler-glib-demo">
465 <primary sortas="b-poppler-glib-demo">poppler-glib-demo</primary>
466 </indexterm>
467 </listitem>
468 </varlistentry>
469
470 <varlistentry id="libpoppler">
471 <term><filename class="libraryfile">libpoppler.so</filename></term>
472 <listitem>
473 <para>
474 contains the API functions to render PDF files.
475 </para>
476 <indexterm zone="poppler libpoppler">
477 <primary sortas="c-libpoppler">libpoppler.so</primary>
478 </indexterm>
479 </listitem>
480 </varlistentry>
481
482 <varlistentry id="libpoppler-cpp">
483 <term><filename class="libraryfile">libpoppler-cpp.so</filename></term>
484 <listitem>
485 <para>
486 is a C++ backend for rendering PDF files.
487 </para>
488 <indexterm zone="poppler libpoppler-cpp">
489 <primary sortas="c-libpoppler-cpp">libpoppler-cpp.so</primary>
490 </indexterm>
491 </listitem>
492 </varlistentry>
493
494 <varlistentry id="libpoppler-glib">
495 <term><filename class="libraryfile">libpoppler-glib.so</filename></term>
496 <listitem>
497 <para>
498 is a wrapper library used to interface the PDF rendering functions
499 with <application>GTK+</application>.
500 </para>
501 <indexterm zone="poppler libpoppler-glib">
502 <primary sortas="c-libpoppler-glib">libpoppler-glib.so</primary>
503 </indexterm>
504 </listitem>
505 </varlistentry>
506
507<!--
508 <varlistentry id="libpoppler-qt4">
509 <term><filename class="libraryfile">libpoppler-qt4.so</filename></term>
510 <listitem>
511 <para>
512 is a wrapper library used to interface the PDF rendering functions
513 with <application>Qt</application>4.
514 </para>
515 <indexterm zone="poppler libpoppler-qt4">
516 <primary sortas="c-libpoppler-qt4">libpoppler-qt4.so</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520-->
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.