Pacchetti in LaTeX esterni | Aspose.TeX per .NET

Pacchetti di LaTeX esterni

La libreria aspose.tex include un numero di pacchetti di LaTeX comuni. Quindi non devi preoccuparti di come fornire questi pacchetti al motore Tex della biblioteca. Ma a volte (o abbastanza spesso) il tuo file LaTeX può richiedere un pacchetto oltre il pacchetto “supportato in modo nativo” dei pacchetti. In tal caso, è possibile provare a fornire l’input richiesto, ovvero i file di origine del pacchetto richiesti, tramite l’opzione RebledInputDirectory dell’istanza di classe Texoptions. Vedremo come funziona con due esempi.

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}[t]
  y & = & x^2 \\
  a^2 + 2ab + b^2 & = & (a + b)^2 \\
  \int_0^\infty e^{-ax} dx & = & \frac{1}{a}
  \end{Beqnarray}
}
\end{document}

Nella terza riga, possiamo vedere che il file richiede il pacchetto FancyBox, che non è" nativo “supportato. Supponiamo anche che abbiamo il file di origine del pacchetto FancyBox. È un pacchetto semplice, quindi consiste davvero in un singolo file. Possiamo posizionare questo file ovunque nel nostro file system e specificare il percorso della directory come mostrato di seguito:

options.RequiredInputDirectory = new InputFileSystemDirectory("path-to-directory-where-fancybox.sty-located");

Dopo aver eseguito un lavoro Tex con questa opzione (non dimenticare di regolare le altre opzioni secondo necessità), otteniamo il documento di output (ovvero un’immagine PNG).

Ecco il codice sorgente completo per l’esempio:

// 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.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);
// Specify a file system working directory for the required input.
// The directory containing packages may be located anywhere.
options.RequiredInputDirectory = new InputFileSystemDirectory(Path.Combine(RunExamples.InputDirectory, "packages"));
// Initialize the options for saving in PNG format.
options.SaveOptions = new PngSaveOptions();
// Run LaTeX to PNG conversion.
new TeXJob(Path.Combine(RunExamples.InputDirectory, "required-input-fs.tex"), new ImageDevice(), options).Run();

Input richiesto archiviato (pacchetto pgfplots)

Diciamo 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, possiamo vedere 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. È un numero piuttosto elevato 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:

Ed è così che specifichiamo l’accesso a questi file di origine:

using (Stream zipStream = File.Open("path-to-zip-with-pgfplots-sources"), FileMode.Open))
{
    ...
    options.RequiredInputDirectory = new InputZipDirectory(zipStream);
    ...
}

Dopo aver eseguito un lavoro Tex con questa opzione, otteniamo il documento di output:

Ecco il codice sorgente completo per l’esempio:

// 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.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);
// Initialize the options for saving in PNG format.
options.SaveOptions = new PngSaveOptions();
// Create a file stream for the ZIP archive containing the required package.
// The ZIP archive may be located anywhere.
using (Stream zipStream = File.Open(Path.Combine(RunExamples.InputDirectory, "packages\\pgfplots.zip"), FileMode.Open))
{
    // Specify a ZIP working directory for the required input.
    options.RequiredInputDirectory = new InputZipDirectory(zipStream, "");
    
    // Run LaTeX to PNG conversion.
    new TeXJob(Path.Combine(RunExamples.InputDirectory, "required-input-zip.tex"), new ImageDevice(), options).Run();
}

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.

Impiegando pacchetti di caratteri esterni

Di norma, le distribuzioni in LaTeX forniscono una serie di caratteri predefiniti disponibili per la composizione. Tranne questi caratteri, Aspose.TeX include una serie di pacchetti di carattere non standard. Ad esempio, amsfonts, eurosym e wasysym. Come abbiamo visto sopra, Aspose.TeX consente anche di impiegare pacchetti esterni. Ma soprattutto stavamo parlando di pacchetti che non contengono caratteri. aspose.tex ’sObject texIl motore estensione ha bisogno di mappe dei caratteri (che sono file di testo in un determinato formato con l’estensione .map per convenzione) per determinare quali caratteri fisici corrispondono al nome del carattere interno di ciascun tex. Queste mappe dei caratteri devono essere caricate nella memoria di Tex durante la fase di inizializzazione. E, naturalmente, devono essere presenti tra i file del pacchetto che si sta collegando. Poiché il motore non conosce i nomi di tutte le mappe dei caratteri, cerca tutti i file con l’estensione .map. Pertanto, un’implementazione dell’interfaccia IinputWorkingDirectory che viene utilizzata come valore dell’opzione RecomeInputDirectory deve fornire un modo per accedere alle raccolte di nomi di file per estensione. Più specificamente, questa implementazione deve anche implementare l’interfaccia IFileCollector. Le implementazioni standard - InputFilesystemDirectory e inputZipDirectory - lo fanno già.

Di seguito, forniamo un esempio illustrativo di una directory di input richiesta personalizzata che implementa anche l’interfaccia IFileCollector. Mentre ci concentriamo sulla raccolta dei nomi dei file per estensione, omettiamo intenzionalmente i dettagli di archiviazione e recupero dei file.

// This is an implementation of IInputWorkingDirectory that is suitable for the TeX job's RequiredInputDirectory option
// in case required input contains fonts provided by external packages.
// The class additionally implements IFileCollector, which provides access to file collections by extension.
// This is necessary to load external font maps, which are files (outside TeX syntax) that map TeX's
// internal font names to file names of physical fonts.
public class RequiredInputDirectory : IInputWorkingDirectory, IFileCollector
{
    private Dictionary<string, Dictionary<string, string>> _fileNames =
        new Dictionary<string, Dictionary<string, string>>();

    public RequiredInputDirectory()
    {
    }

    // This method should preliminarily be called for each file entry that is supposed to be located inside
    // the required input directory. Inside is an example of how the dictionary of file names could be organized
    // for easy collection of file names by extension.
    // Here fileName is a full file name. This can be a file path on a file system, a URL, or whatever else (theoretically).
    public void StoreFileName(string fileName)
    {
        string extension = Path.GetExtension(fileName);
        string name = Path.GetFileNameWithoutExtension(fileName);
        
        Dictionary<string, string> files;
        if (!_fileNames.TryGetValue(extension, out files))
            _fileNames.Add(extension, files = new Dictionary<string, string>());

        files[name] = fileName;
    }

    // The IInputWorkingDirectory implementation.
    public NamedStream GetFile(string fileName, bool searchSubdirectories = false)
    {
        return new NamedStream(null, fileName); // Here we actually return a stream for the file requested by its name.
    }

    // Here is how we gather file collections by extension.
    public string[] GetFileNamesByExtension(string extension, string path = null)
    {
        Dictionary<string, string> files;
        if (!_fileNames.TryGetValue(extension, out files))
            return new string[0];

        return new List<string>(files.Values).ToArray();
    }

    public void Dispose()
    {
        _fileNames.Clear();
    }
}

Restrizioni

Può succedere che un pacchetto richiesto dal tuo file LaTeX sia sviluppato sotto il kernel LaTeX3e. Molto probabilmente tale pacchetto non funzionerà con la libreria aspose.tex poiché quest’ultima si basa sul kernelLaTeX2e.

Può anche succedere che un pacchetto richiesto dal file Latex chiama direttamente comandi primitivi dipendenti dal dispositivo che non sono supportati dal motoreoggettodella libreria*della libreria **. Tale pacchetto, sfortunatamente, non funzionerà sicuramente.