Створити власний формат TeX

Верстка файлу TeX у власному форматі за допомогою C# .NET

 

TeX — це мова програмування, яка використовується для написання програм для комп’ютерної системи підготовки документів, яку також називають TeX (движок TeX). Основна мета — допомога в написанні математичних або технічних статей. Мова TeX включає команди для керування процесом верстки, або шляхом ініціювання певних дій, або шляхом налаштування деяких внутрішніх параметрів двигуна. Використання синтаксису мови TeX може бути ефективнішим, якщо ви визначите макроси та значення параметрів для своєї зручності. Ви можете помістити ці визначення у файл TeX, який будете включати на початку кожного іншого файлу TeX, що містить фактичні дані документа. Або ви можете уникнути цього, зробивши дамп внутрішнього стану двигуна після завантаження визначень. Такий бінарний дамп називається файлом формату. Тоді вам потрібно буде лише вказати назву формату (назву файлу формату TeX) перед версткою будь-якого файлу документа. Двигун TeX завантажить такий файл формату набагато швидше, ніж формат у синтаксисі TeX, оскільки файли формату не потрібно обробляти.

Сьогодні найбільш вживаним форматом є LaTeX. Малоймовірно, що вам знадобиться власний формат, оскільки LaTeX охоплює дуже широкий спектр цілей. Але якщо вам це коли-небудь знадобиться, API-рішення Aspose.TeX дозволяє створити власний формат TeX. Тут ви знайдете інформацію про те, як створювати файли спеціальних форматів і як верстати документи з використанням власного формату. Для цього нам знадобляться:

  • API Aspose.TeX для .NET, який є багатофункціональним, потужним і простим у використанні API для обробки та конвертації документів для платформи C#.

  • Відкрийте менеджер пакетів NuGet, знайдіть Aspose.TeX і встановіть його. Ви також можете використовувати наступну команду в консолі менеджера пакетів:

Package Manager Console Command

PM> Install-Package Aspose.TeX

Кроки для створення власного файлу TeX на C#.

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



FAQ

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

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

2. Як використовувати шаблони LaTeX?

Якщо ви не використовуєте жодного додаткового програмного забезпечення, а шаблон є просто файлом TeX, просто відкрийте його та почніть працювати. Просто майте на увазі, що ви не зберігаєте зміни безпосередньо в цьому документі, а замість цього використовуєте опцію «Зберегти як».

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

Щоб вказати тип документа в LaTeX, як-от стаття, книга чи презентація, використайте команду \documentclass{...} з одним із підтримуваних імен класів у дужках.

4. Як створити кастомний формат TeX?

Щоб створити спеціальний формат TeX за допомогою API Рішення Aspose.TeX, спочатку створіть відповідні параметри механізму TeX. Потім ви вказуєте робочий каталог файлової системи для введення та виведення. І, нарешті, ви створюєте формат, викликаючи метод TeXJob.CreateFormat().

TeX What is TeX File Format

TeX — система набору та мова програмування, що дозволяє створювати високоякісні документи, особливо з формулами. Файли .tex — простий текст, обробляються TeX‑двигунами (pdfTeX, XeTeX, LuaTeX) і генерують PDF, DVI тощо.