> 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/gerer-votre-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 importer votre propre icône. L’icône que vous définissez dans le **menu Personnaliser** menu sera utilisée comme favicon pour votre site de documentation. Les modifications peuvent prendre quelques minutes avant d’apparaître dans votre documentation publiée — si vous ne voyez pas le nouveau favicon, votre navigateur a peut-être mis en cache l’ancien ; essayez donc un autre navigateur. {% 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 dans la section elle-même. {% endhint %} ### Logo personnalisé

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 identité visuelle — et vous pouvez importer 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 Icône vous permet d’importer une petite image de 132×132 px, qui apparaîtra *à côté de* du titre de votre site et servira de favicon pour votre site. L’option de logo personnalisé vous permet d’importer 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. 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 avec des éléments translucides et un style minimaliste. Votre couleur principale (ou teinte) influence les liens et 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 dans 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

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 n’est disponible que pour les sites Premium ou Ultimate.* ### Dégradé

Un thème tendance 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é 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 évidence et des éléments de navigation comme 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 lorsque 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 **Poser une question ou rechercher** barre. La couleur de teinte *pas* affectera les éléments de navigation comme les liens et les boutons, qui utilisent toujours la couleur principale. Dans le **Couleur de teinte** dans la 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 exacte d’arrière-plan 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 impression de blanc cassé ou de papier chaud en mode clair, ou un fond sombre profond spécifique en mode sombre, simplement en choisissant la bonne teinte. {% hint style="info" %} Quelques points à garder à l’esprit : * La teinte doit être proche du neutre (seulement légèrement colorée). Une teinte fortement colorée conserve l’arrière-plan standard de GitBook et ne teinte que les accents. * Elle doit être clairement claire ou clairement sombre. Un gris moyen ne changera 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 inchangé. {% endhint %}

### Couleurs sémantiques

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 modifier la couleur d’arrière-plan de chaque style d’indication ; ces changements se répercuteront sur le site publié que vous personnalisez. {% hint style="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. {% endhint %} ### Thème de code

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èmes 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 quel schéma de couleurs clair 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 comme 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, allez dans le menu Paramètres en bas de la barre latérale.* ## Styles du site

A GitBook screenshot showing site style settings

### Famille de polices

Choisissez une famille de polices standard et une famille 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 sur votre site de documentation. {% endhint %} ### Polices personnalisées

Importez vos propres polices standard et monospace pour aligner votre contenu publié sur le guide de style de votre marque. Pour importer une police, cliquez sur le **Ajouter une police personnalisée** et suivez les instructions. Vous devez importer 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

Lors de l’utilisation 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 une certaine élévation. * **Plat :** Aucune ombre ni élévation. ### Style des liens Choisissez entre deux designs de lien : * **Par défaut :** met en évidence l’intégralité du lien dans votre couleur principale ou de teinte. * **Accentué :** 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 manière 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 sélectionné. Il existe deux options — **Par défaut** et **Rempli** — chacune avec une représentation visuelle de la manière 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**, **Pilule** 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/gerer-votre-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.