> 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/creating-content/reusable-content.md). # Contenu réutilisable {% hint style="info" %} Cette fonctionnalité est disponible sur [Offres Pro et Entreprise](https://www.gitbook.com/pricing). {% endhint %} Le contenu réutilisable vous permet de synchroniser du contenu entre plusieurs pages et sections, afin que vous puissiez modifier toutes les instances du bloc en même temps.
A GitBook screenshot showing reusable content

Créez du contenu réutilisable au sein d’une section.

## Principes fondamentaux 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 n’importe quel 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 apparaîtront instantanément dans toutes les instances, toutes les modifications doivent provenir de la section parente — soit sous forme de 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 fondée sur les autorisations, 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. ### Limitations connues #### Intégrations Les blocs fournis par les intégrations ne sont pas pris en charge dans le contenu réutilisable. En effet, les intégrations dans GitBook sont installées par section, et la restriction d’accès garantit que les intégrations tierces n’ont que les autorisations que vous leur accordez. Référencer du contenu réutilisable entre sections briserait 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 à lever 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 **menu Actions** The Actions menu icon in GitBook , sélectionnez **Convertir en**, et 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 aussi 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 **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 depuis une autre section ne transfère pas la propriété. Seule la section parente peut modifier le contenu réutilisable. Les mises à jour provenant de cette section parente continuent d’être synchronisées dans chaque instance. ### **Modifier le contenu réutilisable** Le contenu réutilisable est comme n’importe quel autre contenu — vous pouvez modifier directement n’importe quelle instance si les modifications en direct sont activées, ou via une demande de modification dans le cas contraire. 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 instances une fois cette demande de modification fusionnée. ### **Dissocier le contenu réutilisable** Vous pouvez dissocier le contenu réutilisable en ouvrant **menu Actions** The Actions menu icon in GitBook et en sélectionnant **Dissocier**. La dissociation convertira le contenu en blocs ordinaires. Une fois dissocié, toutes les modifications que vous apportez au(x) bloc(s) ne se refléteront pas dans les autres instances, et les modifications que vous apportez dans ces instances ne se refléteront pas dans le(s) bloc(s) dissocié(s). Toutes les autres instances du contenu réutilisable restent synchronisées entre elles. ### Supprimer le contenu réutilisable Si vous le souhaitez, vous pouvez supprimer entièrement le contenu réutilisable de votre section. Trouvez le contenu réutilisable dans la table des matières de la page, puis ouvrez **menu Actions** The Actions menu icon in GitBook à 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 ne peut pas être annulée. ## Synchronisation avec GitHub et GitLab Le contenu réutilisable est entièrement pris en charge lors de la synchronisation vers GitHub et GitLab. Votre contenu réutilisable sera exporté vers un dossier `includes` dédié, chaque contenu étant un fichier Markdown séparé. Votre contenu est ensuite référencé dans vos autres pages à l’aide de la directive `includes` . {% hint style="info" %} Lors de la synchronisation, le `.gitbook/includes` répertoire est créé à la racine de chaque section synchronisée (qui peut ne pas être la racine de tout le 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 côté GitHub, assurez-vous que le chemin vers l’inclusion 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/creating-content/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.