Icônes, couleurs et thèmes

Personnalisez les icônes, les couleurs, les thèmes et d’autres paramètres plus détaillés dans toute votre documentation publiée

A GitBook screenshot showing title, icon and logo customization

Titre

Vous pouvez définir le titre de votre choix pour votre espace. Remarque : ce paramètre n’affectera que le titre affiché 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éverser votre propre icône. L’icône que vous définissez dans le Personnalisation menu sera utilisée comme favicon pour votre site de documentation.

circle-info

Ce paramètre n’affectera que l’icône affichée dans la documentation publiée. Si vous souhaitez modifier l’icône utilisée dans l’application GitBook, vous pouvez le faire lors de la modification du contenu dans l’espace lui-même.

Logo personnalisé (Premium et Ultimate)

Vous pouvez remplacer à la fois le titre et l’icône de l’espace publié par un logo personnalisé afin que votre documentation reflète mieux votre propre identité de marque — et vous pouvez téléverser 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 paramètre d’icône vous permet de téléverser une petite image de 132×132 px, qui apparaîtra à côté de le titre de votre espace et servira de favicon pour votre site. L’option de logo personnalisé vous permet de téléverser une image plus grande (nous recommandons au moins 600 px de large), qui remplacera entièrement toute icône et tout titre que vous avez définis.

Thèmes

Les thèmes vous permettent de personnaliser la palette de couleurs de votre contenu publié pour les modes clair et sombre. Quatre thèmes sont disponibles. Les couleurs de votre site seront directement influencées par la couleur principale et teinte que vous choisissez. Ces deux sélections affectent différentes parties de l’interface et peuvent complètement changer l’apparence et l’ambiance de votre site.

A GitBook screenshot showing theme options

Épuré

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

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

Atténué

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).

Atténué est disponible pour tous les sites.

Gras (Premium et Ultimate)

Un thème percutant avec des couleurs marqué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 évidence, comme les icônes, seront colorés en conséquence.

Audacieux est disponible uniquement pour les sites Premium ou Ultimate.

Dégradé (Premium et Ultimate)

Un thème dans l’air du temps avec un arrière-plan dégradé et des touches de couleur. Le dégradé et les éléments mis en évidence seront colorés par votre couleur principale (ou teinte).

Dégradé est disponible uniquement pour les sites Premium ou Ultimate.

Couleurs

A GitBook screenshot showing color customization

Couleur principale

La couleur principale de votre site influencera le style des éléments d’interface mis en évidence et des éléments de navigation tels que les liens, la page et la section en cours, le fil d’Ariane et les boutons principaux de l’en-tête.

GitBook ajuste automatiquement les couleurs de certains éléments pour améliorer la lisibilité si le contraste avec l’arrière-plan est trop faible ou si le système d’un visiteur demande un contraste plus élevé.

Couleur de teinte

La couleur de teinte de votre site modifiera subtilement la couleur de tout le texte et de toutes les icônes sur l’ensemble de votre site — y compris les liens de l’en-tête, la couleur des icônes et des éléments d’interface tels que la Poser une question ou rechercher barre.

La couleur de teinte ne pas affectera les éléments de navigation tels que les liens et les boutons, qui utilisent toujours la couleur principale.

Dans la Couleur de teinte section, vous verrez des couleurs suggérées en fonction de votre sélection de couleur principale. Vous pouvez en choisir une pour l’aperçu, choisir votre couleur principale comme teinte, ou sélectionner une couleur entièrement personnalisée avec le sélecteur de couleurs.

Couleurs sémantiques (Premium et Ultimate)

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

Vous pouvez modifier la couleur de fond de chaque style d’astuce ; ces modifications seront reflétées sur le site publié que vous personnalisez.

circle-info

Remarque : Les blocs d’astuce 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 et Ultimate)

Les thèmes de code modifient l’apparence du code et des blocs API dans votre documentation publiée.

La liste des thèmes comprend :

  • Thèmes adaptatifs – Ces thèmes standards pour les modes clair et sombre utilisent la palette de couleurs de votre site pour correspondre à votre marque.

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

Vous pouvez choisir des thèmes de code distincts pour le mode clair et le mode sombre de votre documentation. Et vous pouvez utiliser n’importe quelle palette de couleurs claire ou sombre dans n’importe quel mode — par exemple, 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 bouton de bascule du mode

Activez cette option si vous souhaitez que les visiteurs basculent manuellement entre le mode clair et le mode sombre. Les lecteurs peuvent trouver le bouton de bascule en bas de n’importe quelle page publiée, sur ordinateur comme sur mobile.

Mode par défaut

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

Remarque : pour modifier 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 et Ultimate)

Choisissez une famille de polices standard et une famille monospace pour votre contenu publié parmi 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 de votre site de documentation.

Polices personnalisées (Ultimate uniquement)

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

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

Icônes (Premium et 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 afin de correspondre aux préférences de style de votre marque.

Style de profondeur

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

  • Subtil : Quelques ombres et une légère élévation.

  • Plat : Aucune ombre ni élévation.

Style des liens

Choisissez entre deux designs de liens :

  • Par défaut : met en évidence l’intégralité du lien avec votre couleur principale ou de teinte.

  • Accentué : ajoute un soulignement coloré au lien, sans modifier la couleur du texte.

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 modifieront l’apparence de votre barre latérale.

Style d’arrière-plan

Choisissez le style d’arrière-plan du conteneur de la barre latérale. La couleur est dérivée du thème que vous avez sélectionné.

Il existe deux options — Par défaut et Rempli — chacune accompagnée d’une représentation visuelle montrant comment elles modifieront votre table des matières.

Style de liste

Choisissez le style de la liste de la barre latérale et de ses éléments sélectionnés. Il existe trois options — Par défaut, Pastille et Ligne — chacune accompagnée d’une représentation visuelle montrant comment elles modifieront votre table des matières.

Mis à jour

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