> For the complete documentation index, see [llms.txt](https://smedai.aivd.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smedai.aivd.ch/applications/gitbook/creer/contenu-reutilisable.md).
# Contenu réutilisable
Le contenu réutilisable vous permet de synchroniser du contenu sur plusieurs pages et espaces, afin que vous puissiez modifier toutes les instances du bloc en même temps.
Créer du contenu réutilisable dans un espace.
## Notions de base
Le contenu réutilisable fonctionne comme n’importe quel autre contenu — vous pouvez le modifier via des demandes de modification, l’inclure dans des flux de révision, et il s’affichera correctement sur tout site publié.
Bien que le contenu réutilisable puisse être référencé dans plusieurs espaces, il appartient à un seul *espace parent*.
### Le concept d’« espace parent »
L’espace parent est l’espace qui possède le contenu réutilisable. C’est le seul endroit où ce contenu peut être édité.
Même si les mises à jour du contenu réutilisable apparaîtront instantanément dans toutes les instances, toutes les modifications doivent provenir de l’espace parent — soit par une édition directe, soit via une demande de modification.
Les espaces sont un concept central dans GitBook, prenant en charge à la fois les flux éditoriaux et la sécurité. Comme GitBook applique l’édition basée sur les permissions, le contenu réutilisable ne peut être modifié que depuis son espace parent. Cela garantit que les droits d’édition sont respectés, même lorsque le contenu est réutilisé à travers l’organisation.
### Limitations connues
#### Intégrations
Les blocs fournis par des intégrations ne sont pas pris en charge dans le contenu réutilisable. En effet, les intégrations dans GitBook sont installées par espace, et limiter l’accès garantit que les intégrations tierces n’ont que les permissions que vous accordez. Référencer du contenu réutilisable à travers des espaces briserait cette frontière de sécurité.
#### Recherche
Actuellement, le contenu réutilisable n’apparaît dans les résultats de recherche que dans son espace parent. Nous travaillons activement à lever cette limitation afin que le contenu réutilisable apparaisse dans les résultats de recherche où qu’il soit 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](https://gitbook.com/docs/documentation/fr/blocks#selecting-blocks-and-interacting-with-selected-blocks), puis ouvrez le **menu Actions**  , sélectionnez **Transformer en**, et choisissez **Contenu réutilisable**. Vous pouvez également donner un nom à votre bloc pour le retrouver et le réutiliser plus facilement par la suite.
Alternativement, vous pouvez 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 vous le feriez pour n’importe quel autre bloc. Appuyez sur `/` sur une ligne vide pour ouvrir la **palette d’insertion** et recherchez votre contenu par son nom ou en recherchant simplement « reusable ». Alternativement, cliquez sur le `+` à gauche de n’importe quel bloc ou ligne vide.
Vous trouverez également le panneau de contenu réutilisable dans la barre latérale des pages, où vous pouvez trouver une liste des blocs de contenu précédemment créés dans votre espace actuel.
### **Modifier du contenu réutilisable**
Le contenu réutilisable est comme n’importe quel autre contenu — vous pouvez modifier n’importe quelle instance directement si [les modifications en direct](https://gitbook.com/docs/documentation/fr/collaboration/live-edits) sont activées, ou via [une demande de modification](https://gitbook.com/docs/documentation/fr/collaboration/change-requests) si ce n’est pas le cas. Toutes les modifications que vous effectuez seront synchronisées partout où le contenu est utilisé.
Si vous effectuez des modifications dans le cadre d’une demande de modification, le contenu sera synchronisé dans toutes les autres instances une fois que cette demande aura été fusionnée.
### **Détacher le contenu réutilisable**
Vous pouvez détacher le contenu réutilisable en ouvrant le **menu Actions**  et en sélectionnant **Détacher**. Le détachement convertira le contenu en blocs ordinaires.
Une fois détachés, les modifications que vous apportez au(x) bloc(s) ne seront pas reflétées dans les autres instances, et les modifications effectuées dans ces instances ne seront pas reflétées dans le(s) bloc(s) détaché(s). Toutes les autres instances du contenu réutilisable restent synchronisées entre elles.
### Supprimer le contenu réutilisable
Vous pouvez supprimer complètement le contenu réutilisable de votre espace, si vous le souhaitez. Trouvez 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 & GitLab
Le contenu réutilisable est entièrement pris en charge lors de la synchronisation avec GitHub & GitLab. Votre contenu réutilisable sera exporté vers un `dossier includes` , chaque contenu étant un fichier Markdown séparé.
Votre contenu est ensuite référencé dans vos autres pages en utilisant la `dossier includes` directive.
{% hint style="info" %}
Lors de la synchronisation, le `répertoire .gitbook/includes` est créé à la racine de chaque espace synchronisé (qui n’est pas forcément la racine de l’ensemble du dépôt). Si votre `répertoire .gitbook/includes` dossier ou ses fichiers apparaissent dans la table des matières de votre espace, vous devrez peut-être les masquer manuellement du TOC.
{% endhint %}
#### Exemple
{% hint style="success" %}
Si vous écrivez du côté GitHub, assurez-vous que le chemin vers 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://smedai.aivd.ch/applications/gitbook/creer/contenu-reutilisable.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
