Contenu en ligne
Utilisez la palette inline pour ajouter des images, des liens, des formules mathématiques & TeX, et plus
La palette en ligne vous permet d'ajouter rapidement du contenu supplémentaire à votre bloc de texte sans retirer les mains du clavier. Appuyez simplement sur / sur n'importe quel bloc de texte pour ouvrir la palette en ligne. La barre oblique avant sera remplacée par le contenu que vous choisissez d'insérer.
Annotations
Avec les annotations, vous pouvez ajouter un contexte supplémentaire à vos mots sans interrompre le fil de la 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 dans le menu contextuel. Une fois que vous avez écrit votre annotation, cliquez en dehors pour continuer à écrire dans le bloc de texte.
Représentation Markdown
Vous pouvez écrire du contenu en notes de bas de page Markdown pour les ajouter comme 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.
Voici une note simple[^1], et voici une note plus longue[^bignote].
[^1]: Ceci est la première note de bas de page.
[^bignote]: En voici une avec plusieurs paragraphes et du code.
Indentez les paragraphes pour les inclure dans la note de bas de page.
`{ mon code }`
Ajoutez autant de paragraphes que vous le souhaitez.Images
Les images en ligne s'aligneront à 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 formatage, puis en choisissant l'une des trois options :
Taille en ligne : L'image est dimensionnée proportionnellement à la police — idéal pour les icônes et badges.
Taille d'origine : L'image restera en ligne à sa taille d'origine, avec une largeur maximale de 300 pixels.
Convertir en bloc : Cela transforme une image en ligne en bloc d'image, qui est aussi large que votre contenu.
Représentation en Markdown
Voici une image en ligne : <img src=".gitbook/assets/GitBook - Dark.jpg" alt="Version sombre du logo GitBook" data-size="line">Emojis
Vous pouvez ajouter des emojis en appuyant sur / pour ouvrir la palette en ligne. Sinon, tapez : et une liste d'emojis apparaîtra directement en ligne — vous pouvez commencer à taper le nom d'un emoji pour affiner la sélection.
Représentation en Markdown
:house:
:car:
:dog:Liens
Vous pouvez insérer trois types de liens différents :
Liens relatifs
Les liens relatifs sont créés en pointant vers pages qui existent déjà dans votre espace. 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 sera tenue à jour — vous aurez donc moins de liens brisés.
Voici comment insérer un lien relatif :
Cliquez quelque part dans votre paragraphe à l'endroit où vous souhaitez insérer le lien, ou sélectionnez du texte.
Appuyez sur / pour ouvrir la palette en ligne et choisissez Lien, cliquez sur le Lien bouton dans le menu contextuel, ou appuyez sur ⌘ + K.
Commencez à taper le titre de la page que vous souhaitez lier.
Sélectionnez la page dans les résultats de recherche déroulants.
Appuyez sur
Entrée.
Liens absolus
Les liens absolus sont des liens externes que vous pouvez copier-coller dans votre contenu. Ils sont utiles lorsque vous souhaitez renvoyer vers quelque chose en dehors de votre documentation.
Pour insérer un lien absolu :
Cliquez quelque part dans votre paragraphe à l'endroit où vous souhaitez insérer le lien, ou sélectionnez du texte.
Appuyez sur / pour ouvrir la palette en ligne et choisissez Lien, cliquez sur le Lien bouton dans le menu contextuel, ou appuyez sur ⌘ + K.
Collez l'URL vers laquelle vous souhaitez créer le lien.
Appuyez sur
Entrée.
Pourquoi les liens externes ne s'ouvrent-ils pas dans un nouvel onglet ?
Lorsque vous ajoutez un lien vers un site externe dans vos docs, il s'ouvrira dans le même onglet.
GitBook suit ce comportement recommandé par le W3C pour soutenir l'accessibilité et garantir une expérience cohérente et inclusive pour vos lecteurs.
Liens mailto d'adresse e-mail
Adresse e-mail mailto les liens sont utiles lorsque vous voulez que vos visiteurs cliquent sur un lien qui ouvrira leur client e-mail par défaut et remplira le Pour champ avec l'adresse e-mail de votre lien, afin qu'ils puissent rédiger un e-mail à envoyer.
Voici comment insérer un lien d'adresse e-mail mailto :
Cliquez quelque part dans votre paragraphe à l'endroit où vous souhaitez insérer le lien, ou sélectionnez du texte.
Appuyez sur / pour ouvrir la palette en ligne et choisissez Lien, cliquez sur le Lien bouton dans le menu contextuel, ou appuyez sur ⌘ + K.
Collez ou tapez
mailto:something@address.com, en remplaçantsomething@address.compar l'adresse e-mail que vous souhaitez utiliser.Appuyez sur
Entrée.
Représentation en Markdown
[Ceci est un lien relatif vers une autre page de cet espace](../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 de supportMathématiques & TeX
Avec cette option, vous pouvez créer une formule mathématique en ligne dans votre contenu, comme ceci : . Nous utilisons la KaTeX bibliothèque pour rendre les formules.
Représentation en Markdown
# Bloc Math et TeX
$$f(x) = x * e^{2 pi i \xi x}$$Boutons
Les boutons sont un excellent moyen de décrire des appels à l'action. Vous pouvez les utiliser pour envoyer les utilisateurs vers d'autres pages dans GitBook, ou vers des URL externes.
Les boutons ont des styles primaires et secondaires. Voici quelques exemples :
Représentation en Markdown
<a href="https://app.gitbook.com" class="button primary">GitBook</a>Icônes
Les icônes vous permettent d'ajouter des indications visuelles supplémentaires à votre site. Vous pouvez les ajouter en ligne dans des paragraphes, à l'intérieur d'une carte, ou n'importe où ailleurs où vous avez besoin d'ajouter du style. Elles utiliseront le style visuel défini dans vos paramètres de personnalisation.
Visitez Font Awesome pour explorer les différentes icônes disponibles.
Représentation en Markdown
<i class="fa-github">:github:</i>Expressions
Les expressions vous permettent d'afficher dynamiquement du contenu défini dans une variable. Les expressions peuvent être insérées depuis le / menu. Une fois insérées, un double-clic sur l'expression fera apparaître l'éditeur d'expression, vous permettant de référencer et de formater conditionnellement votre variable.
Mis à jour
Ce contenu vous a-t-il été utile ?