> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/creer-du-contenu/reusable-content.md).
# Contenu réutilisable
Créez des blocs de contenu réutilisables qui peuvent être utilisés dans plusieurs sections, et qui sont tous mis à jour en même temps lorsque vous modifiez une instance
Le contenu réutilisable vous permet de synchroniser le contenu sur plusieurs pages et sections, afin que vous puissiez modifier toutes les occurrences du bloc en même temps.
Créez du contenu réutilisable au sein d'une section.
## Notions fondamentales
Le contenu réutilisable fonctionne comme n'importe quel autre contenu : vous pouvez le modifier via des demandes de modification, l'inclure dans des workflows de relecture, et il s'affichera correctement sur tout site publié.
Bien que le contenu réutilisable puisse être référencé dans plusieurs sections, il appartient à une seule *section parente*.
### Le concept de « section parente »
La section parente est la section qui possède le contenu réutilisable. C'est le seul endroit où ce contenu peut être modifié.
Même si les mises à jour du contenu réutilisable apparaissent instantanément dans toutes les occurrences, toutes les modifications doivent provenir de la section parente, soit par une modification directe, soit via une demande de modification.
Les sections prennent en charge à la fois les workflows éditoriaux et la sécurité. Comme GitBook applique une édition basée sur les permissions, le contenu réutilisable ne peut être modifié que depuis sa section parente. Cela garantit que les droits de modification sont respectés, même lorsque le contenu est réutilisé dans toute l'organisation.
### Limites connues
#### Intégrations
Les blocs fournis par les intégrations ne sont pas pris en charge dans le contenu réutilisable. En effet, dans GitBook, les intégrations sont installées par section, et la limitation de l'accès garantit que les intégrations tierces n'ont que les permissions que vous leur accordez. Référencer du contenu réutilisable entre sections romprait cette frontière de sécurité.
#### Recherche
Actuellement, le contenu réutilisable n'apparaît dans les résultats de recherche que dans sa section parente. Nous travaillons activement à supprimer cette limitation afin que le contenu réutilisable apparaisse dans les résultats de recherche partout où il est référencé.
## Dans l'application
### **Créer du contenu réutilisable**
Pour créer du contenu réutilisable, sélectionnez un ou plusieurs blocs, puis ouvrez le **menu Actions** , sélectionnez **Convertir en**, puis choisissez **Contenu réutilisable**. Vous pouvez également donner un nom à votre bloc pour le retrouver et le réutiliser plus facilement plus tard.
Vous pouvez aussi sélectionner un ou plusieurs blocs, puis appuyer sur **Cmd + C** pour ouvrir une invite vous demandant si vous souhaitez créer du contenu réutilisable.
### **Insérer du contenu réutilisable**
Vous pouvez insérer du contenu réutilisable comme n'importe quel autre bloc. Appuyez sur `/` sur une ligne vide pour ouvrir la **palette d'insertion**. Vous pouvez également cliquer sur le `+` à côté de n'importe quel bloc ou ligne vide.
Le panneau de contenu réutilisable dans la barre latérale des pages répertorie les blocs de contenu créés précédemment dans votre section actuelle.
Pour insérer du contenu réutilisable depuis la section actuelle ou une autre section, vous pouvez accéder à :
1. Ouvrez le sélecteur de contenu réutilisable depuis le **palette d'insertion** ou `+` menu.
2. Utilisez le sélecteur de section en haut pour sélectionner la section source.
3. Recherchez le bloc réutilisable par son nom, puis sélectionnez-le pour l'insérer.
L'insertion de contenu provenant d'une autre section ne transfère pas la propriété. Seule la section parente peut modifier le contenu réutilisable. Les mises à jour de cette section parente continuent à se synchroniser dans chaque occurrence.
### **Modifier le contenu réutilisable**
Le contenu réutilisable est comme n'importe quel autre contenu : vous pouvez modifier directement n'importe quelle occurrence si les modifications en direct sont activées, ou via une demande de modification sinon. Toutes les modifications que vous apportez seront synchronisées partout où le contenu est utilisé.
Si vous apportez des modifications dans une demande de modification, le contenu sera synchronisé avec toutes les autres occurrences une fois cette demande de modification fusionnée.
### **Dissocier le contenu réutilisable**
Vous pouvez dissocier le contenu réutilisable en ouvrant le **menu Actions** et en sélectionnant **Dissocier**. La dissociation convertira le contenu en blocs ordinaires.
Une fois dissocié, les modifications que vous apportez au bloc ou aux blocs ne seront pas répercutées dans les autres occurrences, et les modifications que vous apportez dans ces occurrences ne seront pas répercutées dans le bloc dissocié. Toutes les autres occurrences du contenu réutilisable restent synchronisées entre elles.
### Supprimer le contenu réutilisable
Vous pouvez supprimer entièrement le contenu réutilisable de votre section si vous le souhaitez. Repérez le contenu réutilisable dans la table des matières de la page, puis ouvrez le **menu Actions** à côté du contenu que vous souhaitez supprimer, et sélectionnez **Supprimer**.
La suppression du contenu réutilisable va **le supprimer de toutes les pages où il est utilisé**. Cette action est irréversible.
## Synchronisation avec GitHub et GitLab
Le contenu réutilisable est entièrement pris en charge lors de la synchronisation avec GitHub et GitLab. Votre contenu réutilisable sera exporté vers un `includes` dossier dédié, chaque contenu étant un fichier Markdown distinct.
Votre contenu est ensuite référencé dans vos autres pages à l'aide de la `includes` directive.
{% hint style="info" %}
Lors de la synchronisation, le `.gitbook/includes` répertoire est créé à la racine de chaque section synchronisée (qui n'est peut-être pas la racine de l'ensemble du dépôt). Si votre `.gitbook/includes` dossier ou ses fichiers apparaissent dans la table des matières de votre section, vous devrez peut-être les masquer manuellement dans la table des matières.
{% endhint %}
#### Exemple
{% hint style="success" %}
Si vous écrivez du côté GitHub, assurez-vous que le chemin d'accès à l'include est relatif au fichier contenant la référence (et non à la racine du dépôt).
{% endhint %}
```markdown
{% include "../../.gitbook/includes/reusable-block.md" %}
```
---
# 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://gitbook.com/docs/documentation/fr/creer-du-contenu/reusable-content.md?ask=&goal=
```
`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.
