Pacchetti in LaTeX esterni | Java

Pacchetti di LaTeX esterni

Esiste un certo numero di pacchetti di LaTeX comuni inclusi nella libreria aspose.tex per java. Quindi non devi prenderti cura di come fornire questi pacchetti al motore Tex della biblioteca. Ma a volte (forse spesso) il tuo file in LaTeX può richiedere un pacchetto oltre il pacchetto “supportato in modo nativo” dei pacchetti. In questo caso, è possibile provare a fornire l’input richiesto, ovvero i file di origine del pacchetto richiesti, utilizzando il metodo setrequiredInputDirectory() dell’istanza di classe Texoptions. Vedremo come funziona con due esempi.

Impostare inputFile sul percorso completo del documento LaTeX corrispondente e outputDirectory su una cartella di output esistente. Entrambi gli esempi di conversione generano PNG a 150 DPI. Importare le classi Aspose.TeX utilizzate nell’esempio scelto, com.aspose.tex.rendering.ImageDevice, com.aspose.tex.rendering.PngSaveOptions e, per l’input ZIP, java.io.InputStream e java.nio.file.Files. Gestire o dichiarare le eccezioni nel metodo chiamante. Applicare una licenza secondo la guida alle licenze.

Input richiesto non pacchettato (pacchetto FancyBox)

Diciamo che abbiamo il seguente semplice file in LaTeX, che è richiesto-input-fs.tex dalla nostra soluzione di esempio:

\documentclass{article}
\usepackage[a6paper,landscape]{geometry}
\usepackage{fancybox}
\begin{document}
Test: \fbox{
  \begin{Bitemize}[b]
  \item First item
  \item A second one\\ on two lines
  \item(2pt) A third with extra space
  \end{Bitemize}
}
\par\bigskip
Test: \fbox{
  \begin{Beqnarray}
  y & = & x^2 \\
  a^2 + 2ab + b^2 & = & (a + b)^2 \\
  \int_0^\infty e^{-ax} dx & = & \frac{1}{a}
  \end{Beqnarray}
}
\end{document}

La terza riga richiede il pacchetto esterno fancybox. Impostare packagesDirectory su una cartella locale con fancybox.sty e le sue dipendenze. L’esempio completo seguente assegna questa cartella a RequiredInputDirectory e genera un’immagine PNG. Il dispositivo e le directory di lavoro rimangono aperti fino al termine del lavoro, quindi vengono rilasciati o chiusi.

Ecco il codice sorgente completo per l’esempio:

// Render the fancybox document using external package sources from a local folder.
// inputFile is the full TeX input path; packagesDirectory contains fancybox.sty.
// outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
InputFileSystemDirectory packages = new InputFileSystemDirectory(packagesDirectory);
options.setOutputWorkingDirectory(output);
options.setRequiredInputDirectory(packages);
PngSaveOptions saving = new PngSaveOptions();
saving.setResolution(150);
options.setSaveOptions(saving);
options.setInteraction(Interaction.NonstopMode);
options.setTerminalOut(new OutputMemoryTerminal());
ImageDevice device = new ImageDevice();
TeXJobResult result;
int pages;
try {
    result = new TeXJob(inputFile, device, options).run();
    pages = device.getPageCount();
} finally {
    device.dispose();
    output.close();
    packages.close();
}

Input richiesto archiviato (pacchetto pgfplots)

Supponiamo ora che abbiamo anche il seguente file in LaTeX abbastanza semplice, che è richiesto Input-Zip.tex dalla nostra soluzione di esempio:

\documentclass{article}
\usepackage[margin=0.25in]{geometry}
\usepackage{pgfplots}
\pgfplotsset{width=10cm,compat=1.18}
\begin{document}

First example is 2D and 3D math expressions plotted side-by-side.

%Here begins the 2D plot
\begin{tikzpicture}
\begin{axis}
\addplot[color=red]{exp(x)};
\end{axis}
\end{tikzpicture}
%Here ends the 2D plot
\hskip 5pt
%Here begins the 3D plot
\begin{tikzpicture}
\begin{axis}
\addplot3[
    surf,
]
{exp(-x^2-y^2)*x};
\end{axis}
\end{tikzpicture}
%Here ends the 3D plot

\end{document}

Nella terza riga, vediamo che il file richiede il pacchetto pgfplots, che non è anche" nativo “supportato. Ancora una volta, supponiamo che abbiamo i file di origine del pacchetto pgfplots. È una serie piuttosto ampia di file che sono divisi tra due posizioni se le si trovano nella directory di installazione di qualsiasi applicazione di composizione in LaTeX. Puoi trovare la cartella pgfplots nelle cartelle\tex\generic e \tex\latex. E il contenuto di entrambe queste cartelle deve essere fornito come input richiesto alla libreria ASPIPE.Tex. Vogliamo che questi file di origine siano confezionati in un archivio con zip, quindi ecco il layout dell’archivio:

Impostare packagesZip su un java.nio.file.Path all’archivio contenente i sorgenti generici e LaTeX del pacchetto. L’esempio Java completo seguente lo apre con Files.newInputStream(...) e assegna un InputZipDirectory a RequiredInputDirectory. L’argomento del percorso base vuoto seleziona l’intero archivio. Tenere aperti il flusso ZIP e la directory fino al termine del lavoro TeX, quindi chiuderli. Il risultato è un’immagine PNG con i due grafici.

Ecco il codice sorgente completo per l’esempio:

// Render the 2D/3D plots using pgfplots package sources from a ZIP archive.
// inputFile is the full TeX input path; packagesZip is a java.nio.file.Path.
// outputDirectory is an existing output folder; the ZIP includes generic and latex sources.
TeXJobResult result;
int pages;
try (InputStream zipStream = Files.newInputStream(packagesZip)) {
    TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
    OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
    InputZipDirectory packages = new InputZipDirectory(zipStream, "");
    options.setOutputWorkingDirectory(output);
    options.setRequiredInputDirectory(packages);
    PngSaveOptions saving = new PngSaveOptions();
    saving.setResolution(150);
    options.setSaveOptions(saving);
    options.setInteraction(Interaction.NonstopMode);
    options.setTerminalOut(new OutputMemoryTerminal());
    ImageDevice device = new ImageDevice();
    try {
        result = new TeXJob(inputFile, device, options).run();
        pages = device.getPageCount();
    } finally {
        device.dispose();
        output.close();
        packages.close();
    }
}

NOTA: Il risultato è stato verificato utilizzando il pacchetto pgfplots versione 1.18.1. Mentre la versione del pacchetto pfg inclusa nella libreria Aspose.TeX è la 3.1.9a.

Utilizzo di pacchetti di caratteri esterni

In genere, le distribuzioni in LaTeX sono dotate di una selezione di caratteri predefiniti che possono essere utilizzati per la composizione. Oltre a questi caratteri, Aspose.TeX offre diversi pacchetti di caratteri non standard, come amsfonts, eurosym e wasysym. Come accennato in precedenza, Aspose.TeX supporta anche l’uso di pacchetti esterni, sebbene la nostra attenzione sia stata principalmente su pacchetti che non includono caratteri.

L’estensione del motore Object TeX in Aspose.TeX richiede mappe di font, ovvero file di testo con estensione .map che specificano i font fisici corrispondenti al nome di ciascun font interno di TeX. Queste mappe di font devono essere caricate nella memoria di TeX durante la fase di inizializzazione e devono essere incluse nei file del pacchetto. Poiché il motore non conosce i nomi di tutte le mappe di font, cerca tutti i file con estensione .map. Pertanto, l’implementazione dell’interfaccia IInputWorkingDirectory utilizzata come valore dell’opzione RequiredInputDirectory deve fornire un modo per accedere a raccolte di nomi di file in base alla loro estensione. Nello specifico, questa implementazione deve implementare anche l’interfaccia IFileCollector. Le implementazioni standard, InputFileSystemDirectory e InputZipDirectory, soddisfano già questo requisito.

Il RequiredInputDirectory personalizzato seguente implementa entrambe le interfacce e legge file locali registrati esplicitamente. Salvarlo come RequiredInputDirectory.java con gli import inclusi. Registrare ogni file con storeFileName(...), assegnare l’istanza con options.setRequiredInputDirectory(...) e chiuderla dopo il lavoro. È un registro piatto: i nomi dei file devono essere univoci quando richiesti senza un percorso completo. Le estensioni vengono confrontate senza distinguere maiuscole e minuscole; il percorso di raccolta facoltativo seleziona una directory del file system. Registrare tutti i file necessari di pacchetti, mappe dei font, metriche e font fisici. La raccolta rende individuabili le mappe, ma non fornisce dati dei font mancanti.

import com.aspose.tex.IInputWorkingDirectory;
import com.aspose.tex.IFileCollector;
import com.aspose.tex.TeXInputStream;
import java.io.IOException;
import java.io.UncheckedIOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Locale;
import java.util.Set;

// Register local package files explicitly, including font maps and their dependencies.
// Save this class as RequiredInputDirectory.java and close it after the TeX job.
public class RequiredInputDirectory implements IInputWorkingDirectory, IFileCollector {
    private final Set<Path> files = new LinkedHashSet<Path>();
    private final List<TeXInputStream> streams = new ArrayList<TeXInputStream>();

    public void storeFileName(String fileName) {
        Path file = Paths.get(fileName).toAbsolutePath().normalize();
        if (!Files.isRegularFile(file)) {
            throw new IllegalArgumentException("Package file does not exist: " + file);
        }
        files.add(file);
    }

    @Override
    public TeXInputStream getFile(String fileName, boolean searchSubdirectories) {
        // This registry is a flat virtual directory; only registered files are accessible.
        for (Path file : files) {
            if (file.toString().equals(fileName) || file.getFileName().toString().equals(fileName)) {
                try {
                    TeXInputStream stream = new TeXInputStream(Files.newInputStream(file), file.toString());
                    streams.add(stream);
                    return stream;
                } catch (IOException exception) {
                    throw new UncheckedIOException(exception);
                }
            }
        }
        return new TeXInputStream(null, fileName);
    }

    @Override
    public String[] getFileNamesByExtension(String extension) {
        return getFileNamesByExtension(extension, null);
    }

    @Override
    public String[] getFileNamesByExtension(String extension, String path) {
        String requested = extension.toLowerCase(Locale.ROOT);
        if (!requested.isEmpty() && !requested.startsWith(".")) {
            requested = "." + requested;
        }
        Path directory = path == null ? null : Paths.get(path).toAbsolutePath().normalize();
        List<String> matches = new ArrayList<String>();
        for (Path file : files) {
            String name = file.getFileName().toString();
            int dot = name.lastIndexOf('.');
            String actual = dot < 0 ? "" : name.substring(dot).toLowerCase(Locale.ROOT);
            if (actual.equals(requested) && (directory == null || file.getParent().equals(directory))) {
                matches.add(file.toString());
            }
        }
        return matches.toArray(new String[0]);
    }

    @Override
    public void close() throws IOException {
        IOException failure = null;
        for (TeXInputStream stream : streams) {
            try {
                stream.close();
            } catch (IOException exception) {
                if (failure == null) { failure = exception; }
                else { failure.addSuppressed(exception); }
            }
        }
        streams.clear();
        files.clear();
        if (failure != null) { throw failure; }
    }
}

Restrizioni

Un pacchetto richiesto dal file LaTex può essere sviluppato sotto il kernel LaTeX3e. Molto probabilmente tale pacchetto non funzionerà con la libreria aspose.tex poiché quest’ultima si basa sul kernelLaTeX2e.

Inoltre, un pacchetto richiesto dal file Latex può chiamare direttamente comandi primitivi dipendenti dal dispositivo che non sono supportati dal motoreoggettodella libreria*della libreria **. Tale pacchetto, sfortunatamente, non funzionerà sicuramente.