> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/fr/configuration/overleaf-toolkit/templates.md).

# Modèles

{% hint style="info" %}
Cette fonctionnalité a été initialement développée par [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), et modifiée et optimisée par [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/4f6069e8113430223a1c87361cc6fe5c949612fd" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/d0ebea6a062d4f7bfd732e6f99cd820b39b27592" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Configuration

La fonctionnalité Galerie de modèles est contrôlée à l'aide des variables d'environnement suivantes :

* `OVERLEAF_TEMPLATE_GALLERY`: Définissez-la sur `true` pour activer la Galerie de modèles.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Une liste facultative, séparée par des espaces, de zéro ou plusieurs clés de catégorie de modèles. Les clés valides incluent :

  * *`academic-journal`*
  * *`book`*
  * *`presentation`*
  * *`poster`*
  * *`cv`*
  * *`homework`*
  * *`bibliography`*
  * *`calendar`*
  * *`formal-letter`*
  * *`report`*
  * *`thesis`*
  * *`newsletter`*

  La clé spéciale *`all`* est automatiquement ajoutée. Cette clé représente une catégorie qui inclut tous les modèles.

  Pour chaque clé de catégorie, les variables d'environnement facultatives suivantes peuvent être définies :

  * `TEMPLATE_<KEY>_NAME`: Le nom affiché de la catégorie de modèles.
  * `TEMPLATE_<KEY>_DESCRIPTION`: Une brève description de la catégorie.

  Si une clé de catégorie contient un tiret (`-`), remplacez-le par un soulignement (`_`) dans les noms des variables d'environnement.
* `ENABLE_CONVERSIONS`: Doit être défini sur `true` pour activer la génération de vignettes et d'aperçus pour les modèles.

### Autorisations pour la publication

Les administrateurs peuvent publier des modèles. Vous pouvez également attribuer à un utilisateur non administrateur la gestion des modèles sélectionnés affichés dans votre galerie locale à `/templates`.

Pour ce faire, vous devrez définir la variable d'environnement `OVERLEAF_TEMPLATES_USER_ID` dans `toolkit/config/variables.env` sur `l'ID` de l'utilisateur qui sera responsable de la gestion des modèles au sein de votre instance, par exemple :

```dotenv
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```

### Publication de modèles

Pour chaque modèle que vous souhaitez téléverser :

1. Créez un projet contenant le code source du modèle et assurez-vous qu'il se compile.
2. Dans le menu de gauche de l'éditeur, choisissez **Publier en tant que modèle**.
3. Dans le formulaire qui apparaît, saisissez les détails du modèle :
   * Le *Titre* doit être unique.
   * Le *Description* Le champ prend en charge le formatage Markdown.
   * Le *Auteur* Le champ accepte des liens au format Markdown.

Après soumission, les détails du modèle peuvent être modifiés, ou le modèle peut être supprimé via la page de la Galerie de modèles. Les utilisateurs peuvent gérer leurs propres modèles ; les administrateurs peuvent gérer n'importe quel modèle.

Voici un exemple :

{% code overflow="wrap" expandable="true" %}

```dotenv
#################
#   TEMPLATES   #
#################

ENABLE_CONVERSIONS=true

OVERLEAF_TEMPLATE_GALLERY=true
OVERLEAF_TEMPLATE_CATEGORIES=academic-journal book presentation poster cv homework bibliography calendar formal-letter report thesis newsletter

TEMPLATE_ACADEMIC_JOURNAL_NAME=Articles de revue
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Modèles pour les soumissions à des revues académiques, y compris des formats pour les grands éditeurs et les serveurs de prépublication.

TEMPLATE_BIBLIOGRAPHY_NAME=Bibliographies
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Styles pour créer et gérer des bibliographies avec BibTeX ou BibLaTeX. Convient pour une utilisation dans des articles académiques, des thèses et des rapports.

TEMPLATE_BOOK_NAME=Livres
TEMPLATE_BOOK_DESCRIPTION=Modèles pour rédiger des livres ou des documents longs, y compris la structuration des chapitres, les pages liminaires et l'indexation.

TEMPLATE_CALENDAR_NAME=Calendriers
TEMPLATE_CALENDAR_DESCRIPTION=Modèles pour créer des calendriers annuels, mensuels ou hebdomadaires. Utiles pour des agendas personnels ou la planification d'événements.

TEMPLATE_CV_NAME=CV et résumés
TEMPLATE_CV_DESCRIPTION=Modèles de CV et de résumés avec divers formats pour des postes académiques, industriels et créatifs.

TEMPLATE_FORMAL_LETTER_NAME=Lettres formelles
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Modèles pour des lettres professionnelles, telles que des lettres de motivation, des lettres de recommandation et la correspondance officielle.

TEMPLATE_HOMEWORK_NAME=Devoirs
TEMPLATE_HOMEWORK_DESCRIPTION=Modèles pour les devoirs, les travaux dirigés et les séries d'exercices. Conçus pour être clairs et bien structurés pour les étudiants et les enseignants.

TEMPLATE_NEWSLETTER_NAME=Bulletins d'information
TEMPLATE_NEWSLETTER_DESCRIPTION=Modèles pour créer des bulletins d'information avec des formats destinés aux communications académiques, d'entreprise ou communautaires.

TEMPLATE_POSTER_NAME=Posters
TEMPLATE_POSTER_DESCRIPTION=Modèles pour posters scientifiques et académiques, généralement utilisés dans les conférences et les présentations de recherche.

TEMPLATE_PRESENTATION_NAME=Présentations
TEMPLATE_PRESENTATION_DESCRIPTION=Modèles pour Beamer et d'autres formats de présentation, adaptés aux exposés et cours académiques.

TEMPLATE_REPORT_NAME=Rapports
TEMPLATE_REPORT_DESCRIPTION=Modèles pour rapports techniques, de laboratoire ou de projet. Inclut des sections pour les figures, les tableaux et les références.

TEMPLATE_THESIS_NAME=Thèses
TEMPLATE_THESIS_DESCRIPTION=Modèles pour rédiger des thèses et des dissertations, en respectant les règles de mise en forme et de citation de l'établissement.

TEMPLATE_ALL_NAME=Tous les modèles
TEMPLATE_ALL_DESCRIPTION=Parcourez une collection de tous les modèles LaTeX disponibles, classés par type de document, style et objectif.

```

{% endcode %}

### Transfert de modèles depuis overleaf.com <a href="#transferring-templates-from-overleaf.com" id="transferring-templates-from-overleaf.com"></a>

Comme Overleaf Pro a été conçu pour fonctionner hors ligne, il n'existe pas de méthode automatisée pour intégrer [overleaf.com](https://www.overleaf.com/) les modèles de la galerie dans votre installation sur site, il est toutefois possible de le faire manuellement, modèle par modèle.

Par défaut, Overleaf Pro est configuré pour utiliser une version de schéma de base de TeXLive pour les compilations. Cette version de base est légère et ne contient qu'un sous-ensemble très limité de packages LaTeX, ce qui entraînera très probablement des erreurs de packages manquants pour vos utilisateurs lorsqu'ils tenteront d'utiliser des modèles provenant de [overleaf.com](https://www.overleaf.com/) sur votre instance locale sur site.

Malheureusement, bien qu'il n'existe pas de méthode automatique pour installer les packages manquants, nous disposons dans Server Pro d'un paramètre configurable qui permettra à vos utilisateurs de compiler des projets avec accès à davantage de packages, et de manière plus sécurisée. Cette fonctionnalité s'appelle [Compilations sandbox](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (également appelés conteneurs frères).

Pour garantir que les modèles téléchargés sont compatibles avec votre instance Server Pro sur site, nous vous recommandons vivement d'activer [Compilations sandbox](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) car cette fonctionnalité donnera à vos utilisateurs accès au même environnement TeX Live que celui de [overleaf.com](https://www.overleaf.com/). Ces images contiennent les packages et polices les plus populaires et ont déjà été testées avec nos modèles de galerie.

Vous pouvez trouver des informations supplémentaires sur la configuration des versions de TeX Live que les utilisateurs peuvent choisir dans leur projet, ainsi que sur la définition de la version d'image TeX Live par défaut pour les nouveaux projets, dans la section [Modification de l'image TeX Live](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) de notre documentation.

1. Accédez à la [Galerie de modèles](https://www.overleaf.com/latex/templates) sur [overleaf.com](https://www.overleaf.com/) et localisez le modèle requis, par exemple [IEEE Photonics Journal Paper Template - Example Submission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. Cliquez sur le **Ouvrir en tant que modèle** bouton
3. Cliquez sur le menu du projet et choisissez **Télécharger le code source**
4. Ensuite, connectez-vous au compte Server Pro sur site
5. Cliquez sur le **Nouveau projet** bouton depuis le tableau de bord des projets et choisissez **Téléverser le projet**
6. Cliquez sur le **Sélectionnez un fichier .zip** bouton et choisissez le fichier zip du modèle téléchargé

L'utilisateur peut alors utiliser ce modèle nouvellement téléversé dans son propre compte ou, en tant qu'utilisateur des modèles, vous pouvez le publier pour que d'autres utilisateurs puissent l'utiliser.

### Q\&R

<details>

<summary>Puis-je supprimer le projet après avoir publié le modèle correspondant ?</summary>

**Réponse :** Oui, mais nous ne le recommandons pas. Lorsque vous publiez un modèle, nous prenons un instantané du projet et enregistrons le projet sous forme de fichier zip au moment de la publication. Cela garantit que même si vous supprimez le projet correspondant au modèle, le modèle ne sera pas affecté.

Cependant, nous enregistrerons également l'identifiant du projet associé à ce modèle, ce qui vous permettra de mettre à jour facilement le modèle à l'avenir.

Si vous supprimez le projet correspondant, vous ne verrez pas le bouton "Admin: Source Project" sur la page des détails du modèle (voir l'image ci-dessous).

<figure><img src="/files/c0111990b96133f0063733c3eb5b928c124c4a96" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Pourquoi, pour certains projets, la publication d'un modèle prend-elle autant de temps ?</summary>

**Réponse :** Lorsque vous publiez le modèle, nous enregistrons le projet sous forme de fichier zip et de fichier pdf, ce qui est généralement rapide. Cependant, nous devons également générer des vignettes pour le PDF afin qu'elles puissent être affichées dans les détails du modèle.

Le temps de génération des vignettes dépend généralement du contenu de la première page de votre PDF. Pour trouver un équilibre entre la qualité d'affichage et le temps de conversion, nous choisissons une valeur intermédiaire pour la largeur.

Cependant, si la première page du PDF contient beaucoup de texte, la conversion des vignettes peut prendre 40 secondes, voire davantage ; veuillez être patient. Voici un exemple de grande affiche, cela prendra plus de temps.

<figure><img src="/files/220a418f405fe5761a63d8d11558cb810a4ea995" alt="" width="188"><figcaption><p>Une grande affiche</p></figcaption></figure>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/fr/configuration/overleaf-toolkit/templates.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
