# 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.
A GitBook screenshot showing reusable content

Créez du contenu réutilisable au sein d’un espace.

## 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 n’importe quel 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 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 l’espace parent — soit sous forme de modification directe, soit via une demande de modification. Les espaces sont un concept central dans GitBook, prenant 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 son espace parent. 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 des intégrations ne sont pas pris en charge dans le contenu réutilisable. En effet, dans GitBook, les intégrations sont installées par espace, 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 différents espaces romprait 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 à 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](/docs/documentation/fr/creating-content/blocks.md#selecting-blocks-and-interacting-with-selected-blocks), puis ouvrez **menu Actions** The Actions menu icon in GitBook , sélectionnez **Transformer 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 également 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** et rechercher votre contenu par son nom ou simplement en recherchant « réutilisable ». Sinon, cliquez sur `+` à 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 voir une liste des blocs de contenu créés précédemment dans votre espace actuel. ### **Modifier du contenu réutilisable** Le contenu réutilisable est comme n’importe quel autre contenu — vous pouvez modifier directement n’importe quelle instance si [modifications en direct](/docs/documentation/fr/collaboration/live-edits.md) sont activées, ou via [une demande de modification](/docs/documentation/fr/collaboration/change-requests.md) si ce n’est pas le cas. Toutes les modifications que vous effectuez 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 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 classiques. Une fois dissocié, toute modification que vous apportez au(x) bloc(s) ne sera pas répercutée dans les autres instances, et les modifications apportées dans ces instances ne seront pas répercutées 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 Vous pouvez supprimer entièrement le contenu réutilisable de votre espace, si vous le souhaitez. Repérez 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 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é dans un dossier `includes` dédié, chaque contenu étant un fichier Markdown distinct. 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 répertoire `.gitbook/includes` est créé à la racine de chaque espace synchronisé (qui peut ne pas être la racine de l’ensemble du dépôt). Si votre dossier `.gitbook/includes` ou ses fichiers apparaissent dans la table des matières de votre espace, vous devrez peut-être les masquer manuellement de 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 de 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: 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: ``` GET https://gitbook.com/docs/documentation/fr/creating-content/reusable-content.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.