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

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

Начнем с создания пользовательского формата.

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

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

// Create a custom TeX format file

// Create TeX engine options for no format upon ObjectTeX engine extension.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectIniTeX);

// Specify a file system working directory for the input.
options.InputWorkingDirectory = new InputFileSystemDirectory(DataDir);

// Specify a file system working directory for the output.
options.OutputWorkingDirectory = new OutputFileSystemDirectory(OutputDir);

// Run format creation.
TeXJob.CreateFormat("customtex", options);

// For further output to look fine.
options.TerminalOut.Writer.WriteLine();

Как видите, код аналогичен коду конвертации файла TeX. Но есть несколько отличий.

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

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

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

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

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

// Typeset a TeX file using a custom TeX format

// Create the file system input working directory.
// 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.

using (FormatProvider formatProvider =
    new FormatProvider(new InputFileSystemDirectory(OutputDir), "customtex"))
{
    // Create conversion options for a custom format upon ObjectTeX engine extension.
    TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX(formatProvider));
    options.JobName = "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.InputWorkingDirectory = new InputFileSystemDirectory(DataDir);
    
    // Specify a file system working directory for the output.
    options.OutputWorkingDirectory = new OutputFileSystemDirectory(OutputDir);

    // Run the job.
    new TeXJob(new MemoryStream(Encoding.ASCII.GetBytes(
            "Congratulations! You have successfully typeset this text with your own TeX format!\\end")),
            new XpsDevice(), options).Run();

    // For further output to look fine.
    options.TerminalOut.Writer.WriteLine();
}

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

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

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

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