SwiftLaTeX

SwiftLaTeX

Демо-сайт https://www.swiftlatex.com

Введение в SwiftLaTeX

SwiftLaTeX, механизмы LaTeX в браузерах с дополнительной поддержкой WYSIWYG. Мы большие поклонники WebAssembly, и все вычисления выполняются локально.

Основные характеристики

1. Скорость . Движки SwiftLaTeX работают в браузерах, все вычисления выполняются строго локально.
2. Поддержка библиотеки . Просто добавьте тег сценария и используйте PdfTeX или XeTeX на своей веб-странице.
3. Совместимость . Производите точно такой же результат, который вы получили бы от TexLive или MikTeX.
4. ВЫСИВИГ . SwiftLaTeX предоставляет дополнительный редактор WYSIWYG, позволяющий пользователям напрямую редактировать PDF-файлы (WIP).

Руководство по быстрой установке

1. Загрузите последнюю версию с Github. Извлеките файлы и поместите их в каталог своей веб-страницы.
2. Включите тег src на свою страницу.

 <script src="PdfTeXEngine.js"></script>

3. Инициализируйте двигатель.

 const engine = new PdfTeXEngine();
await engine.loadEngine();

4. Загрузите текстовые файлы/изображения/шрифты в движки.

 engine.writeMemFSFile("main.tex", "documentclass{...");

5. Установите основной файл и запустите двигатель.

 engine.setEngineMainFile("main.tex");
let r = await engine.compileLaTeX(); // r contains PDF binray and compilation log.

API

1. асинхронный loadEngine(): Обещание.
   Загрузите движок веб-сборки.
2. isReady(): логическое значение.
   Проверьте, готов ли движок к компиляции документов.
3. writeMemFSFile (имя файла: строка, код источника: строка | Uint8Array).
   Загрузите исходные коды/ассеты в движок.
4. makeMemFSFolder (папка: строка).
   Создайте каталог.
5. setEngineMainFile (имя файла: строка).
   Сообщите движку, какой латексный файл является входным файлом.
6. compileLaTeX():Обещание.
   Начните компилировать документы LaTeX и верните CompileResult.
7. флешКэш().
   Очистите все загруженные файлы.
8. закрытьРабочий().
   Выключите двигатель.
9. setTexliveEndpoint (url: строка).
   Если у вас есть собственный сервер texlive, вы можете попросить движок загрузить файлы с сервера.
10. компилироватьФормат().
    Если у вас есть собственный сервер texlive, вы можете сгенерировать файл формата tex-движка с помощью этой функции.

Скомпилируйте движки самостоятельно

SwiftLaTeX компилирует движки XeTeX и PdfTeX в WebAssembly. Мы рекомендуем движок XeTeX, поскольку он «из коробки» поддерживает шрифты UTF-8 и Opentype. Движок почти на 100% идентичен XeTeX, за исключением того, что SwiftLaTeX не включает полный набор данных ICU. В результате разрыв строки локали может работать не так, как ожидалось. Эту проблему легко решить: нам просто нужно инициализировать библиотеку ICU с правильным набором данных. Если вам просто нужно работать с английским языком, PdfTeX также станет хорошим вариантом. Он менее сложен, а значит, быстрее и менее глючен.

1. Получите репозиторий emsdk

 git clone https://github.com/emscripten-core/emsdk.git

2. Войдите в этот каталог

 cd emsdk

3. Получите последнюю версию emsdk (не требуется при первом клонировании)

 git pull

4. Загрузите и установите новейшие инструменты SDK.

 ./emsdk install latest

5. Сделайте последнюю версию SDK «активной» для текущего пользователя (записывает файл .emscripten).

 ./emsdk activate latest

6. Активируйте PATH и другие переменные среды в текущем терминале.

 source ./emsdk_env.sh

7. Скомпилируйте XeTeX или PdfTeX

 cd pdftex.wasm or xetex.wasm
make

CTAN-файлы

LaTeX сам по себе не является отдельной программой набора текста, а представляет собой программное обеспечение для подготовки документов, которое работает поверх системы набора текста TeX Дональда Э. Кнута. Дистрибутивы TeX обычно объединяют все части, необходимые для работающей системы TeX, и обычно добавляют к этому утилиты настройки и обслуживания. В настоящее время LaTeX и многие пакеты, созданные на его основе, являются важным компонентом любого крупного дистрибутива TeX. В SwiftLaTeX все необходимые файлы извлекаются из CTAN (Комплексная сеть архивов TeX), https://www.ctan.org или нашего зеркального сервера https://texlive.swiftlatex.com. Вы можете проверить репозиторий https://github.com/SwiftLaTeX/Texlive-Ondemand и разместить свой собственный сервер.

WYSIWYG-редактор

Мы также прилагаем все усилия, чтобы вернуть наш латексный редактор WYSIWYG. Редактор очень похож на следующий, за исключением того, что пользователям разрешено редактировать PDF-файл напрямую.

Лицензия

Код в этом репозитории выпущен под лицензией GNU AFFERO GENERAL PUBLIC LICENSE версии 3. Копию можно найти в файле LICENSE. Copyright (c) SwiftLab, 2018–2022.