forked from lbellonda/ConfrontaPDF
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
121 lines (95 loc) · 4.2 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
ConfrontaPDF
============
ConfrontaPDF compares two PDF files via GUI or command line.
ConfrontaPDF is based on DiffPDF. The open source DiffPDF was created and maintained by Mark
Summerfield 2008-2013. This is a fork of that project by Luca Bellonda, begun in 2015.
The source for the last release of Mark's open source version is available from:
http://www.qtrac.eu/diffpdf-foss.html. Mark's commercial versions are available from:
http://www.qtrac.eu/diffpdf.html
Command line:
ConfrontaPDF can compare two PDF files, writing the result to standard output,
an XML file and generate a PDF document with the differences between the
input documents. It is scriptable, and do not open windows or wait for
user input during the batch operation making it suitable for automated tests.
ConfrontaPDFc is a version of ConfrontaPDF that always runs in command line mode.
The result is printed on standard output.
-0 means that the PDF are identical
- any other code means a difference or an error
Output can be:
-Code only (default)
sample:
> confrontapdfc -b a.pdf b.pdf
> 0
-Code and description using --outType=1 switch
sample:
> confrontapdfc -b --outType=1 a.pdf b.pdf
> 0|no differences
An XML file with a detailed result can be written using --xmlResult=path
sample:
> confrontapdfc -b --xmlResult=result.xml a.pdf b.pdf
> 0
GUI:
By default the comparison is of the words on each pair of pages, but
comparing character by character is also supported (e.g., for
logographic languages). And there's also support for comparing the pages
by appearance (for example, if a diagram is changed or if a paragraph is
reformatted, or a font changed). It is also possible to compare
particular pages or page ranges. For example, if there are two versions
of a PDF file, one with pages 1-12 and the other with pages 1-13 because
of an extra page having been added as page 4, they can be compared by
specifying two page ranges, 1-12 for the first and 1-3, 5-13 for the
second. This will make ConfrontaPDF compare pages in the pairs (1, 1), (2,
2), (3, 3), (4, 5), (5, 6), and so on, to (12, 13).
A couple of example PDF files are in the data folder of the sources.
More information is available in the program's tooltips and About box.
Windows Users
=============
Use ConfrontaPDFc for command line only operations.
Compiling and Installing ConfrontaPDF
=====================================
Prerequisites:
- C++ compiler
- Qt 4 or Qt 5 libraries
- the Poppler libraries (at least 0.20.1)
Qt4 requires the Poppler's Qt 4 headers.
Qt5 requires the Poppler's Qt 5 headers.
Linux and BSD users should be able to get compiling from sources.
For other systems you'll need to get Qt and Poppler separately.
Download the sources from site: git clone https://github.com/lbellonda/ConfrontaPDF
or download a zip.
1. Change directory to ConfrontaPDF
$ cd ConfrontaPDF
2. Run lrelease;
$ lrelease confrontapdf.pro
3. Run qmake on confrontapdf;
$ qmake confrontapdf.pro
4. Run make
$ make
5. Run qmake on confrontapdfc
$ qmake confrontapdfc.pro
6. Run make
$ make
7. Copy or soft-link the confrontapdf and confrontapdfc executable to somewhere on your PATH
8. Only the executables are needed; all the files that were unpacked or
generated can be safely deleted.
Windows users can find an installer script to customize in the install folder.
Two helper files are provided for Windows and Unix-like systems:
- compile.sh
- compile.cmd
Running ConfrontaPDF
====================
If you hit a bug, please report it at
https://github.com/lbellonda/ConfrontaPDF/issues.
License
=======
This program was written by Luca Bellonda.
Copyright © 2015 Luca Bellonda. All rights reserved.
Based on DiffPfd by Mark Summerfield.
Copyright © 2008-13 Qtrac Ltd. All rights reserved.
This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 2 of the License, or (at your
option), any later version. This program is distributed in the hope that
it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License (in file gpl-2.0.txt) for more details.