LaTeX a PDF | Java

Come convertire il LaTeX in PDF

Diamo un’occhiata più da vicino al codice Java che fornisce il modo più semplice per convertire il LaTeX in formato PDF.

// 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();

Quindi, la prima cosa che dobbiamo fare (a volte non la prima, come scopriremo più avanti) è creare un’istanza della classe Texoptions. L’unico metodo statico che fa questo è ConsoleAppoptions(), quindi non ci preoccupiamo del significato del suo nome. Il metodo prende una istanza della classe TexConfig, che è esattamente adatta per la conversione di un file latex. Questa configurazione indica al motore Object Tex di caricare il formato Object Latex e di essere pronto ad accettare il file LaTeX. Il formato di LaTeX oggetto è solo il formato LaTeX, tranne per il fatto che utilizza le primitive specifiche Object Tex per impostare le metriche di pagina.

La prima delle opzioni richieste è OutputWorkingDirectory che definisce lo spazio o l’area, in cui verrà scritto l’output di Tex. Qui sono i dettagli sul concetto di directory di output in Aspose.TeX per java. In questo esempio, utilizziamo la classe OutputFilesystemDirectory, che ci consente di scrivere l’output nella directory o nella cartella specificata.

La seconda opzione è un’istanza di classe SaveOptions che controllerà la trasformazione del modello a oggetto al formato target. Dal momento che stiamo convertendo il LaTeX in PDF, è l’istanza di classe PDFSaveOptions.

Quindi dobbiamo creare un’istanza della classe Texjob. Volendo convertire un file LaTeX archiviato nel file system, utilizziamo questa versione del costruttore. Dovremmo specificare l’intero percorso del file. Altrimenti, il motore lo cercherà nella directory corrente (che è definita qui) e molto probabilmente non lo troverà. Tuttavia, possiamo omettere l’estensione se il nostro file ha quello .tex. Il motore lo aggiungerà automaticamente. Il secondo argomento del costruttore è un’istanza di classe dispositivo. Dal momento che stiamo convertendo il LaTeX in PDF, è un’istanza di classe PDFDEVICE. Come ultimo argomento, passiamo le opzioni di conversione recentemente preparate.

Tutto quello che dobbiamo fare ora è correre il lavoro.

Indipendentemente dal fatto che la corsa abbia avuto successo o meno, il primo risultato che vedremo sarà l’output del terminale. In caso di successo, assomiglia a questo:

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.

Troveremo altri prodotti dell’esecuzione del motore nella cartella che abbiamo specificato come directory di output. Quelli saranno il file trascrizione (.log) e, voilà!, il file PDF di output principale.

Un modo alternativo per scrivere il file PDF di output principale

C’è un altro costruttore della classe PDFDEVICE, che ci consente di ottenere il file PDF risultante in modo alternativo.

// 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();
}

Il file Any-name.pdf nella directory specificata sarà il nostro principale file PDF di output. Allo stesso tempo, a differenza di output di immagini, non troveremo alcun file PDF nella directory di output definita dalle opzioni di conversione. Eccezione: Any-name.pdf si trova (dal suo percorso) nella stessa directory del file system assegnato all’opzione outputworkingdirectory utilizzando outputfilesystemdirectory.

Sulle opzioni di input

Nel caso in cui il nostro file di input principale richieda dipendenze, ad esempio pacchetti, che non sono inclusi nel sistema di LaTeX di base e nei pacchetti supportati, dobbiamo impostare l’opzione richiesta inputdirectory nel modo simile che impostiamo l’opzione outputworkingdirectory e mettere le dipendenze in quella directory. Le dipendenze possono essere organizzate arbitrariamente nelle sottodirectory. Nel caso in cui abbiamo i nostri file da includere lungo il processo di composizione, ad esempio file di grafica esterna, dobbiamo anche impostare InputWorkingDirectory utilizzando il percorso per la posizione in cui tali file vengono raccolti. Potremmo anche posizionare il file di input principale da qualche parte all’interno della directory di input e specificare il percorso relativo nel metodo run() (o specificare alcun percorso se il file di input principale è nella radice). Qui sono i dettagli sul concetto di directory di input in Aspose.TeX per java e hanno fornito implementazioni.

Altre opzioni di lavoro di Tex sono discusse qui.

È inoltre possibile controllare la conversione gratuita di LaTeX-to-PDF app Web basata sulla base dell’API Aspose.TeX per .NET. Qui è la pagina della versione Java.