> 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/formatting/inline.md). # Contenu en ligne
A GitBook screenshot showing inline content options

Ajoutez des éléments en ligne à votre contenu.

La palette en ligne vous permet d’ajouter rapidement du contenu supplémentaire à votre bloc de texte sans retirer vos mains du clavier. Il suffit d’appuyer sur `/` sur n’importe quel bloc de texte pour ouvrir la palette en ligne. La barre oblique sera remplacée par le contenu que vous choisissez d’insérer. ## Annotations Avec les annotations, vous pouvez ajouter du contexte à vos mots sans interrompre le fil de lecture. Vous pouvez les utiliser pour expliquer le sens d’un mot, insérer des informations supplémentaires, et plus encore. Les lecteurs peuvent survoler le texte annoté pour afficher l’annotation au-dessus du texte. ### Créer une annotation Pour créer une annotation, sélectionnez le texte que vous souhaitez annoter et cliquez sur le **Annoter** option du menu contextuel. Une fois votre annotation rédigée, cliquez en dehors pour continuer à écrire dans le bloc de texte. ### Représentation Markdown Vous pouvez écrire du contenu sous forme de [notes de bas de page Markdown](https://www.markdownguide.org/extended-syntax/#footnotes) pour les ajouter en tant qu’annotations dans GitBook. Les indicateurs de note de bas de page doivent apparaître immédiatement après le mot que vous souhaitez annoter ; ils ne doivent pas apparaître après des signes de ponctuation ou d’autres symboles. ```markdown Voici une note de bas de page simple[^1], et voici une plus longue[^bignote]. [^1] : Ceci est la première note de bas de page. [^bignote] : En voici une avec plusieurs paragraphes et du code. Mettez les paragraphes en retrait pour les inclure dans la note de bas de page. `{ my code }` Ajoutez autant de paragraphes que vous le souhaitez. ``` ## Images Les images en ligne s’afficheront à côté de votre texte sur la page. Par défaut, les images sont définies à leur taille d’origine, avec une largeur maximale de 300 px. Vous pouvez modifier la taille en cliquant sur l’image pour ouvrir la palette de mise en forme, puis en choisissant l’une des trois options : 1. **Taille en ligne :** L’image est dimensionnée proportionnellement à la police — idéal pour les icônes et les badges. 2. **Taille d’origine :** L’image restera en ligne à sa taille d’origine, avec une largeur maximale de 300 pixels. 3. **Convertir en bloc :** Cela transforme une image en ligne en bloc d’image, dont la largeur correspond à celle de votre contenu. {% hint style="info" %} Les blocs d’image offrent davantage d’options, notamment plus de tailles et la possibilité d’ajouter une légende — mais ils ne s’afficheront pas en ligne avec votre texte. {% endhint %} ### Représentation en Markdown {% code overflow="wrap" %} ```markdown Voici une image en ligne : Dark version of GitBook logo ``` {% endcode %} ## Émojis Vous pouvez ajouter des émojis en appuyant sur `/` pour ouvrir la palette en ligne. Sinon, tapez `:` et une liste d’émojis s’affichera directement en ligne — vous pouvez commencer à saisir le nom d’un émoji pour affiner la sélection. ### Représentation en Markdown {% code overflow="wrap" %} ```markdown :house: :car: :dog: ``` {% endcode %} ## Liens Vous pouvez insérer trois types de liens différents : * [Liens relatifs](#relative-links) * [Liens absolus](#absolute-links) * [Adresse e-mail `mailto` liens](#email-address-mailto-links) ### Liens relatifs Les liens relatifs sont des liens créés en reliant des pages qui existent déjà dans votre section. L’avantage d’utiliser des liens relatifs est que si l’URL, le nom ou l’emplacement de la page change, sa référence restera à jour — vous obtiendrez donc moins de liens brisés. Voici comment insérer un lien relatif : 1. Cliquez à l’endroit de votre paragraphe où vous souhaitez insérer le lien, ou sélectionnez du texte. 2. Appuyez sur / pour ouvrir la palette en ligne et choisissez Lien, cliquez sur le **Lien** bouton dans le menu contextuel, ou appuyez sur **⌘ + K**. 3. Commencez à saisir le titre de la page vers laquelle vous souhaitez créer un lien. 4. Sélectionnez la page dans les résultats de recherche déroulants. 5. Appuyez sur `Entrée`. ### Liens absolus Les liens absolus sont des liens externes que vous pouvez copier et coller dans votre contenu. Ils sont parfaits lorsque vous souhaitez créer un lien vers quelque chose en dehors de votre documentation. Pour insérer un lien absolu : 1. Cliquez à l’endroit de votre paragraphe où vous souhaitez insérer le lien, ou sélectionnez du texte. 2. Appuyez sur / pour ouvrir la palette en ligne et choisissez Lien, cliquez sur le **Lien** bouton dans le menu contextuel, ou appuyez sur **⌘ + K**. 3. Collez l’URL vers laquelle vous souhaitez créer un lien. 4. Appuyez sur `Entrée`. {% hint style="info" %} **Pourquoi les liens externes ne s’ouvrent-ils pas dans un nouvel onglet ?** Lorsque vous ajoutez un lien vers un site externe dans votre documentation, il s’ouvrira dans le même onglet. GitBook suit ce [comportement recommandé par le W3C](https://www.w3.org/TR/WCAG20-TECHS/G200.html) afin de favoriser [l’accessibilité](https://it.wisc.edu/learn/make-it-accessible/websites-and-web-applications/when-to-open-links-in-a-new-tab/) et garantir une expérience cohérente et inclusive pour vos lecteurs. {% endhint %} ### Liens mailto d’adresse e-mail Adresse e-mail `mailto` Les liens sont utiles lorsque vous souhaitez que vos visiteurs cliquent sur un lien qui ouvrira leur client de messagerie par défaut et remplira le `À` champ avec l’adresse e-mail de votre lien, afin qu’ils puissent rédiger un e-mail à envoyer. Voici comment insérer une adresse e-mail `mailto` lien : 1. Cliquez à l’endroit de votre paragraphe où vous souhaitez insérer le lien, ou sélectionnez du texte. 2. Appuyez sur / pour ouvrir la palette en ligne et choisissez Lien, cliquez sur le **Lien** bouton dans le menu contextuel, ou appuyez sur **⌘ + K**. 3. Collez ou saisissez `mailto:something@address.com`, en remplaçant `something@address.com` par l’adresse e-mail que vous souhaitez utiliser. 4. Appuyez sur `Entrée`. ### Représentation en Markdown ```markdown [Ceci est un lien relatif vers une autre page de cette section](../content-structure/page.md) [Ceci est un lien absolu](https://www.gitbook.com/blog) [Ceci est un lien](mailto:support@gitbook.com) vers notre adresse e-mail d’assistance ``` ## Maths et TeX Grâce à cette option, vous pouvez créer une formule mathématique en ligne dans votre contenu, comme ceci : $$f(x) = x \* e^{2 pi i \xi x}$$. Nous utilisons la [KaTeX](https://katex.org/docs/supported.html) bibliothèque pour afficher les formules. {% hint style="info" %} Vous pouvez également insérer une formule mathématique en bloc en ouvrant la palette de commandes dans un bloc vide et en choisissant la deuxième option Math & TeX. {% endhint %} ### Représentation en Markdown ```markdown # Bloc Maths et TeX $$f(x) = x * e^{2 pi i \xi x}$$ ``` ## Boutons Les boutons sont un excellent moyen de mettre en avant des appels à l’action ou d’ajouter une barre de recherche ou une barre Demander à l’IA à votre documentation. Vous pouvez les utiliser pour rediriger les lecteurs ailleurs, ou les aider à trouver des réponses. ### Actions des boutons Les boutons peuvent faire plus que renvoyer vers une URL. Vous pouvez aussi transformer un bouton en barre de recherche ou en barre Demander à l’assistant GitBook — directement depuis la page. Ces actions fonctionnent également sur les pages publiées, comme vous pouvez le voir dans les exemples ci-dessous. Vous pouvez configurer les actions suivantes : #### **Ajouter un bouton de lien** Envoyer les lecteurs vers une autre page ou une URL externe :En savoir plus sur Assistant #### **Ajouter une barre de recherche** Ouvrir la recherche avec une requête prédéfinie facultative : #### **Ajouter une barre Demander à l’IA / Assistant GitBook** Ouvrir GitBook Assistant avec une invite prédéfinie facultative : #### **Ajouter un bouton désactivé** Afficher un bouton volontairement inactif :Bouton inactif ### Créer et configurer un bouton 1. Tapez `/` et choisissez **Bouton**. 2. Cliquez sur le bouton pour ouvrir le **Libellé** menu. 3. Choisissez une action, puis définissez le libellé et le style. 4. Facultatif : ajoutez une requête de recherche ou une invite Assistant prédéfinie. ### Styles Les boutons de lien et les boutons inactifs ont tous deux des styles principal et secondaire. Voici quelques exemples : Inscrivez-vous à GitBook Aller en haut ### Représentation en Markdown ```markdown GitBook ``` ## Icônes Les icônes vous permettent d’ajouter des indications visuelles supplémentaires à votre site. Vous pouvez les ajouter en ligne à des paragraphes, dans une carte, ou partout où vous souhaitez ajouter une touche de style. Elles utiliseront le style visuel défini dans vos paramètres de personnalisation. :facebook: :github: :x-twitter: :instagram: Visitez [Font Awesome](https://fontawesome.com/) pour découvrir les différentes icônes disponibles. ### Représentation en Markdown ```markdown :github: ``` ## Expressions Les expressions vous permettent d’afficher dynamiquement du contenu défini dans une variable. Les expressions peuvent être insérées à partir du `/` menu. Une fois insérée, un clic sur l’expression ouvrira l’éditeur d’expression, vous permettant de faire référence à votre variable et de la [mettre en forme conditionnellement](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Conditional_operator) . --- # 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/formatting/inline.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.