> 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/docs-site/customization/icons-colors-and-themes.md). # Icônes, couleurs et thèmes ## Titre, icône et logo

### Titre Vous pouvez définir le titre de votre choix pour votre site. 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 la section. ### 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 **Personnaliser** menu sera utilisée comme favicon pour votre site de documentation. {% hint style="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 directement dans la section. {% endhint %} ### Logo personnalisé (Premium et Ultimate) Vous pouvez remplacer *à la fois* le titre et l'icône du site publié par un logo personnalisé afin que votre documentation reflète mieux votre propre identité visuelle — et vous pouvez téléverser deux versions : une pour le mode clair et une pour le mode sombre. {% hint style="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* du titre de votre site et servira de favicon. 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 complètement toute icône et tout titre que vous avez définis. {% endhint %} ## Thèmes Les thèmes vous permettent de personnaliser la palette de couleurs de votre contenu publié, pour les modes clair et sombre. Il existe quatre thèmes au choix. 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 présentant de la translucidité et des éléments au style minimaliste. Votre couleur principale (ou teinte) affecte les liens et autres éléments d'interface mis en évidence. *Clean 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 marqué et se fond avec le premier plan, et certains éléments affichent un aspect inversé — le tout basé sur votre couleur principale (ou teinte). *Muted 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. *Bold 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 en 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). *Gradient est disponible uniquement 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 évidence et des éléments de navigation tels que les liens, la page et la section actuelles, le fil d'Ariane et les boutons principaux de l'en-tête. GitBook ajuste automatiquement les couleurs de certains éléments pour garantir 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 les éléments d'interface comme la **Demander ou rechercher** barre. La couleur de teinte ne *pas* affecter 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 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.

Utiliser la teinte pour définir la couleur d'arrière-plan

Si vous choisissez une teinte très claire (proche du blanc) ou très foncée (proche du noir), et que cette couleur est proche d'une nuance neutre, GitBook l'utilise comme couleur d'arrière-plan exacte de votre site au lieu de l'arrière-plan blanc ou sombre par défaut. Cela vous permet de donner à votre documentation une légère sensation blanc cassé ou papier chaleureux en mode clair, ou un fond sombre profond précis en mode sombre, simplement en choisissant la bonne teinte. {% hint style="info" %} Quelques points à garder à l'esprit : * La teinte doit être proche du neutre (légèrement colorée seulement). Une teinte fortement colorée conserve l'arrière-plan standard de GitBook et ne teinte que les accents. * Elle doit être nettement claire ou nettement foncée. Un gris moyen ne modifiera pas l'arrière-plan. * Avec le **Gras** thème, la teinte stylise l'en-tête plutôt que l'arrière-plan de la page, donc l'arrière-plan reste tel quel. {% endhint %}

### Couleurs sémantiques (Premium et Ultimate) Les couleurs sémantiques s'appliquent aux blocs d'astuce dans votre contenu publié, et peuvent également s'appliquer aux blocs de code. Vous pouvez modifier la couleur d'arrière-plan de chaque style d'astuce ; ces changements seront reflétés sur le site publié que vous personnalisez. {% hint style="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. {% endhint %} ### Thème de code (Premium et Ultimate) Les thèmes de code modifient l'apparence des blocs de code et d'API dans votre documentation publiée. La liste des thèmes comprend : * **Thèmes adaptatifs** – Ces thèmes standard pour les modes clair et sombre utilisent la palette de couleurs de votre site pour correspondre à votre marque. * [**Shiki**](https://shiki.style/themes) **thèmes** – Choisissez parmi plus de 60 préréglages de thème en modes clair et sombre. Vous pouvez choisir des thèmes de code distincts pour les modes clair et 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 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 **Personnaliser par type de bloc**

bouton. ## Modes ### Afficher le sélecteur de mode Activez cette option si vous souhaitez que les visiteurs basculent manuellement entre les modes clair et sombre. Les lecteurs peuvent trouver le sélecteur 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 sélecteur de 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 changer le thème dans l'application GitBook, accédez au 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 monospace pour votre contenu publié à partir d'une liste sélectionnée d'options populaires. {% hint style="info" %} Les polices monospace sont utilisées dans les blocs de code et les blocs OpenAPI de votre site de documentation. {% endhint %} ### Polices personnalisées (Ultimate uniquement) Téléversez vos propres polices standard et monospace pour aligner votre contenu publié avec la charte graphique 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 . ### Icônes (Premium et Ultimate) Lorsque vous utilisez des icônes de page, définissez ici la graisse 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, aux boutons et à tout autre élément avec une ombre : * **Subtil :** Quelques ombres et un peu de relief. * **Plat :** Aucune ombre ni relief. ### Style des liens Choisissez entre deux styles de lien : * **Par défaut :** met en évidence l'intégralité du lien dans votre couleur principale ou de teinte. * **Accent :** ajoute un soulignement coloré au lien, tout en conservant 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 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 avec une représentation visuelle de la façon dont 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 avec une représentation visuelle montrant comment elles modifieront votre table des matières. --- # 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/docs-site/customization/icons-colors-and-themes.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.