Внешние пакеты LaTeX | .СЕТЬ

Внешние пакеты LaTeX

Библиотека Aspose.TeX включает ряд общих пакетов LaTeX. Поэтому вам не придется беспокоиться о том, как предоставить эти пакеты движку TeX библиотеки. Но иногда (или довольно часто) вашему файлу LaTeX может потребоваться пакет, выходящий за рамки «изначально» поддерживаемого «пакета» пакетов. В этом случае вы можете попытаться предоставить требуемые входные данные, то есть исходные файлы требуемого пакета, с помощью опции RequiredInputDirectory экземпляра класса TeXOptions. Мы увидим, как это работает, на двух примерах.

Распакованный требуемый ввод (пакет «fancybox»)

Допустим, у нас есть следующий простой файл LaTeX, который называется required-input-fs.tex из нашего примера решения:

\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}

В третьей строке мы видим, что для файла требуется пакет «fancybox», который «изначально» не поддерживается. Предположим также, что у нас есть исходный файл пакета «fancybox». Это простой пакет, поэтому он фактически состоит из одного файла. Мы можем разместить этот файл в любом месте нашей файловой системы и указать путь к каталогу, как показано ниже:

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

После запуска задания TeX с этой опцией (не забудьте настроить другие параметры по мере необходимости) мы получим выходной документ (т. е. изображение PNG).

Вот полный исходный код примера:

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

Заархивированные необходимые данные (пакет pgfplots)

Предположим теперь, что у нас есть следующий также довольно простой файл LaTeX, который называется required-input-zip.tex из нашего примера решения:

\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}

В третьей строке мы видим, что для файла требуется пакет pgfplots, который также не поддерживается «изначально». Опять же, мы предполагаем, что у нас есть исходные файлы пакета pgfplots. Это довольно большое количество файлов, которые разделены между двумя местами, если вы найдете их в каталоге установки любого приложения для набора текста LaTeX. Вы можете найти папку pgfplots в папках \tex\generic и \tex\latex. И содержимое обеих этих папок должно быть предоставлено в качестве входных данных для библиотеки Aspose.TeX. Мы хотим, чтобы эти исходные файлы были упакованы в ZIP-архив, поэтому вот макет архива:

И вот как мы указываем доступ к этим исходным файлам:

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

После запуска задания TeX с этой опцией мы получим выходной документ:

Вот полный исходный код примера:

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

ПРИМЕЧАНИЕ: Результат был проверен с использованием пакета pgfplots версии 1.18.1. В то время как версия пакета pfg, включенного в библиотеку Aspose.TeX, - 3.1.9a.

Использование внешних пакетов шрифтов

Как правило, дистрибутивы LaTeX предоставляют набор шрифтов по умолчанию, доступных для верстки. Помимо этих шрифтов, Aspose.TeX включает в себя ряд нестандартных пакетов шрифтов. Например, «amsfonts», «eurosym» и «wasysym». Как мы видели выше, Aspose.TeX также позволяет использовать внешние пакеты. Но в основном мы говорили о пакетах, не содержащих шрифты. Расширению движка Object TeX Aspose.TeX требуются карты шрифтов (которые по соглашению представляют собой текстовые файлы определенного формата с расширением .map), чтобы определить, какие физические шрифты соответствуют внутреннему имени каждого шрифта TeX. . Эти карты шрифтов должны быть загружены в память TeX на этапе инициализации. И, конечно же, они должны присутствовать среди файлов подключаемого вами пакета. Поскольку движок не знает названия всех карт шрифтов, он ищет все файлы с расширением .map. Таким образом, реализация интерфейса IInputWorkingDirectory, который используется в качестве значения опции RequiredInputDirectory, должна предоставлять способ доступа к коллекциям имен файлов по расширению. Более конкретно, эта реализация также должна реализовывать интерфейс IFileCollector. Стандартные реализации — InputFileSystemDirectory и InputZipDirectory — уже это делают.

Ниже мы приводим наглядный пример пользовательского обязательного входного каталога, который также реализует интерфейс IFileCollector. Сосредотачиваясь на сборе имен файлов по расширению, мы намеренно опускаем детали хранения и поиска файлов.

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

Ограничения

Может случиться так, что пакет, необходимый для вашего файла LaTeX, разработан под ядром LaTeX3e. Такой пакет, скорее всего, не будет работать с библиотекой Aspose.TeX, поскольку последняя основана на ядре LaTeX2e.

Также может случиться так, что пакет, необходимый для вашего файла LaTeX, напрямую вызывает зависящие от устройства примитивные команды, которые не поддерживаются механизмом Object TeX библиотеки Aspose.TeX. Такой пакет, к сожалению, точно не подойдет.