LaTeX у PDF | Рішення Aspose.TeX API для C++

Як конвертувати LaTeX у PDF

Давайте детально розглянемо код на C++, що забезпечує найпростіший спосіб перетворення LaTeX у формат PDF.

Отже, перше, що нам потрібно зробити (ну, іноді не перше), це створити екземпляр класу TeXOptions. Єдиним статичним методом, який це робить, є ConsoleAppOptions(), тож давайте не будемо спантеличуватися значенням його назви. Метод приймає примірник класу TeXConfig, який точно підходить для перетворення файлу LaTeX. Ця конфігурація повідомляє механізму Object TeX завантажити формат Object LaTeX і бути готовим прийняти файл LaTeX. Формат Object LaTeX насправді є лише форматом LaTeX, за винятком того, що він використовує специфічні примітиви Object TeX для налаштування показників сторінки.

Першим із необхідних параметрів є OutputWorkingDirectory, який визначає простір або область, куди буде записаний вихід TeX. Тут наведено деталі про концепцію вихідного каталогу в Aspose.TeX для C++. У цьому прикладі ми використовуємо клас OutputFileSystemDirectory, який дозволяє записувати вихідні дані у вказаний каталог або папку.

Другий варіант — екземпляр класу SaveOptions, який керуватиме перетворенням об’єктної моделі у цільовий формат. Оскільки ми перетворюємо LaTeX у PDF, це екземпляр класу PdfSaveOptions.

Потім нам потрібно створити екземпляр класу TeXJob. Бажаючи перетворити файл LaTeX, що зберігається у файловій системі, ми використовуємо this версію конструктора. Потрібно вказати повний шлях до файлу. Інакше механізм шукатиме його в поточному каталозі (це CurrentDirectory) і, швидше за все, не знайде. Тим не менш, ми можемо опустити розширення, якщо наш файл має .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.

Інші «плоди» праці движка ми знайдемо в папці, яку ми вказали як вихідний каталог. Це буде файл стенограми та, ось він!, основний вихідний PDF-файл.

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

Є ще один конструктор класу PdfDevice, який дозволяє нам отримати кінцевий PDF-файл альтернативним способом.

    // Create the stream to write the XPS file to.
    {
        System::SharedPtr<System::IO::Stream> pdfStream = System::IO::File::Open(System::IO::Path::Combine(RunExamples::OutputDirectory, u"any-name.pdf"), System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ pdfsStream});
        // ------------------------------------------
        
        try
        {
            // Create conversion options for Object LaTeX format on Object TeX engine extension.
            System::SharedPtr<TeXOptions> options = TeXOptions::ConsoleAppOptions(TeXConfig::get_ObjectLaTeX());
            // Specify the file system working directory for the output.
            options->set_OutputWorkingDirectory(System::MakeObject<OutputFileSystemDirectory>(RunExamples::OutputDirectory));
            // Initialize the options for saving in PDF format.
            options->set_SaveOptions(System::MakeObject<PdfSaveOptions>());
            // Default value.
            // Run LaTeX to XPS conversion.
            System::MakeObject<TeXJob>(System::IO::Path::Combine(RunExamples::InputDirectory, u"hello-world.ltx"), System::MakeObject<PdfDevice>(pdfStream), options)->Run();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

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

Про параметри введення

Якщо наш основний вхідний файл потребує залежностей, наприклад, пакетів, які не входять до базової системи LaTeX і підтримуваних пакетів, ми ПОВИННІ встановити опцію RequiredInputDirectory так само, як ми встановлюємо OutputWorkingDirectory і помістіть залежності в цей каталог. Залежності можуть бути довільно організовані в підкаталоги. Якщо ми маємо власні файли для включення в процес верстки, скажімо, зовнішні графічні файли, ми ПОВИННІ також встановити InputWorkingDirectory, використовуючи шлях до розташування, де ці файли зібрано. Ми також можемо розмістити головний вхідний файл десь усередині вхідного каталогу та вказати відносний шлях у методі run() (або взагалі не вказати шлях, якщо головний вхідний файл знаходиться в корені). Тут наведено деталі про концепцію каталогу вводу в Aspose.TeX для C++ і надані реалізації.

Інші варіанти завдань TeX обговорюються тут.

Ви також можете ознайомитися з безкоштовною [веб-програмою] для перетворення LaTeX у PDF (29), створеною на основі Aspose.TeX для C++ API.