Внешние пакеты LaTeX | Aspose.TeX для Питон

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

Библиотека Aspose.TeX поставляется с множеством общих пакетов LaTeX, поэтому нет необходимости вручную предоставлять эти пакеты движку TeX. Однако могут возникнуть ситуации, когда вашему файлу LaTeX потребуется пакет, который не включен в «набор» пакетов библиотеки. В таких случаях вы можете попробовать предоставить необходимые входные данные, например исходные файлы требуемого пакета, через опцию required_input_directory экземпляра класса 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.required_input_directory = InputFileSystemDirectory('path-to-directory-where-fancybox.sty-located')

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

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

# Create conversion options for Object LaTeX format upon Object TeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)
# Specify a file system working directory for the required input.
# The directory containing packages may be located anywhere.
options.required_input_directory = InputFileSystemDirectory(path.join(Util.input_directory, "packages"))
# Initialize the options for saving in PNG format.
options.save_options = PngSaveOptions()
# Run LaTeX to PNG conversion.
TeXJob(path.join(Util.input_directory, "required-input-fs.tex"), ImageDevice(True), 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-архив. Ниже желаемый макет архива:

А вот метод, которым мы определяем доступность к этим исходным файлам:

with open("path-to-zip-with-pgfplots-sources") as zipStream:
    ...
    options.required_input_directory = InputZipDirectory(zipStream)
    ...

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

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

# Create conversion options for Object LaTeX format upon Object TeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)
# Initialize the options for saving in PNG format.
options.save_options = PngSaveOptions()
# Create a file stream for the ZIP archive containing the required package.
# The ZIP archive may be located anywhere.
with open(path.join(Util.input_directory, "packages\\pgfplots.zip"), "rb") as zip_stream:
    # Specify a ZIP working directory for the required input.
    options.required_input_directory = InputZipDirectory(zip_stream, "")

    # Run LaTeX to PNG conversion.
    TeXJob(path.join(Util.input_directory, "required-input-zip.tex"), ImageDevice(True), options).run()

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

Ограничения

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

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