SwiftLaTeX

SwiftLaTeX

Site de demonstração https://www.swiftlatex.com

Introdução ao SwiftLaTeX

SwiftLaTeX, motores LaTeX em navegadores com suporte WYSIWYG opcional. Somos grandes fãs do WebAssembly e todos os cálculos são feitos localmente.

Principais recursos

1. Velocidade . Os motores SwiftLaTeX são executados em navegadores, todos os cálculos são feitos estritamente localmente.
2. Apoio à Biblioteca . Basta incluir uma tag de script e usar PdfTeX ou XeTeX em sua própria página web.
3. Compatibilidade . Produza exatamente o mesmo resultado que você obteria do TexLive ou MikTeX.
4. WYSIWYG . SwiftLaTeX fornece um editor WYSIWYG opcional, permitindo aos usuários editar a saída de PDF diretamente (WIP).

Guia de instalação rápida

1. Baixe a versão mais recente do Github. Extraia os arquivos e coloque-os no diretório da sua página da web.
2. Inclua a tag src em sua página.

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

3. Inicialize o motor.

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

4. Carregue os arquivos/imagens/fontes tex nos mecanismos.

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

5. Defina o arquivo principal e ligue o motor.

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

APIs

1. loadEngine assíncrono(): Promessa.
   Carregue o mecanismo webassembly.
2. isReady(): booleano.
   Verifique se o motor está pronto para compilar documentos.
3. writeMemFSFile (nome do arquivo: string, srccode: string | Uint8Array).
   Carregue códigos-fonte/ativos para o mecanismo.
4. makeMemFSFolder(pasta: string).
   Crie um diretório.
5. setEngineMainFile(nome do arquivo: string).
   Informe ao mecanismo qual arquivo latex é o arquivo de entrada.
6. compileLaTeX():Promessa.
   Comece a compilar documentos LaTeX e retorne CompileResult.
7. flushCache().
   Limpe todos os arquivos carregados.
8. closeWorker().
   Desligue o motor.
9. setTexliveEndpoint(url:string).
   Se você hospedar seu próprio servidor texlive, poderá solicitar ao mecanismo que busque arquivos do servidor.
10. compileFormat().
    Se você hospeda seu próprio servidor texlive, você pode querer gerar o arquivo no formato do mecanismo tex por meio desta função.

Compile motores sozinho

SwiftLaTeX compila motores XeTeX e PdfTeX em WebAssembly. Recomendamos o mecanismo XeTeX, pois ele suporta fontes UTF-8 e Opentype prontas para uso. O mecanismo é quase 100% idêntico ao XeTeX, exceto que o SwiftLaTeX não inclui um conjunto de dados ICU completo. Como resultado, a quebra de linha de localidade pode não funcionar conforme o esperado. Esse problema é fácil de corrigir: basta inicializar a biblioteca ICU com o conjunto de dados correto. Se você só precisa dominar o inglês, o PdfTeX também é uma boa opção. É menos complicado, portanto mais rápido e com menos bugs.

1. Obtenha o repositório emsdk

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

2. Entre nesse diretório

 cd emsdk

3. Obtenha a versão mais recente do emsdk (não é necessário na primeira vez que você clona)

 git pull

4. Baixe e instale as ferramentas SDK mais recentes.

 ./emsdk install latest

5. Torne o "SDK" mais recente ativo para o usuário atual. (grava o arquivo .emscripten)

 ./emsdk activate latest

6. Ative PATH e outras variáveis ​​de ambiente no terminal atual

 source ./emsdk_env.sh

7. Compilar XeTeX ou PdfTeX

 cd pdftex.wasm or xetex.wasm
make

Arquivos CTAN

LaTeX não é um programa de composição independente em si, mas um software de preparação de documentos que roda sobre o sistema de composição TeX de Donald E. Knuth. As distribuições TeX geralmente agrupam todas as partes necessárias para um sistema TeX funcional e geralmente adicionam a isso utilitários de configuração e manutenção. Hoje em dia, o LaTeX, e muitos dos pacotes construídos nele, formam um componente importante de qualquer grande distribuição do TeX. No SwiftLaTeX, todos os arquivos necessários são obtidos do CTAN (Comprehensive TeX Archive Network), https://www.ctan.org, ou de nosso servidor espelho https://texlive.swiftlatex.com. Você pode verificar o repositório https://github.com/SwiftLaTeX/Texlive-Ondemand e hospedar seu próprio servidor.

Editor WYSIWYG

Também estamos trabalhando duro para trazer de volta nosso editor de látex WYSIWYG. O editor é bastante semelhante ao verso, exceto que os usuários podem editar a saída do PDF diretamente.

Licença

O código neste repositório é lançado sob a GNU AFFERO GENERAL PUBLIC LICENSE, versão 3. Uma cópia pode ser encontrada no arquivo LICENSE. Direitos autorais (c) SwiftLab, 2018-2022.