Añade el botón

El botón es un formulario HTML corriente que envía el código del ejemplo a JointTex. Usa los mismos nombres de campo que «Open in Overleaf», así que a una página escrita para Overleaf le basta con cambiar la dirección del formulario.

Cómo hacerlo

1. Junto al ejemplo, coloca un formulario con method post y action https://jointtex.com/open.
2. Pon el código en un campo llamado snip, o en encoded_snip si tu página lo codifica con encodeURIComponent.
3. Añade un botón de envío. Tu sitio no necesita ningún script, clave ni cuenta.

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

Envía varios archivos

Un ejemplo con bibliografía o con un capítulo aparte envía cada archivo en su propio campo, en orden.

Cómo hacerlo

1. Repite snip[] (o encoded_snip[]) una vez por archivo y da a cada uno un nombre en snip_name[], en el mismo orden. Un primer archivo sin nombre es main.tex.
2. Si hay más de un archivo .tex, indica en main_document cuál se compila. Si no, JointTex toma el único .tex o el que contiene \documentclass.
3. Los nombres pueden incluir carpetas, como 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>

Elige el motor

JointTex compila con pdfLaTeX salvo que el formulario o el código indiquen otra cosa.

Cómo hacerlo

1. Da a engine el valor pdflatex, xelatex, lualatex o latex. El latex_dvipdf de Overleaf se lee como latex.
2. Sin el campo engine, decide una línea como % !TEX program = xelatex al principio del archivo principal.
3. Sin ninguno de los dos, un archivo principal con texto en chino, japonés o coreano se compila con XeLaTeX, y cualquier otro con pdfLaTeX.
4. Un archivo único sin \documentclass, como una tabla suelta, se coloca en un documento mínimo para que compile.

Envía código Typst

El mismo formulario abre ejemplos de Typst como proyectos de Typst. Overleaf no tiene este campo, así que esta parte es propia de JointTex.

Cómo hacerlo

1. Da a engine el valor typst. Los archivos sin nombre pasan a ser main.typ, snippet-2.typ, etc.
2. Sin el campo engine, un archivo terminado en .typ es el principal cuando no se envía ningún .tex; también puede indicarlo main_document.
3. El código Typst nunca se envuelve en un documento: cualquier texto Typst compila tal cual.

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

Lo que ve tu lector

El código nunca se convierte en proyecto por sí solo: el lector lo revisa primero.

Cómo hacerlo

1. El formulario lleva al lector a una página de JointTex que muestra los archivos, el archivo principal, el motor y la dirección de tu sitio.
2. Un lector con la sesión iniciada pone nombre al proyecto y elige Crear proyecto. Un lector nuevo crea una cuenta o inicia sesión y vuelve a la misma página.
3. El proyecto es del lector y es privado. Volver a elegir Crear proyecto, recargar o ir atrás abre el mismo proyecto, no una segunda copia.
4. El código se queda 7 días en el navegador del lector, no en los servidores de JointTex: no se guarda nada allí hasta que el lector crea el proyecto. En una ventana privada, o en un navegador que no guarda nada del sitio, dura solo lo que la pestaña.

Límites

Un envío está pensado para un ejemplo didáctico, no para una tesis completa.

Cómo hacerlo

1. Como máximo 20 archivos, 256 KB cada uno y 512 KB en total, contados en UTF-8.
2. Solo texto: se rechazan los archivos adjuntos y snip_uri o zip_uri (que piden descargar un archivo de una URL).
3. Cuando el formulario envía algo que JointTex no puede abrir, el lector llega a una página que explica el motivo.