ubuntuusers.de

PDF Split and Merge

Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:


Du möchtest den Artikel für eine weitere Ubuntu-Version testen? Mitarbeit im Wiki ist immer willkommen! Dazu sind die Hinweise zum Testen von Artikeln zu beachten.

./pdfsam_logo.png PDF Split and Merge 🇬🇧 (oder PDFSam) ist ein in Java programmiertes plattformunabhängiges Programm und in zwei Varianten verfügbar. Die kostenlose Variante kann zum einen mehrere PDF-Dateien zu einer einzigen PDF-Datei zusammenfügen (mergen) und zum anderen eine PDF-Datei in mehrere einzelne aufteilen (splitten).

PDFSam ist in der Lage, PDF-Dateien zu sortieren (Plugin Visual Reorder) bzw. aus mehreren Dokumenten Seiten zu einer einzigen Datei zusammenzufügen und dabei die gewünschte Seitensortierung zu wählen (Plugin Visual composer). Beim Zusammenfügen werden die Lesezeichen der einzelnen PDF-Dateien übernommen.

Die kostenpflichtige Variante ist PDF Sam enhanced 🇬🇧. Die Unterschiede der beiden Varianten findet man auf dieser Seite 🇬🇧. Alternativ kann "PDF Sam enhanced" selbst aus dem Quelltext kompiliert werden. Dazu ist ein "Java Development Kit" (JDK) notwendig.

PDFSam ist unter den Bedingungen der GPL veröffentlicht, ist also samt Quelltext frei und kostenlos verfügbar. Auf der Webseite des Autors sind Programmversionen für Linux, Windows und Mac OS X erhältlich.

Voraussetzungen

Das Programm basiert auf Java. Wie man eine Laufzeitumgebung (JRE) installiert, ist im Artikel Java/Installation/OpenJDK beschrieben.

Installation

Die Programmversion 4.0.1 (Ubuntu 18.04) bzw. 4.0.4 (Ubuntu 20.04) ist in den offiziellen Paketquellen enthalten und wird mit dem folgenden Paket installiert [2]:

  • pdfsam (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install pdfsam 

Oder mit apturl installieren, Link: apt://pdfsam

Nach der Installation ist bei Ubuntu-Varianten mit einem Anwendungsmenü ein Eintrag unter "Büro → pdfsam" zu finden, unter KDE 4 liegt der Eintrag im K-Menü unter "Büroprogramme → pdfsam".

Manuell

Wer eine neuere Version (4.2.4) einsetzen möchte, kann sich ein fertiges Installationspaket vom Autor herunterladen http://www.pdfsam.org/download-pdfsam-basic/ und dieses mit gdebi installieren.

Nun kann PDFSam einfach mit dem Befehl:

pdfsam 

gestartet werden.

Enhanced Edition

Die Enhanced Edition ist nicht als fertiges Paket verfügbar. Um die erweiterten Funktionen der Enhanced Edition zu nutzen, ist es nötig, das Programm aus dem Quelltext selbst zu kompilieren. Dieser kann über die Downloadseite 🇬🇧 ⮷ oder alternativ bei SourceForge ⮷ heruntergeladen werden. Außerdem müssen noch die folgenden Pakete für eine erfolgreiche Kompilierung installiert sein:

  • openjdk-6-jdk (universe, das Java Development Kit (JDK) für Entwickler )

  • openjdk-6-source (universe, Java Quellcode)

  • openjdk-6-jre-lib (universe, plattformunabhängige Java-Bibliotheken)

  • ant (universe, plattformunabhängiges Build-Tool)

Befehl zum Installieren der Pakete:

sudo apt-get install openjdk-6-jdk openjdk-6-source openjdk-6-jre-lib ant 

Oder mit apturl installieren, Link: apt://openjdk-6-jdk,openjdk-6-source,openjdk-6-jre-lib,ant

Experten-Info:

Es ist gut möglich, dass man statt OpenJDK 6 auch OpenJDK 7 oder die JDKs von Oracle Java nutzen kann. Aber bitte nicht OpenJDK 7 mit einer Java-Laufzeitumgebung (JRE) verwechseln. Es wird zwingend die Entwicklerversion (JDK) benötigt.

Nach der Installation dieser Pakete kann das Programm kompiliert werden. Zuerst wird die Datei pdfsam-<CURRENT_VERSION>-out-src.zip in ein beliebiges Verzeichnis entpackt [4], z.B. den persönlichen Ordner. Nun wechselt man in dieses Verzeichnis. Dort befinden sich nun verschiedene .zip-Dateien, welche alle in dieses Verzeichnis entpackt [4] werden müssen.

Hinweis!

Fremdsoftware kann das System gefährden.

Die Datei ~/pdfsam-<CURRENT_VERSION>-out-src/pdfsam-maine/ant/build.properties wird mit einem Editor geöffnet [3], um die Pfade anzupassen. Hier ein Beispiel:

#deploy target destination dir (if you want to deploy)
pdfsam.deploy.dir=../build/pdfsam-basic

#root dir where every src directory is located
workspace.dir=../

#where classes will be compiled, jars distributed, javadocs created and release created
build.dir=../build

#version to build
pdfsam.version=enhanced

#libraries
itext.jar.name=iText-2.0.7
log4j.jar.name=log4j-1.2.15
dom4j.jar.name=dom4j-1.6.1
jaxen.jar.name=jaxen-1.1
bcmail.jar.name=bcmail-jdk14-138
bcprov.jar.name=bcprov-jdk14-138
looks.jar.name=looks-2.1.4
jcmdline.jar.name=pdfsam-jcmdline-1.0.3
emp4j.jar.name=emp4j-1.0.0
pdfsam-console.jar.name=pdfsam-console-1.1.4e
pdfsam-split.jar.name=pdfsam-split-0.4.5
pdfsam-merge.jar.name=pdfsam-merge-0.6.4
pdfsam-cover.jar.name=pdfsam-cover-0.2.4e
pdfsam-encrypt.jar.name=pdfsam-encrypt-0.2.4e
pdfsam-mix.jar.name=pdfsam-mix-0.1.3e
pdfsam-unpack.jar.name=pdfsam-unpack-0.0.3e
pdfsam-langpack.jar.name=pdfsam-langpack

Nun kann das Programm kompiliert werden, und man sollte es ohne Probleme starten können.

#Kompilieren
cd ~/pdfsam-<CURRENT_VERSION>-out-src/pdfsam-maine/ant/
ant
#In das Programmverzeichnis wechseln
cd ~/pdfsam-<CURRENT_VERSION>-out-src/build/pdfsam-maine/release/dist/pdfsam-enhanced
#Ausführen
java -jar pdfsam-<CURRENT_VERSION>.jar 

Ab hier kann man die im Abschnitt Installation beschriebenen Schritte durchführen, um den Programmstart zu erleichtern.

Konfiguration

Der Start erfolgt – wie bei Java-Programmen üblich – über den Befehl:

java -jar /PFAD/ZUR/pdfsam-VERSION.jar 

Deutsche Sprache

Beim ersten Aufruf startet PDFsam in englischer Sprache. Um die deutsche Sprache einzustellen, wählt man den Reiter "Settings". Dort wählt man die Sprache German, speichert ab mit einem Klick auf "Save" und schließt das Programm. Beim nächsten Start von PDFsam sind die Menüs und Schaltflächen-Beschriftungen auf Deutsch.

Die Konfigurationsdaten werden im Ordner ~/.pdfsam/ im Homeverzeichnis gespeichert.

Benutzung

PDF-Dateien zusammenfügen

./PDFsam.png
PDFsam 2.2.0

Um mehrere PDF-Dateien zusammen zu fügen, muss man den Reiter "Zusammenführen" (Merge) aktivieren und die "Hinzufügen"-Taste betätigen. Es erscheint ein Menü, in dem man die zu vereinenden PDF-Dateien auswählt. Diese erscheinen nun im Menü wieder. Nun den Ausgabepfad und die Ausgabedatei angeben, dies geschieht mit der "Durchsuchen"-Taste. Mit der "Starten"-Taste wird nun der Prozess gestartet.

Unten im Statusfeld wird man über den Fortschritt der Aktion informiert. Hat alles geklappt, erscheint in der letzten Zeile die Meldung

Total processed pages

gefolgt von der Seitenzahl des Ausgabedokuments. Fehlermeldungen färbt PDFsam rot ein, so dass man auf den ersten Blick sehen kann, ob etwas schiefgegangen ist. Das passiert beispielsweise, wenn man versehentlich eine Datei in einem anderen Format als PDF auswählt.

PDF-Dateien aufteilen

PDFSam kann auch ein einzelnes PDF-Dokument mit zwei oder mehr Seiten aufteilen und so z.B. aus einem fünfseitigem Dokument fünf einzelne PDF-Dateien erstellen.

Auf den Reiter "Teilen" (Split) wechseln und das PDF auswählen, das geteilt werden soll. Dazu die Taste "Durchsuchen" wählen. Ist das geschehen, sieht man weiter unten im Menü die Optionen zur Aufteilung:

  • "in Einzelseiten zerlegen" (Burst) - erzeugt aus jeder Seite des Dokuments eine eigene Datei

  • "Zerteile nach je "n" Seiten" - mit dieser Option erhält man Dateien mit einer frei wählbaren Seitenzahl

  • "Zerteile nach geraden Seiten" - man erhält für jede Seite mit gerader Seitenzahl ein neues Dokument

  • "Zerteile nach ungeraden Seiten" - man erhält für jede Seite mit ungerader Seitenzahl ein neues Dokument.

Unter der Option "Ausgabeordner" gibt man entweder das Originalverzeichnis der Quelldatei ein, oder man setzt einen Haken bei "Bitte Wählen" - So kann man einen anderen Ausgabeordner wählen. Die Bezeichnungen der Ausgabedateien beginnen mit einer Zahl, gefolgt von der unter "Präfix der Ausgabedateien" eingestellten Zeichenkette und dem Namen der Originaldatei.

Benutzung der Kommandozeilenversion

Mit Hilfe des Programms "pdfsam-console" lassen sich alle Aufgaben in der Kommandozeile bewerkstelligen. Eine manpage wird nicht angeboten. Die Hilfe lässt sich so aufrufen:

pdfsam-console -help 

PDF-Dateien splitten

Zerlegt die Datei "x.pdf" alle 6 Seiten:

pdfsam-console -f x.pdf -o . -s NSPLIT -n 6 split 

PDF-Dateien zusammenfügen

Zum Zusammenfügen der Dateien "1.pdf" und "2.pdf" zu "12.pdf" muss folgender Befehl verwendet werden:

pdfsam-console -f 1.pdf -f 2.pdf -o ./12.pdf concat 

Zum Zusammenfügen der pdf-Dateien im Ordner "pdfs" in alphabetischer Reihenfolge zu "zusammen.pdf" ist folgender Befehl zu benutzen:

pdfsam-console -d ./pdfs -o ./zusammen.pdf concat 

Optionen zum Zusammenfügen lassen sich auf der Hilfeseite nachlesen:

pdfsam-console -h concat 

Problembehebung

Mit bestimmter Java-Version starten

Unabhängig von der systemweit eingerichteten Java-Version ist es in bestimmten Situationen erforderlich, PDFSam explizit mit einer anderen Java-Version zu starten. Ein Beispiel für OpenJDK 8 und Ubuntu 16.04:

  • 32-Bit:

    /usr/lib/jvm/java-8-openjdk-i386/jre/bin/java -jar /PFAD/ZU/pdfsam/pdfsam-VERSION.jar 
  • 64-Bit:

    /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java -jar /PFAD/ZU/pdfsam/pdfsam-VERSION.jar 

Version 4.x

Diese Version setzt zwingend Java 11 oder neuer und JavaFX voraus. Während von Problemen in Kombination mit OpenJDK berichtet wurde, war der Einsatz unter Oracle Java ohne Fehler möglich.

PDFSam startet nicht

Wenn PDFSam nur den Start-Dialog anzeigt, danach aber abbricht, kann man PDFSam über die Console starten, um die Fehlerursache zu ermitteln; dazu im Terminal den Befehl pdfsam ausführen. Wenn dann die folgende Meldung ausgegeben wird, hat man evtl. die falsche Java-Version installiert/verwendet.

~$ pdfsam
Graphics Device initialization failed for :  es2, sw
Error initializing QuantumRenderer: no suitable pipeline found
java.lang.RuntimeException: java.lang.RuntimeException: Error initializing QuantumRenderer: no suitable pipeline found
	at com.sun.javafx.tk.quantum.QuantumRenderer.getInstance(QuantumRenderer.java:280)
	at com.sun.javafx.tk.quantum.QuantumToolkit.init(QuantumToolkit.java:222)
	at com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:260)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:267)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:158)
	at com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:658)
	at com.sun.javafx.application.LauncherImpl.launchApplication1(LauncherImpl.java:678)
	at com.sun.javafx.application.LauncherImpl.lambda$launchApplication$2(LauncherImpl.java:195)
	at java.base/java.lang.Thread.run(Thread.java:834)
Caused by: java.lang.RuntimeException: Error initializing QuantumRenderer: no suitable pipeline found
	at com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.init(QuantumRenderer.java:94)
	at com.sun.javafx.tk.quantum.QuantumRenderer$PipelineRunnable.run(QuantumRenderer.java:124)
	... 1 more
Exception in thread "main" java.lang.RuntimeException: No toolkit found
	at com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:272)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:267)
	at com.sun.javafx.application.PlatformImpl.startup(PlatformImpl.java:158)
	at com.sun.javafx.application.LauncherImpl.startToolkit(LauncherImpl.java:658)
	at com.sun.javafx.application.LauncherImpl.launchApplication1(LauncherImpl.java:678)
	at com.sun.javafx.application.LauncherImpl.lambda$launchApplication$2(LauncherImpl.java:195)
	at java.base/java.lang.Thread.run(Thread.java:834) 

Der obige Fehler tritt z. B. auf Ubuntu 20.04 mit PDFSam 4.0.4 in Verbindung mit dem Oracle-JDK 11.0.12 auf. Mit OpenJDK 11.0.18 startet PDFSam hingegen ohne Fehler.

Ad-hoc-Behebung

Man kann PDFSam aus dem Terminal starten, indem man die richtige Java-Version angibt:

JAVACMD=/usr/lib/jvm/jdk-11.0.12/bin/java pdfsam 

Der Pfad zu java muss ggf. an die Gegegebenheiten auf dem eigenen Rechner angepasst werden.

Dauerhafte Lösung

Als dauerhafte Lösung kann man die global verwendete Java-Version ändern. Dies kann über das Alternativen-System erledigt werden:

sudo update-alternatives --config java 

Diese Revision wurde am 11. März 2023 18:02 von hottbox erstellt.
Die folgenden Schlagworte wurden dem Artikel zugewiesen: Multimedia, Büro, PDF, Java