Overleaf

Tant que vous utilisez Overleaf, votre propre ordinateur ne compose jamais rien. Overleaf est la fenêtre côté navigateur sur une installation TeX Live qui tourne sur les serveurs d'Overleaf, et presque toutes les différences avec une installation LaTeX de bureau découlent de ce seul fait : au lieu de mettre TeX Live à jour, on choisit une année par projet, on ne peut pas installer un package manquant avec tlmgr, on ne tape jamais soi-même un drapeau de compilation, et faire entrer ou sortir un manuscrit passe par le téléversement, le téléchargement ou git. En échange, on obtient la seule chose qu'une installation locale ne sait pas faire : deux personnes qui écrivent dans la même ligne en même temps. Cette page suit ces contraintes et cette contrepartie dans l'ordre où on les rencontre.

Ce que change l'absence de TeX sur votre machine

D'abord, vous ne pouvez pas ajouter de packages vous-même. Les serveurs d'Overleaf portent un TeX Live complet — chaque édition contient plus de cinq mille packages —, mais rien ne permet à un utilisateur de lancer tlmgr install pour ce qui n'y figure pas. La voie de rechange consiste à déposer le .sty ou le .cls dans le projet, et l'emplacement obéit à une règle : le processus de compilation ne trouve ces fichiers que s'ils se situent au niveau supérieur du projet. Pour les ranger dans un dossier, il faut créer un latexmkrc au niveau supérieur et y rediriger TEXINPUTS.

# latexmkrc at the top level of the project
# look in tex/ and bst/ before the system tree
$ENV{'TEXINPUTS'} = './tex//:' . $ENV{'TEXINPUTS'};
$ENV{'BSTINPUTS'} = './bst//:' . $ENV{'BSTINPUTS'};

Le simple fait qu'un latexmkrc produise un effet révèle la structure d'Overleaf : la compilation est conduite par latexmk. Ce fichier est donc aussi le seul levier lorsqu'on veut ajouter un drapeau de compilation. En pratique l'envie survient moins souvent qu'on ne croit : minted, qui réclame d'ordinaire -shell-escape, fonctionne « out of the box » sur Overleaf selon leurs propres termes, parce que le côté serveur est déjà arrangé pour lui. L'édition communautaire auto-hébergée, elle, désactive \write18 par défaut, au motif que toutes les compilations y tournent dans le même conteneur. Deux produits sous un même nom, avec des réglages par défaut opposés pour l'appel de programmes externes.

« Ça compile sur Overleaf mais pas chez moi » : l'année de TeX Live

La cause habituelle de cet écart n'est pas l'éditeur mais l'année de la distribution. Sur Overleaf, la version de TeX Live est un réglage par projet : cliquez sur l'icône d'engrenage, allez dans Compiler, et choisissez dans le menu déroulant TeX Live version juste en dessous. L'année retenue pour un projet n'affecte jamais un autre. Les éditions plus anciennes sont regroupées sous Legacy ; Overleaf les dit lui-même « non recommandées pour de nouveaux projets », mais les conserve pour que les anciens modèles compilent encore. Le basculement n'est pas définitif : on peut revenir en arrière à tout moment.

Ce choix de conception mérite d'être retenu, ne serait-ce que pour accuser le bon coupable. Une figure qui casse sur l'écran d'un coauteur, un modèle de soumission qui compilait l'an dernier et plus aujourd'hui : la première chose à comparer n'est ni l'éditeur ni une version de package, mais l'année de TeX Live de chaque côté. À l'inverse, dès que vous, vos coauteurs et la revue visée êtes sur la même année, cette variable quitte la discussion. Notez aussi qu'Overleaf adopte un nouveau TeX Live après l'avoir testé : peu après une publication en amont, la valeur par défaut peut encore être celle de l'année précédente.

Créer un projet : l'ordre de la première heure

Tout se passe à l'intérieur d'un projet. New Project, en haut à gauche du tableau de bord, propose un Blank Project vierge, From Template pour partir de la galerie, Upload Project pour importer un .zip local et Import from GitHub. Quel que soit le choix, on atterrit dans l'éditeur, en trois volets : liste des fichiers à gauche, source au milieu, PDF à droite. Parce que tout démarre dans un navigateur, on est tenté de toucher aux modèles, à la collaboration, à Git et aux figures en même temps — mais l'ordre qui évite les accidents est fixé : d'abord seul, et seulement jusqu'à ce qu'un corps de texte minimal devienne fiablement un PDF.

• Choisir un projet vierge ou le modèle de la revue visée, et repérer quel fichier est le point d'entrée — le plus souvent main.tex.
• Avant de réécrire un mot du corps, appuyer une fois sur Recompile et vérifier que l'état de départ produit bien un PDF.
• Fixer le Compiler et la TeX Live version dans le Menu, et désigner explicitement le Main document au moindre doute.
• Si vous écrivez en japonais, trancher tôt entre LuaLaTeX et une voie pLaTeX/upLaTeX pilotée par latexmkrc.
• N'inviter des collaborateurs qu'une fois le fichier racine, le compilateur et la politique bibliographique arrêtés.
• Avant la soumission, télécharger un ZIP afin de disposer d'une copie reproductible en local.

Quel Compiler choisir, et ce que « LaTeX » signifie ici

Le menu déroulant ne compte que quatre entrées : pdfLaTeX par défaut, plus LaTeX, XeLaTeX et LuaLaTeX. Le choix ne vaut que pour ce projet. Deux axes le déterminent : la manière dont vous voulez traiter les polices et le format de vos figures. pdfLaTeX accepte .png, .jpg et .pdf, et convertit les .eps à la volée ; XeLaTeX et LuaLaTeX gèrent directement l'Unicode et les polices système (OpenType/TrueType) et ne font pas la fine bouche sur les formats d'image.

Un nom prête ici à confusion. L'entrée LaTeX du menu déroulant ne désigne pas la commande latex nue, mais la route qui passe par le DVI jusqu'au PDF, en appelant dvipdfmx en interne. D'où des figures limitées à .eps et .ps, sans possibilité de déposer un .png. À l'inverse, le flux japonais pLaTeX décrit plus bas commence par la sélection de ce « LaTeX ». Choisissez également LaTeX ou XeLaTeX s'il vous faut pstricks — LuaLaTeX ne le prend pas en charge. Quel fichier est le point d'entrée du corps relève du réglage Main document, modifiable depuis l'icône à trois points de la liste des fichiers.

Composer du japonais : LuaLaTeX ou pLaTeX via latexmkrc

Le pdfLaTeX par défaut ne compose pas le japonais. Tapez du japonais sans préparation et vous obtenez une erreur ou des caractères évanouis. Deux voies : (1) passer le Compiler à LuaLaTeX, ou (2) piloter pLaTeX/upLaTeX par un latexmkrc. Pour un démarrage à neuf, (1) est la plus douce, et la configuration tient pour l'essentiel en une ligne. Réglez le Compiler sur LuaLaTeX dans le Menu et nommez une classe luatexja dans \documentclass — ltjsarticle ou ltjarticle pour la composition horizontale — et la composition japonaise est en place. Sans police explicite, une valeur par défaut raisonnable est incorporée ; luatexja-preset permet d'incorporer les polices IPAex.

% Menu -> Compiler -> LuaLaTeX before compiling this file
\documentclass{ltjsarticle}
\usepackage[ipaex]{luatexja-preset}
\begin{document}
\section{はじめに}
こんにちは、\LaTeX！ 数式も書けます: $e^{i\pi}+1=0$
\end{document}

Pour écrire selon le flux pLaTeX encore dominant dans les revues japonaises, réglez le Compiler sur « LaTeX » et ajoutez au niveau supérieur du projet un fichier nommé latexmkrc. Comme Overleaf compile avec latexmk, c'est là qu'on lui dit : « traite ceci avec platex, puis fabrique le PDF avec dvipdfmx ». Pour upLaTeX, remplacez platex par uplatex et pbibtex par upbibtex. Option relativement récente : la classe jlreq, utilisable indifféremment avec LuaLaTeX, pLaTeX ou upLaTeX.

# latexmkrc for the pLaTeX route; set Compiler to LaTeX in the Menu
$latex = 'platex';
$bibtex = 'pbibtex';
$dvipdf = 'dvipdfmx %O -o %D %S';
$makeindex = 'mendex %O -o %D %S';

Si vous préférez éviter tout ce réglage, le Cloud LaTeX japonais compose le japonais sans la moindre configuration, et mérite considération pour un manuscrit essentiellement japonais. Autre remarque : le clic qui fait passer de l'éditeur au PDF sur Overleaf, c'est aussi SyncTeX, et chaque compilation écrit un output.synctex.gz sur le serveur — les sorties s'appellent output.* et non du nom de votre fichier principal parce que c'est ainsi que la compilation d'Overleaf est agencée. Ces sauts ne fonctionnent toutefois pas si le réglage de la visionneuse PDF est sur « Browser ».

Faire entrer et sortir un manuscrit : ZIP, GitHub et le pont Git

Si le brouillon est déjà sur le disque, Upload Project est le chemin le plus court : déposez un .zip et Overleaf le décompresse en recréant votre arborescence sous forme de projet. Les limites sont toutefois précises. L'archive ne peut contenir que des fichiers qu'un compilateur LaTeX sait traiter — du texte brut et des images en .eps, .pdf, .svg et .png ; la matière éditable est plafonnée à 7 Mo ; aucun fichier isolé ne peut dépasser 50 Mo ; et un envoi porte au plus 180 fichiers. Un .docx de Word ou un jeu de données volumineux n'y entrera tout simplement pas. Le piège inattendu : cela ne fonctionne pas si votre document principal se trouve dans un dossier. Si tout le zip est enveloppé dans un seul répertoire, remontez le contenu d'un cran et recompressez.

Si le manuscrit vit dans Git, deux routes s'offrent. Import from GitHub — après avoir lié un compte GitHub dans Account Settings — transforme un dépôt visible en projet, après quoi on peut pousser et tirer entre Overleaf et le dépôt. L'autre est le pont Git, qui court-circuite le service d'hébergement et permet un git clone directement depuis git.overleaf.com : l'adresse de clonage est l'URL du projet avec git à la place de www, et l'authentification se fait par jeton. Les deux sont des fonctions des offres payantes, et Overleaf ne prend en charge ni les sous-modules Git ni Git LFS. Un dépôt trop volumineux se heurte à la limite de taille et échoue à l'import.

Collaborer : les Editors comptent dans votre offre, pas les Viewers

Le plus grand atout d'Overleaf est la véritable édition simultanée. Invitez depuis Share en haut à droite et vous ouvrez le même manuscrit ensemble, les curseurs et les modifications des autres apparaissant en direct. Deux façons d'inviter : par adresse électronique, en choisissant Editor ou Viewer, ou en distribuant un lien via Link Sharing. Link Sharing émet deux sortes d'URL : qui détient le lien View peut lire, qui détient le lien Edit peut modifier — l'édition exige la création d'un compte.

C'est ici que le nombre de personnes compte. Les Viewers n'entament jamais la limite, mais les Editors consomment le quota du propriétaire du projet. Au-delà de la limite, quiconque arrive par le lien d'édition bascule automatiquement en lecture seule. L'offre gratuite donne un collaborateur — à deux, on peut donc corédiger sans payer. Les offres payantes relèvent ce plafond : la page des limites d'Overleaf (consultée en août 2026) indique 10 pour Student et Standard, et un nombre illimité pour Pro.

Les outils de relecture et de révision se répartissent nettement entre gratuit et payant. Les commentaires dans le document fonctionnent en offre gratuite, mais le suivi des modifications — accepter ou refuser chaque changement individuellement — et l'historique complet des versions, qui rembobine le projet à un état antérieur, sont payants. Avoir besoin de ces deux-là lors d'une révision à plusieurs auteurs est ce qui fait généralement basculer vers un abonnement. Overleaf lui-même, soit dit en passant, a commencé vers 2012 sous le nom de WriteLaTeX, fondé par les mathématiciens John Hammersley et John Lees-Miller ; en juillet 2017, il a fusionné avec son rival ShareLaTeX, réunissant les deux communautés dans un seul environnement. L'agencement des fonctions que vous voyez à l'écran est le produit de ce confluent.

Quand la compilation expire

Puisque la compilation tourne sur les serveurs d'autrui, le temps a un plafond. La page des limites d'Overleaf (consultée en août 2026) accorde 10 secondes de compilation à l'offre gratuite et 240 secondes aux offres payantes. Une longue thèse, ou une figure TikZ ou pgfplots lourde, peut dépasser ce plafond et être interrompue. C'est une conséquence inévitable de l'écriture dans un navigateur : à mesure que le manuscrit grossit, mieux vaut traiter le projet moins comme un carnet de brouillon commode que comme un environnement de composition reproductible.

• Vérifier dans le Menu le Compiler, la TeX Live version et le Main document, et faire contrôler les mêmes réglages par les coauteurs.
• Si des figures TikZ/pgfplots lourdes ou des images haute résolution provoquent des expirations, précompiler les figures en PDF ou retirer temporairement un chapitre volumineux pour isoler la cause.
• Quand les erreurs se multiplient, désactiver Auto compile, passer à Stop on first error, et ne corriger que la première erreur avant de poursuivre la lecture.
• Des fichiers intermédiaires périmés peuvent semer le trouble : si quelque chose semble anormal, videz le cache du projet et recompilez.
• Juste avant la soumission, utiliser Download as ZIP et vérifier que le paquet reproduit le même PDF en local ou dans un projet distinct.

Ce qu'épargne le fait de partir d'un modèle

Ce que cela épargne, c'est le travail de se conformer après coup aux règles de soumission. La galerie d'Overleaf offre une multitude de points de départ — revues, actes de conférence, CV, thèses, diapositives — et l'on choisit un type dans New Project → Templates, ou l'on ouvre directement overleaf.com/gallery pour presser Open as Template sur un modèle qui plaît : un projet surgit dans ce style. Les modèles « officiels » des éditeurs et des sociétés savantes sont ceux qui rendent le plus service : ils portent d'emblée le fichier de classe et les règles de mise en page de la revue, et certains permettent de soumettre directement depuis Overleaf une fois le manuscrit prêt.

Un conseil pratique pour le choix : un modèle apporte non seulement une allure, mais aussi des hypothèses sur le Compiler et sur l'année de TeX Live. Appuyez une fois sur Recompile juste après l'ouverture, avant d'avoir changé un mot, et vérifiez qu'un PDF sort sous ces hypothèses ; ainsi vous n'aurez jamais à démêler ensuite « est-ce ce que j'ai écrit, ou le modèle est-il périmé ? ». On peut aussi soumettre son propre modèle à la galerie.