source: general/graphlib/poppler.xml@ 77a6d25

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 77a6d25 was 77a6d25, checked in by Igor Živković <igor@…>, 5 years ago

misspellings

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17675 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 "a6513d6fe72751c58b501403c3da6ef1">
10 <!ENTITY poppler-size "1.5 MB">
11 <!ENTITY poppler-buildsize "49 MB (with Qt5 library)">
12 <!ENTITY poppler-time "1.5 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;&gcc6_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), and
147 <xref linkend="qt5"/>
148 </para>
149
150 <para condition="html" role="usernotes">
151 User Notes: <ulink url="&blfs-wiki;/poppler"/>
152 </para>
153 </sect2>
154
155 <sect2 role="installation">
156 <title>Installation of Poppler</title>
157
158 <note>
159 <para>
160 This package can be optionally built with support for only one version
161 of Qt4 or Qt5 or without any Qt support. You can selectively disable
162 support for one or both, see "Command Explanations" section, below.
163 </para>
164 </note>
165
166 <para>
167 Install <application>Poppler</application> by running the following
168 commands:
169 </para>
170
171<screen><userinput>./configure --prefix=/usr \
172 --sysconfdir=/etc \
173 --disable-static \
174 --enable-build-type=release \
175 --enable-cmyk \
176 --enable-xpdf-headers \
177 --with-testdatadir=$PWD/testfiles &amp;&amp;
178make</userinput></screen>
179
180 <para>
181 In order to run the test suite, some testcases are needed and can
182 be obtained only from a git repository. The command to download
183 them is:
184<command>git clone git://git.freedesktop.org/git/poppler/test testfiles</command>.
185 Then issue: <command>LC_ALL=en_US.UTF-8 make check</command>. It seems
186 that only the Qt4/5 libraries are tested.
187 </para>
188
189 <para>
190 Now, as the <systemitem class="username">root</systemitem> user:
191 </para>
192
193<screen role="root"><userinput>make install</userinput></screen>
194
195 <para>
196 To install the documentation, run the following commands as
197 <systemitem class="username">root</systemitem>:
198 </para>
199
200<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/poppler-&poppler-version; &amp;&amp;
201install -v -m644 README* /usr/share/doc/poppler-&poppler-version; &amp;&amp;
202cp -vr glib/reference/html /usr/share/doc/poppler-&poppler-version;</userinput></screen>
203
204<!-- ==== Poppler Data ====== -->
205 <bridgehead renderas="sect3">Poppler Data</bridgehead>
206
207 <para>
208 If you downloaded the additional encoding data package, install it by
209 issuing the following commands as the
210 <systemitem class="username">root</systemitem> user:
211 </para>
212
213<screen><userinput>tar -xf ../poppler-data-&poppler-data-version;.tar.gz &amp;&amp;
214cd poppler-data-&poppler-data-version;</userinput></screen>
215
216 <para>
217 Now, as the <systemitem class="username">root</systemitem> user:
218 </para>
219
220<screen role="root"><userinput>make prefix=/usr install</userinput></screen>
221
222 </sect2>
223
224 <sect2 role="commands">
225 <title>Command Explanations</title>
226
227 <para>
228 <parameter>--enable-build-type=release</parameter>: This switch is used
229 to apply a higher level of compiler optimizations. Other options are:
230 [<option>relwithdebinfo/debug/debugfull/profile</option>]
231 </para>
232
233 <para>
234 <parameter>--enable-cmyk</parameter>:
235 Include support for CMYK rasterization.
236 </para>
237
238 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
239 href="../../xincludes/static-libraries.xml"/>
240
241 <para>
242 <parameter>--enable-xpdf-headers</parameter>: Install some old
243 <application>Xpdf</application> headers required by certain programs (e.g.
244 <application>Okular</application>, <application>LibreOffice</application>
245 and <application>Inkscape</application>).
246 </para>
247
248 <para>
249 <parameter>--with-testdatadir=$PWD/testfiles</parameter>: Tell the test
250 programs where the auxiliary files are located.
251 </para>
252
253 <para>
254 <option>--enable-libcurl</option>: Use libcurl for HTTP support.
255 </para>
256
257 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
258 href="../../xincludes/gtk-doc-rebuild.xml"/>
259
260 <para>
261 <option>--disable-poppler-qt4</option>: Don't compile poppler Qt4 wrapper.
262 </para>
263
264 <para>
265 <option>--disable-poppler-qt5</option>: Don't compile poppler Qt5 wrapper.
266 </para>
267
268 <para>
269 <command>LC_ALL=en_US.UTF-8 make check</command>: Run the test suite.
270 The environment variable LC_ALL=en_US.UTF-8 is only needed if the
271 default locale does not include UTF-8.
272 </para>
273
274 </sect2>
275
276 <sect2 role="content">
277 <title>Contents</title>
278
279 <segmentedlist>
280 <segtitle>Installed Programs</segtitle>
281 <segtitle>Installed Libraries</segtitle>
282 <segtitle>Installed Directories</segtitle>
283
284 <seglistitem>
285 <seg>
286 pdfdetach, pdffonts, pdfimages, pdfinfo, pdfseparate, pdfsig,
287 pdftocairo, pdftohtml, pdftoppm, pdftops, pdftotext,
288 pdfunite, and poppler-glib-demo
289 </seg>
290 <seg>
291 libpoppler.so,
292 libpoppler-cpp.so,
293 libpoppler-glib.so,
294 libpoppler-qt4.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 <varlistentry id="libpoppler-qt4">
508 <term><filename class="libraryfile">libpoppler-qt4.so</filename></term>
509 <listitem>
510 <para>
511 is a wrapper library used to interface the PDF rendering functions
512 with <application>Qt</application>4.
513 </para>
514 <indexterm zone="poppler libpoppler-qt4">
515 <primary sortas="c-libpoppler-qt4">libpoppler-qt4.so</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519
520 <varlistentry id="libpoppler-qt5">
521 <term><filename class="libraryfile">libpoppler-qt5.so</filename></term>
522 <listitem>
523 <para>
524 is a wrapper library used to interface the PDF rendering functions
525 with <application>Qt</application>5.
526 </para>
527 <indexterm zone="poppler libpoppler-qt5">
528 <primary sortas="c-libpoppler-qt5">libpoppler-qt5.so</primary>
529 </indexterm>
530 </listitem>
531 </varlistentry>
532
533 </variablelist>
534
535 </sect2>
536
537</sect1>
Note: See TracBrowser for help on using the repository browser.