Die Schaltfläche einfügen

Die Schaltfläche ist ein gewöhnliches HTML-Formular, das den Code des Beispiels an JointTex sendet. Die Feldnamen sind die von „Open in Overleaf“, daher genügt es bei einer für Overleaf geschriebenen Seite, die Formularadresse zu ändern.

So geht’s

1. Setzen Sie neben das Beispiel ein Formular mit method post und action https://jointtex.com/open.
2. Schreiben Sie den Code in ein Feld namens snip, oder in encoded_snip, wenn Ihre Seite ihn mit encodeURIComponent kodiert.
3. Fügen Sie eine Absenden-Schaltfläche hinzu. Ihre Website braucht weder Skript noch Schlüssel noch Konto.

<form action="https://jointtex.com/open" method="post" target="_blank">
  <textarea name="snip" hidden>
\documentclass{article}
\begin{document}
Hello, JointTex!
\end{document}
  </textarea>
  <button type="submit">Open in JointTex</button>
</form>

Mehrere Dateien senden

Ein Beispiel mit Literaturverzeichnis oder eigenem Kapitel sendet jede Datei in einem eigenen Feld, der Reihe nach.

So geht’s

1. Wiederholen Sie snip[] (oder encoded_snip[]) für jede Datei und geben Sie jeder in snip_name[] einen Namen, in derselben Reihenfolge. Eine erste Datei ohne Namen heißt main.tex.
2. Gibt es mehr als eine .tex-Datei, nennen Sie in main_document die zu kompilierende. Sonst nimmt JointTex die einzige .tex-Datei oder die mit \documentclass.
3. Dateinamen dürfen Ordner enthalten, etwa chapters/intro.tex.

<form action="https://jointtex.com/open" method="post" target="_blank">
  <input type="hidden" name="encoded_snip[]" value="...main.tex, encoded with encodeURIComponent...">
  <input type="hidden" name="snip_name[]" value="main.tex">
  <input type="hidden" name="encoded_snip[]" value="...refs.bib, encoded...">
  <input type="hidden" name="snip_name[]" value="refs.bib">
  <input type="hidden" name="main_document" value="main.tex">
  <input type="hidden" name="engine" value="xelatex">
  <button type="submit">Open in JointTex</button>
</form>

Das Satzprogramm wählen

JointTex kompiliert mit pdfLaTeX, sofern Formular oder Code nichts anderes sagen.

So geht’s

1. Setzen Sie engine auf pdflatex, xelatex, lualatex oder latex. Overleafs latex_dvipdf wird als latex gelesen.
2. Ohne engine-Feld entscheidet eine Zeile wie % !TEX program = xelatex am Anfang der Hauptdatei.
3. Ohne beides wird eine Hauptdatei mit chinesischem, japanischem oder koreanischem Text mit XeLaTeX kompiliert, jede andere mit pdfLaTeX.
4. Eine einzelne Datei ohne \documentclass, etwa eine Tabelle für sich, wird in ein minimales Dokument gesetzt, damit sie kompiliert.

Typst-Code senden

Dasselbe Formular öffnet Typst-Beispiele als Typst-Projekte. Overleaf kennt dieses Feld nicht; dieser Teil ist JointTex-eigen.

So geht’s

1. Setzen Sie engine auf typst. Unbenannte Dateien heißen dann main.typ, snippet-2.typ und so weiter.
2. Ohne engine-Feld ist eine Datei mit der Endung .typ die Hauptdatei, wenn keine .tex-Datei gesendet wird; main_document kann sie auch benennen.
3. Typst-Code wird nie in ein Dokument eingebettet: Jeder Typst-Text kompiliert so, wie er ist.

<form action="https://jointtex.com/open" method="post" target="_blank">
  <textarea name="snip" hidden>
= Hello, JointTex!
Typst sets this paragraph.
  </textarea>
  <input type="hidden" name="engine" value="typst">
  <button type="submit">Open in JointTex</button>
</form>

Was Ihre Leser sehen

Der Code wird nie von selbst zu einem Projekt: Die Leser sehen ihn sich zuerst an.

So geht’s

1. Das Formular führt zu einer JointTex-Seite, die die Dateien, die Hauptdatei, das Satzprogramm und die Adresse Ihrer Website zeigt.
2. Angemeldete Leser benennen das Projekt und wählen Projekt erstellen. Neue Leser legen ein Konto an oder melden sich an und kehren auf dieselbe Seite zurück.
3. Das Projekt gehört den Lesern selbst und ist privat. Erneutes Erstellen, Neuladen oder Zurückgehen öffnet dasselbe Projekt, keine zweite Kopie.
4. Der Code bleibt 7 Tage im Browser der Leserin oder des Lesers, nicht auf den Servern von JointTex: Dort wird nichts gespeichert, bevor das Projekt erstellt wird. In einem privaten Fenster oder einem Browser, der für die Website nichts speichert, bleibt er nur so lange wie der Tab.

Grenzen

Eine Übermittlung ist für ein Lehrbeispiel gedacht, nicht für eine ganze Abschlussarbeit.

So geht’s

1. Höchstens 20 Dateien, je 256 KB und zusammen 512 KB, gezählt in UTF-8.
2. Nur Text: Angehängte Dateien sowie snip_uri und zip_uri (die das Abrufen einer Datei von einer URL verlangen) werden abgelehnt.
3. Sendet das Formular etwas, das JointTex nicht öffnen kann, landen die Leser auf einer Seite, die den Grund nennt.