Другие выходные форматы преобразования TeX | Python

Маловероятно, что вам в настоящее время понадобится конвертировать файл TeX, написанный в формате, отличном от LaTeX. Однако, если вы по какой-либо причине изучаете язык TeX или внутренние устройства TeX, это все равно возможно. В любом случае Aspose.TeX for Python позволяет конвертировать файлы, написанные в формате Plain TeX, а также позволяет создавать собственные форматы и верстать документы, разработанные в этих форматах.

Для начала мы создадим собственный формат.

Создание пользовательского формата

Давайте помнить, что файл формата представляет собой двоичное представление внутреннего состояния движка TeX.

# Create TeX engine options for no format upon ObjectTeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_ini_tex)
# Specify a file system working directory for the input.
options.input_working_directory = InputFileSystemDirectory(Util.input_directory)
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)

# Run format creation.
TeXJob.create_format("customtex", options)

# For further output to look fine.
options.terminal_out.writer.write_line()

Как видите, код похож на код конвертации файла TeX. Однако есть несколько различий.

Во-первых, в этом случае мы используем конфигурацию задания TeXConfig.object_ini_tex. Эта конфигурация гарантирует, что состояние механизма является «девственным», что означает, что внутренние параметры имеют значения по умолчанию, а набор управляющих последовательностей соответствует набору примитивов. В нашем примере набор примитивов расширен в статье Aspose.TeX и Object TeX.

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

И второе важное отличие — это метод, с помощью которого мы выполняем работу. В этом случае мы используем статический метод create_format(), который в сочетании с опциями требует, чтобы имя основного исходного файла было идентично имени формата.

Набор текста TeX-файла в вашем пользовательском формате

Теперь, когда мы создали собственный формат TeX, мы можем приступить к верстке файла TeX, написанного в этом формате. Вот код:

# Create the format provider using the file system input working directory.
# We use the project output directory as our custom format file is supposed to be located there.
with FormatProvider(InputFileSystemDirectory(Util.output_directory), "customtex") as format_provider:
    # Create conversion options for a custom format upon ObjectTeX engine extension.
    options = TeXOptions.console_app_options(TeXConfig.object_tex(format_provider))
    options.job_name = "typeset-with-custom-format"
    # Specify the input working directory. This is not required here as we are providing the main input as a stream.
    # But it is required when the main input has dependencies (e.g. images).
    options.input_working_directory = InputFileSystemDirectory(Util.input_directory)
    # Specify a file system working directory for the output.
    options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)

    # Run the job.
    TeXJob(BytesIO("Congratulations! You have successfully typeset this text with your own TeX format!\\end".encode('ascii')),
           XpsDevice(), options).run()

    # For further output to look fine.
    options.terminal_out.writer.write_line()

Чтобы указать формат, нам нужно создать экземпляр класса FormatProvider. В конструкторе параметров мы используем конфигурацию TeXConfig.object_tex(), которая требует нашего поставщика формата в качестве аргумента и загружает формат поверх «девственного» состояния движка.

Оставшийся код должен быть вам знаком, поскольку он использует функции, обсуждавшиеся ранее в этом руководстве.

Набор текста файла TeX в формате Plain TeX

Если мы удалим поставщика формата из кода, показанного выше, движок загрузит формат по умолчанию, то есть Object TeX в четвертом смысле. Таким образом, если у вас есть файл TeX, написанный в формате Plain TeX, вы можете преобразовать его в любой поддерживаемый целевой формат, используя этот подход.