Catatan: repositori ini disediakan apa adanya dan kodenya tidak dikembangkan secara aktif. Jika Anda ingin memperbaikinya, itu sangat dihargai: silakan lakukan perubahan dan kirimkan permintaan penarikan, saya dengan senang hati akan menggabungkannya atau membantu Anda menyelesaikannya. Namun, mohon jangan mengharapkan dukungan apa pun, termasuk penerapan permintaan atau perbaikan fitur. Jika Anda bukan seorang pengembang dan/atau ingin melakukan sesuatu yang kotor, alat ini mungkin bukan untuk Anda.
diff-pdf adalah alat untuk membandingkan dua PDF secara visual.
Dibutuhkan dua file PDF sebagai argumen. Secara default, keluarannya hanyalah kode pengembaliannya, yaitu 0 jika tidak ada perbedaan dan 1 jika kedua PDF berbeda. Jika diberi opsi --output-diff
, ini akan menghasilkan file PDF dengan perbedaan yang disorot secara visual:
$ diff-pdf --output-diff=diff.pdf a.pdf b.pdf
Pilihan lainnya adalah membandingkan kedua file secara visual dalam GUI sederhana, menggunakan argumen --view
:
$ diff-pdf --view a.pdf b.pdf
Ini akan membuka jendela yang memungkinkan Anda melihat halaman file dan memperbesar detailnya. Dimungkinkan juga untuk menggeser dua halaman secara relatif satu sama lain menggunakan panah Ctrl (panah Cmd di MacOS). Hal ini berguna untuk mengidentifikasi perbedaan terjemahan saja.
Lihat keluaran $ diff-pdf --help
untuk daftar opsi selengkapnya.
Versi alat yang telah dikompilasi untuk Windows tersedia sebagai bagian dari rilis terbaru sebagai arsip ZIP, yang berisi semua yang Anda perlukan untuk menjalankan diff-pdf. Ini akan berfungsi dari tempat mana pun Anda membongkarnya.
Alternatifnya, jika Anda menggunakan Chocolatey, Anda dapat menginstal diff-pdf di Windows dengan:
$ choco install diff-pdf
Di Mac, jika Anda menggunakan Homebrew, Anda dapat menggunakannya untuk menginstal diff-pdf dengannya:
$ brew install diff-pdf
Di Mac, jika Anda menggunakan Macports, Anda dapat menginstal diff-pdf dengan:
$ port install diff-pdf
Di Fedora dan CentOS 8:
$ sudo dnf install diff-pdf
Versi prakompilasi untuk openSUSE dapat diunduh dari layanan build openSUSE.
Sistem pembangunan menggunakan Automake sehingga diperlukan lingkungan Unix atau mirip Unix (Cygwin atau MSYS). Kompilasi dilakukan dengan cara biasa:
$ ./bootstrap
$ ./configure
$ make
$ make install
(Perhatikan bahwa langkah pertama, menjalankan skrip ./bootstrap
, hanya diperlukan ketika sumber bangunan diperiksa dari sistem kontrol versi, yaitu ketika file configure
dan Makefile.in
hilang.)
Sedangkan untuk dependensi, diff-pdf memerlukan pustaka berikut:
$ sudo yum groupinstall "Development Tools"
$ sudo yum install wxGTK wxGTK-devel poppler-glib poppler-glib-devel
$ sudo apt-get install make automake g++
$ sudo apt-get install libpoppler-glib-dev poppler-utils libwxgtk3.2-dev
$ sudo apt-get install make automake g++
$ sudo apt-get install libpoppler-glib-dev poppler-utils libwxgtk3.0-gtk3-dev
Instal Alat Baris Perintah untuk Xcode:
$ xcode-select --install
dan instal Homebrew atau MacPorts untuk mengelola dependensi, lalu:
$ brew install automake autoconf wxmac poppler cairo pkg-config
atau
$ sudo port install automake autoconf wxWidgets-3.0 poppler cairo pkgconfig
Perhatikan bahwa lebih banyak perpustakaan diperlukan di Windows, di mana tidak ada perpustakaan yang digunakan Kairo dan Poppler yang biasanya tersedia. Pada saat penulisan, sampul transitif dari dependensi di atas termasuk fontconfig, freetype, glib, libpng, pixman, gettext, libiconv, libjpeg dan zlib.
Pertama-tama, Anda memerlukan instalasi MinGW yang berfungsi dengan lingkungan MSYS2 dan kompiler C++. Instal MSYS2 dengan mengikuti instruksi mereka.
Setelah terinstal, luncurkan shell MSYS2 MinGW. Ini akan membuka jendela terminal; ketik cd /c/directory/with/diff-pdf
untuk membuka direktori dengan sumber diff-pdf.
Anda perlu menginstal komponen MSYS tambahan yang biasanya tidak disertakan dengan MSYS, menggunakan perintah berikut:
$ pacman -Syu
$ pacman -S automake autoconf pkg-config make zip pactoys
$ pacboy -S gcc:p poppler:p wxWidgets:p
Bangun diff-pdf dengan cara yang sama seperti instruksi untuk Unix di atas:
$ ./bootstrap # only if building from git repository
$ ./configure
$ make
Untuk membuat arsip ZIP, semua DLL akan dijalankan
$ make windows-dist
Di Unix, make install
biasa sudah cukup.
Di Windows, instalasi tidak diperlukan, cukup salin file di suatu tempat. Jika Anda membuatnya dengan mengikuti petunjuk di atas, semua file yang diperlukan akan ada di arsip ZIP yang dibuat.