Создайте собственный формат TeX

Создайте файл TeX в произвольном формате с помощью C# .NET.

 

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

В настоящее время наиболее часто используемый формат — LaTeX. Маловероятно, что вам понадобится ваш формат, поскольку LaTeX охватывает очень широкий спектр приложений. Но если вам это когда-нибудь понадобится, решение Aspose.TeX API позволит вам создать свой собственный формат TeX. Здесь вы найдете информацию о том, как создавать файлы пользовательского формата и как составлять документы с использованием пользовательского формата. Для этого нам нужно:

  • API Aspose.TeX для .NET — многофункциональный, мощный и простой в использовании API для обработки и преобразования документов для платформы C#.

  • Откройте диспетчер пакетов NuGet, найдите Aspose.TeX и установите его. Вы также можете использовать следующую команду из консоли диспетчера пакетов.

Package Manager Console Command

PM> Install-Package Aspose.TeX

Действия по созданию пользовательского файла C# TeX.

  1. Использование метода ConsoleAppOptions() метода TeXOptions , создает экземпляры параметров движка TeX для расширения движка Object TeX в его исходном состоянии (без какого-либо формата).
  2. Используя класс InputFileSystemDirectory , укажите рабочий каталог файловой системы для входных данных.
  3. Используйте класс OutputFileSystemDirectory , чтобы указать рабочий каталог файловой системы для вывода.
  4. Создайте файл формата, вызвав метод TeXJob.CreateFormat() . Имя, которое вы указываете в качестве аргумента, должно быть именем вашего файла TeX, содержащего этот формат. Файл двоичного формата будет иметь то же имя.

Пример кода C#: создание файла пользовательского формата

using Aspose.TeX.IO;
using Aspose.TeX;
// Create the 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(RunExamples.InputDirectory);
// Specify a file system working directory for the output.
options.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);

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

Действия по созданию файла TeX в пользовательском формате C#.

  1. Создайте поставщика формата, используя класс InputFileSystemDirectory .
  2. Создайте параметры преобразования для своего пользовательского формата в расширении движка Object TeX, используя метод ConsoleAppOptions() texoptions/consoleappoptions) из TeXOptions .
  3. Укажите рабочий каталог ввода, если основной ввод не предоставляется в виде потока. Для этого используйте класс InputFileSystemDirectory .
  4. Укажите рабочий каталог файловой системы для вывода, используя класс OutputFileSystemDirectory .
  5. Создайте объект класса TeXJob с экземпляром XpsDevice и запустите задание, вызвав метод Run(). Здесь мы также покажем, как передать основной входной файл TeX в виде потока.

Пример кода C#: преобразование файла TeX в пользовательский формат

using Aspose.TeX.IO;
using Aspose.TeX.Presentation.Xps;
using Aspose.TeX.ResourceProviders;
using System.IO;
using System.Text;
// 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(RunExamples.OutputDirectory), "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(RunExamples.InputDirectory);
    // Specify a file system working directory for the output.
    options.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);

    // 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();
}



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

1. Что такое шаблон LaTeX?

Шаблон — это сохраненный набор свойств, настроек или структуры, который можно применить к вновь создаваемому документу для экономии времени. Для LaTeX это может быть файл, содержащий информацию о формате страницы, шрифтах, классе документа, включенных пакетах и ​​т. д.

2. Как использовать шаблоны LaTeX?

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

3. Как установить тип документа LaTeX?

Чтобы указать тип документа в LaTeX, например статью, книгу или презентацию, используйте команду \documentclass{...} с одним из поддерживаемых имен классов в фигурных скобках.

4. Как создать собственный формат TeX?

Чтобы создать собственный формат TeX с помощью решения API Aspose.TeX, вы сначала создаете правильные параметры движка TeX. Затем вы указываете рабочий каталог файловой системы для ввода и вывода. И, наконец, вы создаете формат, вызывая метод TeXJob.CreateFormat().

TeX Формат файла TeX

TeX на самом деле не является форматом. Это одновременно и язык программирования, и интерпретатор, который понимает этот язык. Файл TeX — это документ, созданный в LaTeX. Этот документ может включать графику, таблицы, символы, списки, формулы и уравнения.