> 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 Le contenu réutilisable permet de synchroniser le contenu entre plusieurs pages et sections, afin que vous puissiez modifier toutes les occurrences du bloc en même temps.
A GitBook screenshot showing reusable content

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 revue, 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 occurrences, 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 basé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. ### Limites connues #### bouton 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 section, et la limitation de l'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 plusieurs 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 le **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. Sinon, 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 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 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 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 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 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 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** The Actions menu icon in GitBook et en sélectionnant **Dissocier**. La dissociation convertira le contenu en blocs classiques. Une fois dissocié, les modifications que vous apportez au(x) bloc(s) ne se répercuteront pas sur les autres occurrences, et les modifications que vous apportez dans ces occurrences ne se répercuteront pas sur le(s) bloc(s) dissocié(s). Toutes les autres occurrences du contenu réutilisable restent synchronisées entre elles. ### Supprimer le contenu réutilisable Vous pouvez, si vous le souhaitez, supprimer entièrement le contenu réutilisable de votre section. Retrouvez le contenu réutilisable dans la table des matières de la page, puis ouvrez le **menu Actions** The Actions menu icon in GitBook à côté du contenu que vous souhaitez supprimer, puis 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 vers GitHub et GitLab. Votre contenu réutilisable sera exporté dans un `inclut` 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 `inclut` directive. {% 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 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 côté GitHub, assurez-vous que le chemin d'accès à 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/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.