LaTeX zu PDF | Aspose.TeX für Java

So konvertieren Sie LaTeX in PDF

Werfen wir einen genaueren Blick auf den Java-Code, der die einfachste Möglichkeit zur Konvertierung von LaTeX in das PDF-Format bietet.

// Create conversion options for Object LaTeX format upon Object TeX engine extension.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
// Specify a file system working directory for the output.
options.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));
// Initialize the options for saving in PDF format.
options.setSaveOptions(new PdfSaveOptions());
// Run LaTeX to PDF conversion.
new TeXJob(Utils.getInputDirectory() +  "hello-world.ltx", new PdfDevice(), options).run();

Das erste, was wir also tun müssen (manchmal nicht das allererste, wie wir später herausfinden werden), ist, eine Instanz der Klasse TeXOptions zu erstellen. Die einzige statische Methode, die dies tut, ist consoleAppOptions(), also kümmern wir uns nicht um die Bedeutung ihres Namens. Die Methode benötigt eine Instanz der Klasse TeXConfig, die genau zum Konvertieren einer LaTeX-Datei geeignet ist. Diese Konfiguration weist die Object-TeX-Engine an, das Object-LaTeX-Format zu laden und bereit zu sein, die LaTeX-Datei zu akzeptieren. Das Objekt-LaTeX-Format ist genau das LaTeX-Format, mit der Ausnahme, dass es Objekt-TeX-spezifische Grundelemente verwendet, um die Seitenmetriken einzurichten.

Die erste der erforderlichen Optionen ist OutputWorkingDirectory, die den Raum oder Bereich definiert, in den die TeX-Ausgabe geschrieben wird. Hier finden Sie die Details zum Ausgabeverzeichniskonzept in Aspose.TeX für Java. In diesem Beispiel verwenden wir die Klasse OutputFileSystemDirectory, die es uns ermöglicht, die Ausgabe in das angegebene Verzeichnis oder den angegebenen Ordner zu schreiben.

Die zweite Option ist eine Klasseninstanz SaveOptions, die die Transformation des Objektmodells in das Zielformat steuert. Da wir LaTeX in PDF konvertieren, handelt es sich um die Klasseninstanz PdfSaveOptions.

Dann müssen wir eine Instanz der Klasse TeXJob erstellen. Wenn wir eine im Dateisystem gespeicherte LaTeX-Datei konvertieren möchten, verwenden wir diese Version des Konstruktors. Wir sollten den vollständigen Pfad zur Datei angeben. Andernfalls sucht die Engine im aktuellen Verzeichnis (das hier definiert ist) danach und wird es höchstwahrscheinlich nicht finden. Dennoch können wir die Erweiterung weglassen, wenn unsere Datei die Erweiterung .tex hat. Die Engine wird es automatisch anhängen. Das zweite Argument des Konstruktors ist eine Klasseninstanz Device. Da wir LaTeX in PDF konvertieren, handelt es sich um eine PdfDevice-Klasseninstanz. Als letztes Argument übergeben wir die kürzlich vorbereiteten Konvertierungsoptionen.

Jetzt müssen wir nur noch den Job ausführen.

Unabhängig davon, ob die Ausführung erfolgreich war oder nicht, ist das erste Ergebnis, das wir sehen, die Terminalausgabe. Im Erfolgsfall sieht es etwa so aus:

This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
entering extended mode

(<input_directory>\hello-world.ltx
LaTeX2e <2011/06/27>
(article.cls
Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
(size10.clo))
No file hello-world.aux.
[1]
(<output_directory>\hello-world.aux) )
Output written on hello-world.pdf (1 page).
Transcript written on hello-world.log.

Weitere Produkte des Motorlaufs finden wir in dem Ordner, den wir als Ausgabeverzeichnis angegeben haben. Dabei handelt es sich um die Transkriptdatei (.log) und, Voila!, die Hauptausgabe-PDF-Datei.

Eine alternative Möglichkeit, die Hauptausgabe-PDF-Datei zu schreiben

Es gibt einen weiteren Konstruktor der Klasse PdfDevice, mit dem wir die resultierende PDF-Datei auf alternative Weise erhalten können.

// Create the stream to write the PDF file to.
final OutputStream pdfStream = new FileOutputStream(Utils.getOutputDirectory() + "any-name.pdf");
try {
  // Create conversion options for Object LaTeX format upon Object TeX engine extension.
  ...
    // Run LaTeX to PDF conversion.
    new TeXJob(Utils.getInputDirectory() + "hello-world.ltx", new PdfDevice(pdfStream), options).run();
} finally {
  if (pdfStream != null)
    pdfStream.close();
}

Die Datei any-name.pdf im angegebenen Verzeichnis ist unsere Hauptausgabe-PDF-Datei. Gleichzeitig finden wir im Gegensatz zu Bildausgabe keine PDF-Dateien in dem durch die Konvertierungsoptionen definierten Ausgabeverzeichnis. Ausnahme: any-name.pdf befindet sich (durch seinen Pfad) im selben Dateisystemverzeichnis, das der Option OutputWorkingDirectory mit OutputFileSystemDirectory zugewiesen ist.

Über Eingabemöglichkeiten

Falls unsere Haupteingabedatei Abhängigkeiten erfordert, beispielsweise Pakete, die nicht im grundlegenden LaTeX-System und den unterstützten Paketen enthalten sind, MÜSSEN wir die Option RequiredInputDirectory auf die gleiche Weise festlegen, wie wir die Option OutputWorkingDirectory festlegen. Option und legen Sie die Abhängigkeiten in diesem Verzeichnis ab. Abhängigkeiten können beliebig in Unterverzeichnissen organisiert werden. Falls wir unsere eigenen Dateien in den Schriftsatzprozess einbeziehen möchten, beispielsweise externe Grafikdateien, MÜSSEN wir auch das InputWorkingDirectory festlegen, indem wir den Pfad zum Speicherort verwenden, an dem diese Dateien gesammelt werden. Wir können die Haupteingabedatei auch irgendwo im Eingabeverzeichnis platzieren und den relativen Pfad in der Methode „run()“ angeben (oder überhaupt keinen Pfad angeben, wenn sich die Haupteingabedatei im Stammverzeichnis befindet). Hier finden Sie die Details zum Eingabeverzeichniskonzept in Aspose.TeX für Java und den bereitgestellten Implementierungen.

Weitere TeX-Joboptionen werden hier besprochen.

Sie können sich auch die kostenlose LaTeX-zu-PDF-Konvertierung Web-App ansehen, die auf der API Aspose.TeX für .NET basiert. Hier ist die Java-Versionsseite.