AsposeTeXforPython – Часто задаваемые вопросы

В: Что такое AsposeTeXforPython?

О: AsposeTeXforPython — это API на чистом Python (построенный на основе библиотеки AsposeTeX .NET через pythonnet), который визуализирует и преобразует документы LaTeX/TeX в PDF, XPS, SVG, PNG, JPEG, BMP, TIFF и другие форматы изображений, не требуя какого-либо внешнего распространения TeX. Он работает внутри процесса и подходит для веб-служб, настольных приложений и автоматических генераторов отчетов.

В: Как установить AsposeTeXforPython?

О: Запустите pip install aspose-tex-python-net. Пакет автоматически объединяет необходимую среду выполнения Python. Установите его в любой виртуальной среде (Windows, Linux, macOS) с Python3.8 или более поздней версии. Проверьте установку с помощью:

import aspose.tex as tex
print(tex.__version__)

В: Нужен ли мне локальный дистрибутив TeX (MiKTeX, TeXLive и т. д.)?

О: Нет. Вся логика синтаксического анализа и рендеринга встроена в AsposeTeX, поэтому вам никогда не понадобится внешний движок TeX. Библиотека включает в себя более 300 основных пакетов LaTeX и файлы общих классов.

В: Как преобразовать файл .tex в PDF с помощью нескольких строк кода?

О: Создайте TeXJob с конфигурацией Object LaTeX, PdfSaveOptions и PdfDevice. Укажите путь к файлу LaTeX в ASPOSE_TEX_INPUT_FILE, а выходной каталог — в ASPOSE_TEX_OUTPUT_DIR, либо измените пути в примере. По умолчанию используются hello-world.ltx и output. Предварительно примените лицензию. Дополнительные входные файлы ищутся рядом с основным документом; обработка выполняется без интерактивного ввода. Лицензирование

# Convert LaTeX to PDF.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.pdf import PdfDevice, PdfSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
options.save_options = PdfSaveOptions()
device = PdfDevice()
job_result = TeXJob(str(input_file), device, options).run()

Имя результата соответствует входному файлу: из hello-world.ltx получается hello-world.pdf. LaTeX → PDF

В: Какие форматы вывода может генерировать AsposeTeXforPython?

О: PDF, XPS, SVG, PNG, JPEG, BMP и TIFF. Каждым форматом можно управлять с помощью определенных объектов SaveOptions (например, PdfSaveOptions, PngSaveOptions, SvgSaveOptions).

В: Как встроить собственные шрифты в созданный PDF-файл?

О: Шрифты выбираются в документе TeX или LaTeX и его пакетах. О ресурсах пакетов см. Внешние пакеты LaTeX. Свойство subset_fonts класса PdfSaveOptions определяет, следует ли встраивать только используемые глифы; оно не выбирает пользовательский шрифт. Полный пример XPS с этой же настройкой приведён в разделе Подмножества шрифтов.

В: Какие пакеты и классы LaTeX поддерживаются «из коробки»?

О: Библиотека включает распространённые пакеты и классы LaTeX. Их состав указан в списке встроенных пакетов. В примере внешних пакетов исходные файлы pgfplots передаются через required_input_directory.

В: Как я могу использовать сторонний файл .sty или файл класса, который не является встроенным?

A: Задайте для TeXOptions.required_input_directory объект InputFileSystemDirectory, указывающий на файлы нужного пакета. Полный пример загружает fancybox.sty из ExternalLaTeXPackages/packages и преобразует required-input-fs.tex в PNG. О ZIP-архивах и ограничениях совместимости см. Внешние пакеты LaTeX.

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

# 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()

В: Каковы основные ограничения движка?

О:

Ограничение	Подробности
Экранирование оболочки (\write18)	Отключено в целях безопасности.
Полная экстернализация TikZ	Не поддерживается; большинство графических объектов TikZ визуализируются в процессе, но очень сложные рисунки могут давать сбои.
Охват шрифтов Unicode	Полностью поддерживаются только шрифты TrueType/OpenType с полным набором глифов; устаревшие шрифты Type1 могут потребовать преобразования.
Очень большие документы (>500 страниц)	Могут занимать значительный объём памяти; рассмотрите возможность потоковой передачи страниц с помощью Document.save(output_stream, options).

В: Как применить лицензионный ключ и какие модели лицензирования доступны?

О: Примените лицензию перед использованием других классов Aspose.TeX. Укажите путь к лицензии в ASPOSE_TEX_PYTHON_NET_LICENSE_PATH или поместите Aspose.TeX.Python-net.lic в рабочий каталог.

# Apply a license from a file before using other Aspose.TeX classes.
import os
from aspose.tex import License

# Set this environment variable, or place the license in the working directory.
license_path = os.environ.get(
    "ASPOSE_TEX_PYTHON_NET_LICENSE_PATH", "Aspose.TeX.Python-net.lic"
)
license = License()
license.set_license(license_path)

Примеры загрузки лицензии из файла и потока, Metered-лицензирования и ограничения ознакомительной версии приведены в разделе Лицензирование.

В: Является ли библиотека потокобезопасной для параллельных преобразований?

О: Да, при условии, что каждый поток создаёт свой собственный экземпляр «Документа». Статические объекты, такие как «Лицензия», должны быть установлены до начала любой параллельной работы.

В: Какая версия среды выполнения .NET требуется для AsposeTeXforPython?

О: Пакет поставляется с двоичными файлами среды выполнения .NET6 (x64). Они автоматически загружаются Pythonnet при первом импорте; вам не нужно устанавливать .NET вручную.

В: Как настроить размер страницы, ориентацию и разрешение на дюйм для растровых изображений?

A: Задайте размер и ориентацию страницы в исходном коде LaTeX. Например, сохраните этот документ A4 с альбомной ориентацией как landscape.ltx:

\documentclass{article}
\usepackage[a4paper,landscape]{geometry}
\begin{document}
Hello, World!
\end{document}

Установите PngSaveOptions.resolution до передачи параметров сохранения заданию. В примере используется 300 DPI. Укажите landscape.ltx в ASPOSE_TEX_INPUT_FILE, а выходной каталог — в ASPOSE_TEX_OUTPUT_DIR, либо используйте пути по умолчанию:

# Convert an A4 landscape LaTeX document to PNG at 300 DPI.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, PngSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "landscape.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
# Page size and orientation are defined in the LaTeX input (geometry package).
# Set the raster resolution in dots per inch.
save_options = PngSaveOptions()
save_options.resolution = 300
options.save_options = save_options
device = ImageDevice(True)
job_result = TeXJob(str(input_file), device, options).run()

Результат — landscape.png размером примерно 3508 × 2480 пикселей.

В: Могу ли я визуализировать LaTeX непосредственно из строки или потока в памяти?

О: Закодируйте полный документ LaTeX в двоичный поток BytesIO и передайте его в TeXJob с TeXConfig.object_latex. Сохраняйте поток открытым во время задания. Результат: texput.xps и texput.log. Укажите выходной каталог в ASPOSE_TEX_OUTPUT_DIR (по умолчанию output). Предварительно примените лицензию. Licensing.

# Render LaTeX supplied as a binary in-memory stream to XPS.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from io import BytesIO
from aspose.tex.io import OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.xps import XpsDevice

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.interaction = Interaction.NONSTOP_MODE
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.terminal_out = OutputMemoryTerminal()
latex_source = r"\documentclass{article} \begin{document} Hello, World! \end{document}"
device = XpsDevice()
with BytesIO(latex_source.encode("ascii")) as input_stream:
    job_result = TeXJob(input_stream, device, options).run()

В: Где я могу найти официальную документацию, примеры кода и каналы поддержки?

О: Проверьте следующие ресурсы:

• Официальная документация
• Руководство по началу работы
• Примеры кода и списки GitHub
• Форум поддержки
• Система отслеживания ошибок (частная для клиентов) – предоставляется после покупки.

Все примеры доступны как на Python, так и на C#; код C# можно напрямую перевести благодаря pythonnet.