Зовнішні пакети LaTeX | Python через .NET

Зовнішні пакети LaTeX

Бібліотека Aspose.TeX постачається з різними поширеними пакетами LaTeX, тому немає необхідності вручну надавати ці пакети механізму TeX. Однак можуть виникнути ситуації, коли для вашого файлу LaTeX потрібен пакунок, який не входить до «набору» пакунків бібліотеки. У таких випадках ви можете спробувати надати необхідні вхідні дані, такі як вихідні файли необхідного пакунка, за допомогою параметра required_input_directory екземпляра класу TeXOptions. Ми розглянемо, як це працює, на двох прикладах.

Спочатку застосуйте ліцензію. Укажіть у ASPOSE_TEX_INPUT_DIR папку, що містить ExternalLaTeXPackages із двома файлами .tex та підкаталогом packages (типово: input). Задайте папку виведення в ASPOSE_TEX_OUTPUT_DIR (типово: output).

Необхідні вхідні дані надаються в розпакованому вигляді (пакет 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. Оскільки це простий пакет, що складається з одного файлу, ми можемо розмістити цей файл у будь-якому місці нашої файлової системи та вказати шлях до каталогу наступним чином:

from aspose.tex.io import InputFileSystemDirectory

# Configure an existing TeXOptions instance.
options.required_input_directory = InputFileSystemDirectory('path-to-directory-where-fancybox.sty-located')

Після того, як ми запустимо завдання TeX із цією опцією (не забудьте налаштувати інші опції за потреби), ми отримаємо вихідний документ, який у цьому випадку є зображенням у форматі PNG.

Ось повний вихідний код прикладу:

# Load an external LaTeX package from a directory.
import os
from pathlib import Path
from os import path
from io import BytesIO
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, InputZipDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, PngSaveOptions

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)
input_dir = Path(os.environ.get("ASPOSE_TEX_INPUT_DIR", "input")).resolve() / "ExternalLaTeXPackages"
# Create conversion options for Object LaTeX format upon Object TeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
# 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(str(input_dir), "packages"))
# Initialize the options for saving in PNG format.
options.save_options = PngSaveOptions()
# Run LaTeX to PNG conversion.
TeXJob(path.join(str(input_dir), "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-архів. Нижче наведено бажаний макет архіву:

А ось метод, за допомогою якого ми визначаємо доступність цих вихідних файлів:

from aspose.tex.io import InputZipDirectory

# Configure an existing TeXOptions instance and run the job while the stream is open.
with open("path-to-zip-with-pgfplots-sources", "rb") as zip_stream:
    options.required_input_directory = InputZipDirectory(zip_stream, "")
    # Run TeXJob here, as shown in the complete example below.

Після виконання завдання TeX із цією опцією ми отримуємо вихідний документ:

Ось повний вихідний код прикладу:

# Load external LaTeX packages from a ZIP archive.
import os
from pathlib import Path
from os import path
from io import BytesIO
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, InputZipDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, PngSaveOptions

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)
input_dir = Path(os.environ.get("ASPOSE_TEX_INPUT_DIR", "input")).resolve() / "ExternalLaTeXPackages"
# Create conversion options for Object LaTeX format upon Object TeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
# 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(str(input_dir), "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(str(input_dir), "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. У таких випадках пакет не працюватиме з бібліотекою.