Icônes, couleurs et thèmes

Personnalisez les icônes, couleurs, thèmes et paramètres plus granulaires sur votre documentation publiée

A GitBook screenshot showing title, icon and logo customization

Titre

Vous pouvez définir n’importe quel titre pour votre espace. Remarque : ce paramètre n’affectera que le titre qui s’affiche dans la documentation publiée. Si vous souhaitez modifier le titre dans l’application GitBook, fermez le menu de personnalisation et modifiez-le en haut de l’espace.

Icône

Vous pouvez définir un emoji ou télécharger votre propre icône. L’icône que vous définissez dans le menu Personnalisation sera utilisée comme favicon pour votre site de documentation.

circle-info

Ce paramètre n’affectera que l’icône qui s’affiche dans la documentation publiée. Si vous souhaitez modifier l’icône utilisée dans l’application GitBook, vous pouvez le faire lorsque vous éditez du contenu dans l’espace lui‑même.

Logo personnalisé (Premium & Ultimate)

Vous pouvez remplacer les deux le titre et l’icône de l’espace publié par un logo personnalisé afin que votre documentation reflète mieux votre identité visuelle — et vous pouvez télécharger deux versions : une pour le mode clair et une pour le mode sombre.

circle-info

Quelle est la différence entre les options icône et logo ?

Le réglage d’icône vous permet de télécharger une petite image de 132×132 px, qui apparaîtra à côté de votre titre d’espace et fera office de favicon de votre site. L’option de logo personnalisé permet de télécharger une image plus grande (nous recommandons au moins 600 px de large), qui remplacera complètement toute icône et tout titre que vous avez définis.

Thèmes

Les thèmes vous permettent de personnaliser le schéma de couleurs de votre contenu publié pour les modes clair et sombre. Il y a quatre thèmes parmi lesquels choisir. Les couleurs de votre site seront directement affectées par la couleur principale et la teinte que vous choisissez. Ces deux sélections affectent diverses parties de l’interface et peuvent complètement changer l’apparence et le ressenti de votre site.

A GitBook screenshot showing theme options

Clean

Un thème moderne avec translucidité et éléments au style minimal. Votre couleur principale (ou teinte) affecte les liens et d’autres éléments d’interface mis en valeur.

Clean est disponible pour tous les sites et est le thème par défaut.

Muted

Un thème sophistiqué avec un contraste réduit entre les éléments. L’arrière‑plan du site est plus prononcé et se fond avec le premier plan, et certains éléments présentent un aspect inversé — le tout basé sur votre couleur principale (ou teinte).

Muted est disponible pour tous les sites.

Bold (Premium & Ultimate)

Un thème à fort impact avec des couleurs prononcées et de forts contrastes. Votre couleur principale (ou teinte) sera utilisée pour l’en‑tête du site, et d’autres éléments mis en valeur comme les icônes seront colorés en conséquence.

Bold n’est disponible que pour les sites Premium ou Ultimate.

Gradient (Premium & Ultimate)

Un thème tendance avec un arrière‑plan en dégradé et des touches de couleur. Le dégradé et les éléments mis en valeur seront colorés selon votre couleur principale (ou teinte).

Gradient n’est disponible que pour les sites Premium ou Ultimate.

Couleurs

A GitBook screenshot showing color customization

Couleur principale

La couleur principale de votre site affectera le style des éléments d’interface mis en valeur et des éléments de navigation comme les liens, la page et la section en cours, les fil d’Ariane et les boutons d’en‑tête principaux.

GitBook ajuste automatiquement les couleurs des éléments individuels pour la lisibilité si le contraste avec l’arrière‑plan est trop faible ou lorsqu’un système de visiteur demande un contraste plus élevé.

Couleur de teinte

La couleur de teinte de votre site modifiera subtilement la couleur de tous les textes et icônes sur l’ensemble de votre site — y compris les liens d’en‑tête, la couleur des icônes et les éléments d’interface tels que la barre Demander ou rechercher .

La couleur de teinte n’ affectera pas les éléments de navigation comme les liens et les boutons, qui utilisent toujours la couleur principale.

Dans la Couleur de teinte section, vous verrez des couleurs suggérées basées sur votre sélection de couleur principale. Vous pouvez en sélectionner une pour la prévisualiser, choisir votre couleur principale comme teinte, ou choisir une couleur complètement personnalisée avec le sélecteur de couleur.

Couleurs sémantiques (Premium & Ultimate)

Les couleurs sémantiques sont appliquées aux blocs d’indication dans votre contenu publié, et peuvent également être appliquées aux blocs de code.

Vous pouvez changer la couleur d’arrière‑plan de chaque style d’indication ; ces modifications seront reflétées sur le site publié que vous personnalisez.

circle-info

Remarque : Les blocs d’indication dans l’éditeur GitBook conserveront toujours leurs couleurs standard et ne correspondront pas aux couleurs sémantiques de votre site.

Thème de code (Premium & Ultimate)

Les thèmes de code changent l’apparence des blocs de code et des blocs OpenAPI dans votre documentation publiée.

La liste des thèmes inclut :

  • Thèmes adaptatifs – Ces thèmes standard en mode clair et sombre utilisent la palette de couleurs de votre site pour correspondre à votre marque.

  • Thèmesarrow-up-right Shiki – Choisissez parmi plus de 60 préréglages de thèmes en modes clair et sombre.

Vous pouvez choisir des thèmes de code individuels pour les modes clair et sombre de votre documentation. Et vous pouvez utiliser n’importe quel schéma de couleur clair ou sombre dans n’importe quel mode — par ex. un thème de code sombre lorsque votre documentation est en mode clair.

Par défaut, le thème choisi s’appliquera à la fois aux blocs de code et aux blocs OpenAPI. Si vous souhaitez définir un thème différent pour les blocs OpenAPI, cliquez sur le bouton Personnaliser par type de bloc .

Modes

Afficher le bascule de mode

Activez ceci si vous voulez que les visiteurs puissent basculer manuellement entre le mode clair et le mode sombre. Les lecteurs peuvent trouver le bascule en bas de chaque page publiée, sur ordinateur et mobile.

Mode par défaut

Choisissez si les visiteurs voient votre contenu en mode clair ou sombre par défaut. Si Afficher le bascule de mode est activé, ils peuvent changer de mode ; si désactivé, ils ne verront que le mode que vous choisissez ici.

Remarque : pour changer le thème dans l’application GitBook, allez dans votre menu Paramètres en bas de la barre latérale.

Styles du site

A GitBook screenshot showing site style settings

Famille de polices (Premium & Ultimate)

Choisissez une police standard et une police monospace pour votre contenu publié à partir d’une liste sélectionnée d’options populaires.

circle-info

Les polices monospace sont utilisées dans les blocs de code et les blocs OpenAPI sur votre site de documentation.

Polices personnalisées (Ultimate uniquement)

Téléchargez vos propres polices standard et monospace pour aligner votre contenu publié sur le guide de style de votre marque. Pour télécharger une police, cliquez sur Ajouter une police personnalisée et suivez les instructions. Vous devez télécharger un fichier de police pour les graisses normale et grasse.

GitBook prend actuellement en charge .woff et .woff2. Pour d’autres formats, veuillez contacter support@gitbook.comenvelope.

Icônes (Premium & Ultimate)

Lorsque vous utilisez des icônes de page, définissez ici l’épaisseur et le style des icônes affichées.

Style des coins

Choisissez des coins arrondis ou droits pour correspondre aux préférences de style de votre marque.

Style de profondeur

Choisissez entre deux styles de profondeur, qui s’appliquent aux cartes, boutons et tout autre élément avec une ombre :

  • Subtil : Quelques ombres et élévation.

  • Plat : Aucune ombre ni élévation.

Style de lien

Choisissez entre deux designs de lien :

  • Par défaut : met en valeur le lien entier avec votre couleur principale ou de teinte.

  • Accent : ajoute un soulignement coloré au lien, en laissant la couleur du texte inchangée.

Styles de la barre latérale

A GitBook screenshot showing sidebar style options
Ce menu vous donne une idée visuelle de la façon dont les différents styles vont changer l’apparence de votre barre latérale.

Style d’arrière‑plan

Choisissez le style d’arrière‑plan pour le conteneur de la barre latérale. La couleur est dérivée de votre thème sélectionné.

Il y a deux options — Par défaut et Rempli — chacune avec une représentation visuelle de la façon dont elles vont modifier votre table des matières.

Style de liste

Choisissez le style pour la liste de la barre latérale et ses éléments sélectionnés. Il y a trois options — Par défaut, Pilule et Ligne — chacune avec une représentation visuelle montrant comment elles vont changer votre table des matières.

Mis à jour

Ce contenu vous a-t-il été utile ?