source: general/graphlib/poppler.xml@ 2cd6717

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 2cd6717 was 2cd6717, checked in by Fernando de Oliveira <fernando@…>, 8 years ago
  • cmake-3.4.0: Minor re-reword of the tests explanations.
  • Update to nano-2.4.3.
  • Update to poppler-0.38.0. Good simplification of instructions.
  • Update to dbus-1.10.4.
  • Update to gtk+-3.18.5 (gtk+3.18.5).

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