Riparazione del file in LaTeX | Java

Come controllare e riparare un file in LaTeX

Se non sei sicuro che un file di testo sia un file in LaTeX e desideri che sia composto, è possibile utilizzare la funzione di controllo e riparazione del LaTeX offerto dall’API Aspose.TeX per Java. Nell’esempio seguente, controlleremo e riparare un file di esempio, Invalid-latex.tex, da Aspose.TeX per il progetto di esempio Java.

Per cominciare, è importante notare che il file di esempio sembra impiegare la sintassi di Tex ma manca della struttura richiesta dal LaTeX. Come forse saprai, un file in LaTeX deve includere un preambolo che inizia con il comando \documentclass, nonché un corpo racchiuso nell’ambiente del documento, in particolare tra \begin{document} e \end{document}.

Impostare inputFile sul percorso completo di invalid-latex.tex, outputDirectory su una cartella di output esistente e packagesDirectory su una cartella contenente fancyhdr.sty e le sue dipendenze. Salvare il callback seguente come PackageGuesser.java con il relativo import e creare PackageGuesser packageGuesser = new PackageGuesser() prima della riparazione. Importare le classi Aspose.TeX utilizzate e gestire o dichiarare le eccezioni. Applicare una licenza secondo la guida alle licenze. Le directory rimangono aperte fino al termine della riparazione e vengono poi chiuse.

// Repair the LaTeX structure and infer packages for undefined commands.
// inputFile is the full invalid LaTeX path; packagesDirectory contains fancyhdr.sty.
// outputDirectory is an existing output folder; packageGuesser is a PackageGuesser instance.
LaTeXRepairerOptions options = new LaTeXRepairerOptions();
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
InputFileSystemDirectory packages = new InputFileSystemDirectory(packagesDirectory);
options.setOutputWorkingDirectory(output);
options.setRequiredInputDirectory(packages);
options.setGuessPackageCallback(packageGuesser);
TeXJobResult result;
try {
    result = new LaTeXRepairer(inputFile, options).run();
} finally {
    output.close();
    packages.close();
}

Simile a un normale lavoro Tex, iniziamo creando un oggetto che contiene le opzioni per il processo che stiamo per eseguire. La maggior parte di queste opzioni sono le stesse di quelle per un normale lavoro Tex. In effetti, chiamando il metodo setInputWorkingDirectory(), specifichiamo lo spazio da cui dovrebbero essere letti i file di input. Tuttavia, in questo esempio, non lo utilizziamo qui perché forniamo il percorso completo al file di input principale nel file system e nessun file personalizzato deve essere incluso nel file di input principale. Successivamente, chiamiamo il metodo SetOutputWorkingDirectory() per specificare lo spazio in cui i file di output devono essere scritti. Se chiamato, il metodo setreQueratoInputDirectory() fa indicare le opzioni allo spazio in cui è possibile archiviare pacchetti in LaTeX che non sono incorporati nella libreria Aspose.TeX. Infine, il metodo setGessPackAgeCallback() sarà discusso in seguito.

Una volta assegnate le opzioni, possiamo procedere con l’esecuzione del processo.

Allora, com’è il processo di controllo e riparazione? Inizia con l’API alla ricerca di un evento \documentclass nel file di input. Se non viene trovato, l’API presuppone che \documentclass{article} debba essere inserito all’inizio del file. Queste informazioni sono registrate nel file del rapporto di riparazione (.log).

Successivamente, il processo inizia a scansionare il file di input regolato dall’inizio. Il motore Tex dotato del formato in LaTeX può, ad un certo punto, lanciare un errore indicando che \begin{document} non è stato ancora trovato quando avrebbe già dovuto. In questo modo, la posizione in cui \begin{document} deve essere inserita viene definita e riflessa nel rapporto.

Durante la scansione ulteriormente il file, il motore può presentarsi in comandi o ambienti indefiniti. In tali casi, l’API può fare ipotesi su pacchetti richiesti incorporati (quelli che definiscono i comandi e gli ambienti che non sono definiti fino a quando questi pacchetti non sono inclusi) per alcuni dei comandi e ambienti più comuni. Tuttavia, è possibile fare tali ipotesi esternamente da una classe che implementa l’interfaccia IGUesspackageCallback. Una volta sviluppata una tale classe, un’istanza di essa dovrebbe essere passata al processo chiamando il metodo `setGessPackAgeCallback().

Questo esempio associa il comando \lhead al pacchetto fancyhdr. Il callback riceve il nome senza la barra inversa iniziale e restituisce una stringa vuota per comandi e ambienti sconosciuti:

import com.aspose.tex.features.IGuessPackageCallback;

// Save as PackageGuesser.java and assign an instance with setGuessPackageCallback().
public class PackageGuesser implements IGuessPackageCallback {
    @Override
    public String guessPackage(String commandName, boolean isEnvironment) {
        // The command name has no leading backslash.
        if (!isEnvironment && "lhead".equals(commandName)) {
            return "fancyhdr";
        }
        // Empty means that this callback cannot identify a package.
        return "";
    }
}

Per quanto riguarda il file di esempio, il motore incontra innanzitutto il comando \chapter, che non è definito nella classe documento article, ma è definito nella classe documento book. L’API modifica la classe documento in modo che la versione finale del file riparato inizi con \documentclass{book}. Quindi, il motore trova il comando \lhead sopra menzionato e determina che \usepackage{fancyhdr} deve essere inserito nel preambolo. I comandi \href e \includegraphics presenti più avanti nel file fanno sì che il Repairer inserisca rispettivamente \usepackage{hyperref} e \usepackage{graphicx} nel preambolo. Queste decisioni vengono prese in base alle mappature interne dell’API. Come in precedenza, tutte queste riparazioni vengono registrate nel file di report.

Infine, il motore termina in modo anomalo perché manca la corretta conclusione di un documento in LaTeX. Di conseguenza, il riparatore aggiunge \end{document} alla fine del file e include queste informazioni nel rapporto.

Dopo la riparazione, il Repairer esegue un processo TeX per la verifica finale. In questo esempio il rapporto finale non contiene errori critici. Il valore restituito da run() può riferirsi alla scansione iniziale; controllare il rapporto e il file .tex corretto. La riparazione non fornisce le risorse esterne mancanti. Ad esempio, il file di esempio fa riferimento a Figures/uet_logo.pdf, che deve essere fornito separatamente per completare la composizione.

Ecco il rapporto completo:

Tentativo di riparazione del file originale...
--------------------------------------------------------------------------------
\documentclass manca nel file originale. Inserito all'inizio.
\begin{document} manca nel file originale. Inserito alla riga 3, posizione 0.
Il comando \chapter alla riga 3, posizione 0, non è definito. Si consiglia di utilizzare \usepackage{package_name} nel preambolo,
dove 'package_name' è il nome del pacchetto che definisce questo comando.
Il comando \lhead alla riga 5, posizione 0, non è definito. \usepackage{fancyhdr} è inserito nel preambolo
poiché il pacchetto 'fancyhdr' presumibilmente definisce il comando.
Il comando \href alla riga 8, posizione 0, non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando. Il comando \href alla riga 17, pos. 0 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
Il comando \href alla riga 20, pos. 0 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
Il comando \href alla riga 27, pos. 0 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
Il comando \href alla riga 32, pos. 0 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
Il comando \includegraphics alla riga 54, pos. 2 non è definito. \usepackage{graphicx} è inserito nel preambolo
poiché il pacchetto 'graphicx' presumibilmente definisce il comando.
Il comando \href alla riga 67, pos. 0 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
Il comando \href alla riga 95, pos. 57 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
Il comando \href alla riga 96, pos. 0 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
Il comando \href alla riga 98, pos. 100 non è definito. \usepackage{hyperref} è inserito nel preambolo
poiché il pacchetto 'hyperref' presumibilmente definisce il comando.
\end{document} manca nel file originale. Inserito alla fine.

Controllo del file riparato...
--------------------------------------------------------------------------------
Non ci sono errori critici nel file riparato.

Puoi anche verificare la nostra app Web gratuita ** AI Latex Repair **, che è costruita in base alla funzionalità implementata nell’interfaccia Aspose.TeX per .NET API e comporta un’implementazione più avanzata dell’interfaccia IguesspackageCallback.