Passer au contenu principal
Placez un lien sur votre site web, votre blog ou votre page de cours. Toute personne qui clique dessus obtient son propre nouveau projet avec vos fichiers. Aucune configuration n’est nécessaire. Les visiteurs ont besoin d’un compte sur votre instance. Un visiteur non connecté passe d’abord par la page de connexion, et le projet s’ouvre après la connexion. Les pages de cette fonctionnalité utilisent le nom Overleaf. Votre propre lien ou bouton peut afficher n’importe quel texte, par exemple Open in Ayakaleaf.

Voir les exemples

Ouvrez /devs sur votre site, par exemple https://ayakaleaf.example.com/devs. Aucun menu ne renvoie vers cette page, saisissez donc l’adresse. Par défaut, vous devez être connecté pour la voir.
La page Overleaf API avec les boutons A LaTeX code snippet et A zipped project

La page Overleaf API

Cliquez sur A LaTeX code snippet ou A zipped project. Un nouveau projet s’ouvre avec l’exemple.
Le projet I am a Zip file avec main.tex, main2.tex et sample.bib, et son PDF

Le projet issu de l'exemple zippé

1

Construire le lien

Placez l’adresse du fichier, encodée pour URL, après /docs?snip_uri= :
Pour un projet zippé, utilisez zip_uri :
Votre instance télécharge le fichier, il doit donc être accessible en HTTP ou HTTPS. Les adresses d’un réseau privé sont refusées, voir External URL.
2

L'ajouter à votre page

3

Cliquer dessus

Le nouveau projet s’ouvre dans l’éditeur, avec un seul fichier enregistré sous le nom main.tex.
Le projet Hello from a link dans l'éditeur, avec main.tex et son PDF

Un projet ouvert depuis un lien

Chaque clic crée un autre projet. Le projet est une copie, les modifications ultérieures de votre fichier ne l’atteignent donc pas.
Pour un petit fichier, vous n’avez rien à héberger : mettez son contenu dans le lien sous forme d’URL de données Base64. En JavaScript :
btoa n’accepte que les caractères Latin-1, encodez donc d’abord tout autre texte en UTF-8. Pour un projet zippé, utilisez zip_uri et data:application/zip;base64,. Un lien de plus de 8 Ko environ est refusé avec l’erreur 414 Request-URI Too Large. Pour un contenu plus volumineux, hébergez le fichier ou utilisez un formulaire.

Choisir les options

Ajoutez ces paramètres au lien, ou au formulaire sous forme de champs masqués : Un fichier .tex sans \documentclass est enveloppé dans un document standard, il compile donc immédiatement :
Un formulaire envoie les mêmes paramètres qu’un lien :
Pour envoyer le LaTeX lui-même, utilisez snip pour du texte brut ou encoded_snip pour du texte passé par encodeURIComponent. Un formulaire ne fonctionne pas toujours, c’est pourquoi un lien est le meilleur choix, sauf si votre fichier est trop long pour tenir dans un lien : Si votre administrateur définit OVERLEAF_ALLOW_PUBLIC_ACCESS=true, le projet s’ouvre dans tous ces cas, après connexion si nécessaire. Ce paramètre ouvre aussi d’autres pages aux visiteurs déconnectés, voir Page Access. Pour les autres réglages accessibles aux administrateurs, voir Overleaf Import API. La page /devs contient d’autres exemples.

Si le projet ne s’ouvre pas

La page indique ce qui n’a pas fonctionné. View the Overleaf API docs vous mène à /devs.
La page Open in Overleaf avec le message invalid url et le bouton View the Overleaf API docs

Un lien que l'instance ne peut pas utiliser

Dernière modification le 20 novembre 2026