SwiftLaTeX

SwiftLaTeX

Demo-Website https://www.swiftlatex.com

Einführung für SwiftLaTeX

SwiftLaTeX, LaTeX-Engines in Browsern mit optionaler WYSIWYG-Unterstützung. Wir sind ein großer Fan von WebAssembly und alle Berechnungen werden lokal durchgeführt.

Hauptmerkmale

1. Geschwindigkeit . SwiftLaTeX-Engines laufen in Browsern, alle Berechnungen erfolgen ausschließlich lokal.
2. Bibliotheksunterstützung . Fügen Sie einfach ein Skript-Tag ein und verwenden Sie PdfTeX oder XeTeX auf Ihrer eigenen Webseite.
3. Kompatibilität . Produzieren Sie genau die gleiche Ausgabe, die Sie von TexLive oder MikTeX erhalten würden.
4. WYSIWYG . SwiftLaTeX bietet einen optionalen WYSIWYG-Editor, mit dem Benutzer die PDF-Ausgabe direkt bearbeiten können (WIP).

Kurzanleitung zur Installation

1. Laden Sie die neueste Version von Github herunter. Extrahieren Sie die Dateien und legen Sie sie in Ihrem Webseitenverzeichnis ab.
2. Fügen Sie das src-Tag in Ihre Seite ein.

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

3. Initialisieren Sie den Motor.

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

4. Laden Sie die TEX-Dateien/Bilder/Schriftarten in die Engines.

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

5. Legen Sie die Hauptdatei fest und starten Sie die Engine.

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

APIs

1. async loadEngine(): Versprechen.
   Laden Sie die Webassembly-Engine.
2. isReady(): boolean.
   Prüfen Sie, ob die Engine zum Kompilieren von Dokumenten bereit ist.
3. writeMemFSFile(Dateiname: String, Quellcode: String | Uint8Array).
   Laden Sie Quellcodes/Assets in die Engine hoch.
4. makeMemFSFolder(Ordner: String).
   Erstellen Sie ein Verzeichnis.
5. setEngineMainFile(dateiname: string).
   Teilen Sie der Engine mit, welche Latexdatei die Eintragsdatei ist.
6. compilierenLaTeX():Promise.
   Beginnen Sie mit dem Kompilieren von LaTeX-Dokumenten und geben Sie CompileResult zurück.
7. FlushCache().
   Löschen Sie alle hochgeladenen Dateien.
8. closeWorker().
   Stellen Sie den Motor ab.
9. setTexliveEndpoint(url: string).
   Wenn Sie Ihren eigenen Texlive-Server hosten, können Sie die Engine bitten, Dateien vom Server abzurufen.
10. compilierenFormat().
    Wenn Sie Ihren eigenen Texlive-Server hosten, möchten Sie möglicherweise über diese Funktion die Tex-Engine-Formatdatei generieren.

Kompilieren Sie Engines selbst

SwiftLaTeX kompiliert XeTeX- und PdfTeX-Engines in WebAssembly. Wir empfehlen die XeTeX-Engine, da diese standardmäßig UTF-8- und OpenType-Schriftarten unterstützt. Die Engine ist fast 100 % identisch mit XeTeX, außer dass SwiftLaTeX keinen vollständigen ICU-Datensatz enthält. Infolgedessen funktioniert der Zeilenumbruch im Gebietsschema möglicherweise nicht wie erwartet. Dieses Problem lässt sich leicht beheben: Wir müssen lediglich die ICU-Bibliothek mit dem richtigen Datensatz initialisieren. Wenn Sie nur Englisch beherrschen müssen, ist PdfTeX auch eine gute Option. Es ist weniger kompliziert, daher schneller und weniger fehlerhaft.

1. Holen Sie sich das Emsdk-Repo

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

2. Geben Sie dieses Verzeichnis ein

 cd emsdk

3. Rufen Sie die neueste Version des emsdk ab (beim ersten Klonen nicht erforderlich).

 git pull

4. Laden Sie die neuesten SDK-Tools herunter und installieren Sie sie.

 ./emsdk install latest

5. Machen Sie das neueste „SDK“ für den aktuellen Benutzer „aktiv“. (schreibt die .emscripten-Datei)

 ./emsdk activate latest

6. Aktivieren Sie PATH und andere Umgebungsvariablen im aktuellen Terminal

 source ./emsdk_env.sh

7. Kompilieren Sie XeTeX oder PdfTeX

 cd pdftex.wasm or xetex.wasm
make

CTAN-Dateien

LaTeX ist kein eigenständiges Satzprogramm, sondern eine Dokumentenvorbereitungssoftware, die auf dem TeX-Satzsystem von Donald E. Knuth läuft. TeX-Distributionen bündeln normalerweise alle Teile, die für ein funktionierendes TeX-System erforderlich sind, und fügen diesem im Allgemeinen sowohl Konfigurations- als auch Wartungsdienstprogramme hinzu. Heutzutage bilden LaTeX und viele der darauf aufbauenden Pakete einen wichtigen Bestandteil jeder großen TeX-Distribution. In SwiftLaTeX werden alle erforderlichen Dateien von CTAN (Comprehensive TeX Archive Network), https://www.ctan.org, oder unserem Spiegelserver https://texlive.swiftlatex.com abgerufen. Sie können das Repo https://github.com/SwiftLaTeX/Texlive-Ondemand auschecken und Ihren eigenen Server hosten.

WYSIWYG-Editor

Wir arbeiten auch hart daran, unseren WYSIWYG-Latex-Editor zurückzubringen. Der Editor ist Overleaf ziemlich ähnlich, mit der Ausnahme, dass Benutzer die PDF-Ausgabe direkt bearbeiten dürfen.

Lizenz

Der Code in diesem Repository wird unter der GNU AFFERO GENERAL PUBLIC LICENSE, Version 3, veröffentlicht. Eine Kopie finden Sie in der LICENSE-Datei. Urheberrecht (c) SwiftLab, 2018–2022.