LaTeX в PDF | Aspose.TeX для Java

Как конвертировать LaTeX в PDF

Давайте подробнее рассмотрим код Java, обеспечивающий самый простой способ преобразования LaTeX в формат PDF.

// 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.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));
// Initialize the options for saving in PDF format.
options.setSaveOptions(new PdfSaveOptions());
// Run LaTeX to PDF conversion.
new TeXJob(Utils.getInputDirectory() +  "hello-world.ltx", new PdfDevice(), options).run();

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

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

Второй вариант — это экземпляр класса SaveOptions, который будет управлять преобразованием объектной модели в целевой формат. Поскольку мы конвертируем LaTeX в PDF, это экземпляр класса PdfSaveOptions.

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

Все, что нам нужно сделать сейчас, это запустить задание.

Независимо от того, был ли запуск успешным или нет, первым результатом, который мы увидим, будет вывод терминала. В случае успеха это выглядит примерно так:

This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
entering extended mode

(<input_directory>\hello-world.ltx
LaTeX2e <2011/06/27>
(article.cls
Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
(size10.clo))
No file hello-world.aux.
[1]
(<output_directory>\hello-world.aux) )
Output written on hello-world.pdf (1 page).
Transcript written on hello-world.log.

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

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

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

// Create the stream to write the PDF file to.
final OutputStream pdfStream = new FileOutputStream(Utils.getOutputDirectory() + "any-name.pdf");
try {
  // Create conversion options for Object LaTeX format upon Object TeX engine extension.
  ...
    // Run LaTeX to PDF conversion.
    new TeXJob(Utils.getInputDirectory() + "hello-world.ltx", new PdfDevice(pdfStream), options).run();
} finally {
  if (pdfStream != null)
    pdfStream.close();
}

Файл any-name.pdf в указанном каталоге будет нашим основным выходным PDF-файлом. В то же время, в отличие от вывод изображения, мы не найдем никаких PDF-файлов в выходном каталоге, определенном параметрами преобразования. Исключение: any-name.pdf находится (по пути) в том же каталоге файловой системы, который назначен параметру OutputWorkingDirectory с помощью OutputFileSystemDirectory.

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

Если наш основной входной файл требует зависимостей, например, пакетов, которые не включены в базовую систему LaTeX и поддерживаемых пакетов, мы ДОЛЖНЫ установить параметр RequiredInputDirectory аналогично тому, как мы устанавливаем параметр OutputWorkingDirectory. и поместите зависимости в этот каталог. Зависимости могут быть произвольно организованы в подкаталогах. Если у нас есть собственные файлы, которые нужно включить в процесс верстки, скажем, внешние графические файлы, мы ДОЛЖНЫ также установить InputWorkingDirectory, используя путь к месту, где собраны эти файлы. Мы также можем поместить основной входной файл где-нибудь внутри входного каталога и указать относительный путь в методе run() (или вообще не указывать путь, если основной входной файл находится в корне). Здесь приведены подробные сведения о концепции входного каталога в Aspose.TeX для Java и предоставленных реализациях.

Другие варианты работы в TeX обсуждаются здесь.

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