Ajouter le bouton

Le bouton est un formulaire HTML ordinaire qui envoie le code de l’exemple à JointTex. Les noms de champs sont ceux d’« Open in Overleaf » : pour une page écrite pour Overleaf, il suffit de changer l’adresse du formulaire.

Étapes

1. À côté de l’exemple, placez un formulaire avec method post et action https://jointtex.com/open.
2. Mettez le code dans un champ nommé snip, ou dans encoded_snip si votre page l’encode avec encodeURIComponent.
3. Ajoutez un bouton d’envoi. Votre site n’a besoin d’aucun script, d’aucune clé ni d’aucun compte.

<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>

Envoyer plusieurs fichiers

Un exemple avec une bibliographie ou un chapitre séparé envoie chaque fichier dans son propre champ, dans l’ordre.

Étapes

1. Répétez snip[] (ou encoded_snip[]) pour chaque fichier et donnez à chacun un nom dans snip_name[], dans le même ordre. Un premier fichier sans nom s’appelle main.tex.
2. S’il y a plusieurs fichiers .tex, indiquez dans main_document celui à compiler. Sinon, JointTex prend le seul fichier .tex, ou celui qui contient \documentclass.
3. Les noms peuvent comporter des dossiers, comme 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>

Choisir le moteur

JointTex compile avec pdfLaTeX, sauf indication contraire du formulaire ou du code.

Étapes

1. Donnez à engine la valeur pdflatex, xelatex, lualatex ou latex. Le latex_dvipdf d’Overleaf est lu comme latex.
2. Sans champ engine, une ligne comme % !TEX program = xelatex en tête du fichier principal décide.
3. Sans l’un ni l’autre, un fichier principal contenant du chinois, du japonais ou du coréen est compilé avec XeLaTeX, et tout autre avec pdfLaTeX.
4. Un fichier seul sans \documentclass, par exemple un tableau isolé, est placé dans un document minimal pour pouvoir être compilé.

Envoyer du code Typst

Le même formulaire ouvre les exemples Typst comme projets Typst. Overleaf n’a pas ce champ : cette partie est propre à JointTex.

Étapes

1. Donnez à engine la valeur typst. Les fichiers sans nom deviennent alors main.typ, snippet-2.typ, etc.
2. Sans champ engine, un fichier en .typ est le fichier principal quand aucun fichier .tex n’est envoyé ; main_document peut aussi le désigner.
3. Le code Typst n’est jamais placé dans un document : tout texte Typst se compile tel quel.

<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>

Ce que voit votre lecteur

Le code ne devient jamais un projet de lui-même : le lecteur le voit d’abord.

Étapes

1. Le formulaire mène le lecteur à une page JointTex qui montre les fichiers, le fichier principal, le moteur et l’adresse de votre site.
2. Un lecteur connecté nomme le projet et choisit Créer le projet. Un nouveau lecteur crée un compte ou se connecte, puis revient sur la même page.
3. Le projet appartient au lecteur et reste privé. Choisir de nouveau Créer le projet, recharger ou revenir en arrière ouvre le même projet, pas une seconde copie.
4. Le code reste 7 jours dans le navigateur du lecteur, pas sur les serveurs de JointTex : rien n’y est enregistré avant que le lecteur crée le projet. Dans une fenêtre privée, ou un navigateur qui ne garde rien pour le site, il ne reste que le temps de l’onglet.

Limites

Un envoi est prévu pour un exemple pédagogique, pas pour une thèse entière.

Étapes

1. Au plus 20 fichiers, 256 Ko chacun et 512 Ko en tout, comptés en UTF-8.
2. Texte uniquement : les fichiers joints, ainsi que snip_uri et zip_uri (qui demandent de récupérer un fichier à une URL), sont refusés.
3. Si le formulaire envoie quelque chose que JointTex ne peut pas ouvrir, le lecteur arrive sur une page qui en donne la raison.