LaTeX в PDF | Aspose.TeX для Python

Преобразование LaTeX в PDF

Теперь давайте подробно рассмотрим код Python, который предлагает наиболее простой подход к преобразованию LaTeX в формат PDF.

1# Create conversion options for Object LaTeX format upon Object TeX engine extension.
2options = TeXOptions.console_app_options(TeXConfig.object_latex)
3# Specify a file system working directory for the output.
4options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)
5# Initialize the options for saving in PDF format.
6options.save_options = PdfSaveOptions()
7# Run LaTeX to PDF conversion.
8TeXJob(path.join(Util.input_directory, "hello-world.ltx"), PdfDevice(), options).run()

view raw Aspose.TeX.Examples-Conversion-LaTeXToPdf-Simplest.py hosted with ❤ by GitHub

Для начала нам нужно создать экземпляр класса TeXOptions. Метод console_app_options() — единственный статический метод, который выполняет эту задачу, поэтому не беспокойтесь о его названии. Этот метод принимает экземпляр object_latex класса TeXConfig, который идеально подходит для преобразования файла LaTeX. Эта конфигурация предписывает механизму Object TeX загрузить формат Object LaTeX и подготовиться к обработке файла LaTeX. Формат Object LaTeX по существу аналогичен формату LaTeX, но в нем используются специфические примитивы Object TeX для определения показателей страницы.

Первая опция, которую необходимо указать, — это output_working_directory, которая определяет место, где будут сохранены выходные данные TeX. При необходимости вы можете найти дополнительную информацию о концепции выходного каталога в Aspose.TeX. В данном конкретном случае мы используем класс OutputFileSystemDirectory, который позволяет нам записывать выходные данные в указанный каталог или папку.

Для второго варианта требуется экземпляр класса SaveOptions, который определяет, как объектная модель преобразуется в нужный формат. В нашем случае, когда мы конвертируем LaTeX в PDF, он относится к экземпляру класса PdfSaveOptions.

Чтобы преобразовать файл LaTeX, хранящийся в файловой системе, нам нужно создать экземпляр класса TeXJob, используя конструктор, который принимает полный путь к файлу в качестве параметра. Если мы не укажем полный путь, движок будет искать файл в текущем каталоге (который является рабочим каталогом скрипта) и может не найти его. Однако мы можем опустить расширение, если наш файл имеет расширение .tex, поскольку движок автоматически добавит его. Второй аргумент конструктора — это экземпляр класса Device. В нашем случае, поскольку мы конвертируем LaTeX в PDF, это экземпляр класса PdfDevice. Наконец, в качестве последнего аргумента мы передаем недавно подготовленные параметры преобразования.

Теперь остается только запустить задание.

После выполнения, независимо от того, было оно успешным или нет, первое, что мы увидим — это вывод терминала. Если выполнение прошло успешно, вывод будет выглядеть примерно так:

 1This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
 2entering extended mode
 3
 4(<input_directory>\hello-world.ltx
 5LaTeX2e <2011/06/27>
 6(article.cls
 7Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
 8(size10.clo))
 9No file hello-world.aux.
10[1]
11(<output_directory>\hello-world.aux) )
12Output written on hello-world.pdf (1 page).
13Transcript written on hello-world.log.

В папке, которую мы указали в качестве выходной, мы найдем файл расшифровки и, вот он!, основной выходной PDF-файл, а также другие результаты работы движка.

Альтернативный способ записи основного выходного PDF-файла.

Класс PdfDevice имеет еще один конструктор, который позволяет нам получить результирующий PDF-файл другим способом.

 1# Create the stream to write the PDF file to.
 2with open(path.join(Util.output_directory, "any-name.pdf"), "wb") as pdf_stream:
 3    # Create conversion options for Object LaTeX format upon Object TeX engine extension.
 4    options = TeXOptions.console_app_options(TeXConfig.object_latex)
 5    # Specify a file system working directory for the output.
 6    options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)
 7    # Initialize the options for saving in PDF format.
 8    options.save_options = PdfSaveOptions()
 9    # Run LaTeX to PDF conversion.
10    TeXJob(path.join(Util.input_directory, "hello-world.ltx"), PdfDevice(pdf_stream), options).run()

view raw Aspose.TeX.Examples-Conversion-LaTeXToPdf-Alternative.py hosted with ❤ by GitHub

Основной выходной PDF-файл будет называться «любое имя.pdf» и будет расположен в указанном каталоге. Однако, в отличие от вывода изображения, в выходном каталоге, указанном параметрами преобразования, не будет других PDF-файлов. Исключением является случай, когда any-name.pdf находится в том же каталоге файловой системы, который назначен для параметра output_working_directory с помощью OutputFileSystemDirectory.

О параметрах ввода

Если наш основной входной файл требует зависимостей, таких как пакеты, которые не включены в базовую систему LaTeX, и поддерживаемые пакеты, необходимо установить параметр required_input_directory аналогично тому, как мы установили параметр output_working_directory и поместите зависимости в этот каталог. Зависимости могут быть организованы в подкаталогах по желанию. Кроме того, если у нас есть собственные файлы для включения в процесс верстки, например внешние графические файлы, мы также должны установить input_working_directory, используя путь к месту, где хранятся эти файлы. Мы также можем поместить основной входной файл во входной каталог и указать относительный путь в методе run() или вообще не указывать путь, если основной входной файл находится в корне. Более подробную информацию о концепции входного каталога в Aspose.TeX for Python и предоставленных реализациях можно найти здесь.

Также обсуждаются другие варианты работы в TeX.

Вы также можете изучить бесплатное веб-приложение для преобразования LaTeX в PDF, разработанное с использованием Aspose.TeX for .NET API.

LaTeX для изображения LaTeX в XPS