Centre d’aide
Des guides clairs et pratiques pour rédiger, compiler et partager des projets LaTeX et Typst.
Éditeur Typst en ligne et collaboratif
Éditeur Typst en ligne pour écrire à plusieurs en temps réel : le PDF se compile dans le navigateur à la frappe, avec paquets, citations et aide IA.
Créer un projet Typst
JointTex est un éditeur en ligne pour Typst comme pour LaTeX : un projet Typst s'écrit, se compile et se partage dans le navigateur, sans rien installer.
Étapes
- Ouvrez Projets, choisissez Nouveau projet et choisissez Typst sur la carte du projet vierge. Le projet démarre avec main.typ et un fichier references.bib que main.typ désigne déjà avec #bibliography.
- Ou partez d'un modèle Typst : un modèle est en LaTeX ou en Typst selon son fichier racine, et le projet que vous en créez se compile de la même façon.
- Importez un brouillon Word ou Markdown en Typst : choisissez Nouveau projet, puis Importer depuis des fichiers, sélectionnez le fichier .docx ou .md et choisissez Typst comme langage d'arrivée.
- Un projet peut contenir les deux langages. Son fichier racine décide lequel est compilé : un fichier racine .typ est compilé par Typst, et les paramètres du projet permettent de changer de fichier racine.
Voir le PDF pendant la frappe
Typst s'exécute dans la page de l'éditeur elle-même : le PDF suit votre frappe un instant après que vous vous arrêtez, sans bouton de compilation à presser.
Étapes
- Compiler automatiquement est activé dès le départ dans un projet Typst. La modification d'un collaborateur recompile aussi votre aperçu.
- Les erreurs et avertissements sont soulignés dans la source et listés dans l'onglet Problèmes, et le dernier PDF compilé reste affiché jusqu'à ce que l'erreur soit corrigée.
- Double-cliquez n'importe où dans le PDF, ou faites Cmd/Ctrl-clic, pour sauter à la source qui l'a produit, et appuyez sur {mod+j} pour sauter du curseur au PDF. Les positions viennent du compilateur Typst lui-même.
- L'équation sous le curseur s'affiche composée pendant que vous l'écrivez, et le Plan liste les titres du fichier ouvert.
- Dans un navigateur, Télécharger et imprimer compilent à nouveau sur le serveur avec la même version de Typst : le fichier que vous partagez est donc le PDF du projet lui-même.
Utiliser les paquets de Typst Universe
Les paquets publiés dans le registre de Typst fonctionnent comme partout ailleurs.
Étapes
- Importez un paquet avec #import "@preview/name:version". Il est récupéré la première fois qu'une compilation en a besoin.
- La compilation sur le serveur s'exécute sans accès au réseau, et peut quand même utiliser tout paquet publié sous @preview.
- Les paquets de l'espace de noms @local ne sont pas disponibles, car ils se trouvent sur l'ordinateur d'une seule personne. Placez plutôt les fichiers du paquet dans le projet et importez-les par leur chemin.
Citer depuis des fichiers .bib
Typst lit les mêmes fichiers .bib que LaTeX : le document en désigne un avec #bibliography et cite une entrée avec @key.
Étapes
- Appuyez sur {mod+alt+c}, ou choisissez Insérer une citation (@) dans la barre d'outils, pour chercher dans ce projet, votre bibliothèque, Crossref et d'autres sources en ligne, Zotero et vos anciens projets selon votre offre, et insérer @key avec l'entrée écrite dans le fichier .bib.
- Appuyez sur F2 sur un @key, ou sur la clé dans le fichier .bib ou .yml, pour la renommer : l'entrée et chaque citation suivent.
- Pour vérifier les entrées que vous citez auprès de Crossref et d'arXiv, ouvrez Vérifications du projet et choisissez Références.
Rédiger à plusieurs
Les coauteurs modifient un projet Typst en même temps, comme un projet LaTeX, et chaque modification garde son auteur.
Étapes
- Invitez vos coauteurs depuis la boîte de dialogue Partager ; chacun voit en direct les curseurs et les modifications des autres.
- Sélectionnez un passage et commentez-le, activez Suivre mes modifications dans Révision pour que vos changements arrivent en suggestions, et revenez à n'importe quelle version antérieure depuis l'Historique.
- Comparez deux versions dans un PDF annoté : typdiff souligne ce qui a été ajouté et barre ce qui a été supprimé dans chaque fichier .typ modifié.
Demander à l'assistant IA
L'assistant sait quand un projet est écrit en Typst et écrit du Typst.
Étapes
- Ouvrez le panneau IA et demandez un tableau, une figure, une règle show ou la correction d'une erreur de compilation.
- Avec Suivre les modifications activé, comme par défaut, chacune de ses modifications est signalée, pour que vous la gardiez ou l'écartiez une par une ou toutes à la fois.
- Depuis l'onglet Problèmes, demandez-lui d'expliquer ou de corriger une erreur ou toutes ; il modifie la source et compile à nouveau pour vérifier sa correction.
Travailler dans l'application de bureau et hors ligne
Un projet Typst n'a besoin d'aucune installation de TeX, ni dans le navigateur ni dans l'application de bureau.
Étapes
- Dans l'application de bureau, un projet Typst est compilé dans la fenêtre de l'application au fil de la frappe, et le PDF que vous enregistrez ou imprimez est ce même PDF, sans connexion.
- Dans le navigateur, un projet que vous avez ouvert est conservé pour un usage hors ligne : vous pouvez continuer d'écrire si la connexion tombe.
Ce qui ne fonctionne pour l'instant que dans les fichiers LaTeX
Quelques outils lisent ou écrivent de la source LaTeX et ne fonctionnent pas encore dans un fichier .typ.
Étapes
- « Mettre en forme le document » et Copier en tant que sont réservés aux fichiers .tex.
- La section Symboles mathématiques insère des commandes LaTeX, et la reconnaissance de formules à partir d'une capture d'écran est désactivée tant qu'un fichier .typ est ouvert.
- Un tableau ou une image collés dans un fichier .typ ne sont pas convertis : un tableau arrive en texte brut, et une image n'est pas enregistrée.