> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/fr/configuration/overleaf-toolkit/templates.md).

# Modèles

{% hint style="info" %}
Cette fonctionnalité a d'abord été développée par [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), puis 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é de la galerie de modèles est contrôlée à l'aide des variables d'environnement suivantes :

* `OVERLEAF_TEMPLATE_GALLERY`: Définir sur `true` pour activer la galerie de modèles.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Une liste facultative de zéro ou plusieurs clés de catégories de modèles, séparées par des espaces. 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 ajoutée automatiquement. 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 trait d'union (`-`), remplacez-le par un tiret bas (`_`) dans les noms de variables d'environnement.
* `ENABLE_CONVERSIONS`: Doit être défini sur `true` pour activer la génération des miniatures et des aperçus pour les modèles.

### Autorisations de 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 cela, 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 compile.
2. Dans le menu de gauche de l'éditeur, choisissez **Publier comme 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.

Une fois soumis, 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
#################
#   MODÈLES   #
#################

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 scientifiques, y compris des formats pour les principaux éditeurs et serveurs de prépublication.

TEMPLATE_BIBLIOGRAPHY_NAME=Bibliographies
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Styles pour créer et gérer des bibliographies avec BibTeX ou BibLaTeX. Adaptés à 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 les 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 de la correspondance officielle.

TEMPLATE_HOMEWORK_NAME=Devoirs
TEMPLATE_HOMEWORK_DESCRIPTION=Modèles pour les devoirs, le travail de cours et les séries de problèmes. Conçus pour être clairs et bien structurés pour les étudiants et les enseignants.

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

TEMPLATE_POSTER_NAME=Affiches
TEMPLATE_POSTER_DESCRIPTION=Modèles pour affiches scientifiques et académiques, généralement utilisées dans des conférences et des 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 académiques et aux cours.

TEMPLATE_REPORT_NAME=Rapports
TEMPLATE_REPORT_DESCRIPTION=Modèles pour des 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 normes de mise en forme et de citation de l'institution.

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 moyen automatisé d'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 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 paquets LaTeX, ce qui entraînera très probablement des erreurs de paquets 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 moyen automatique d'installer les paquets manquants, nous disposons dans Server Pro d'un paramètre configurable qui permettra à vos utilisateurs de compiler des projets avec accès à davantage de paquets, 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ées conteneurs frères).

Afin de 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 paquets et polices les plus populaires et ont déjà été testées avec nos modèles de galerie.

Vous trouverez 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 par défaut de l'image TeX Live pour les nouveaux projets, dans la [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) section 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 [Modèle d'article pour IEEE Photonics Journal - Exemple de soumission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. Cliquez sur le **Ouvrir comme 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 dans le tableau de bord des projets et choisissez **Téléverser le projet**
6. Cliquez sur le **Sélectionner 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 l'utilisent.

### Questions-réponses

<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 l'enregistrons 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 le ProjectID associé à ce modèle, ce qui vous permettra de le mettre facilement à jour ultérieurement.

Si vous supprimez le projet correspondant, vous ne verrez pas le bouton « Admin : projet source » 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>Pour certains projets, pourquoi 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 fichiers zip et pdf, ce qui est généralement rapide. Cependant, nous devons aussi générer des miniatures pour le PDF afin qu'elles puissent être affichées dans les détails du modèle.

Le temps de génération des miniatures dépend généralement du contenu de la première page de votre PDF. Afin de 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 miniatures peut prendre 40 secondes, voire davantage ; veuillez patienter. 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://overleaf-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.
