> 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/manage-your-site/customization/icons-colors-and-themes.md).

# Icônes, couleurs et thèmes

Personnalisez les icônes, les couleurs, les thèmes et d’autres réglages plus précis dans votre documentation publiée

## Titre, icône et logo

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FBYTJub4AuG2iJDCS31vp%2Ftitle_icon_logo%402x.png?alt=media&#x26;token=2e3fd867-a480-40da-919b-d5c1e6225317" alt="A GitBook screenshot showing title, icon and logo customization"><figcaption></figcaption></figure>

### Titre

Vous pouvez choisir le titre de votre site. Remarque : ce paramètre ne modifie que le titre affiché *dans la documentation publiée*. Pour 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 définie dans le menu **Personnaliser** sera utilisée comme favicon de votre site de documentation. Les modifications peuvent prendre quelques minutes avant d’apparaître sur votre documentation publiée. Si la nouvelle favicon ne s’affiche pas, votre navigateur a peut-être mis l’ancienne en cache ; essayez alors avec un autre navigateur.

{% hint style="info" %}
Ce paramètre ne modifie que l’icône affichée *dans la documentation publiée*. Pour modifier l’icône utilisée dans l’application GitBook, vous pouvez le faire en modifiant le contenu de la section elle-même.
{% endhint %}

### Logo personnalisé <picture><source srcset="broken://files/5v7vLpEB0s9GQaH8Au0V" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-48a4c82c8f3063c2ceadae94fdee6f61e289d874%2FEssential%20Badge%20Light.png?alt=media" alt=""></picture> <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

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é de marque. 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 d’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. L’option de logo personnalisé vous permet d’importer une image plus grande (nous recommandons une largeur d’au moins 600 px), qui remplacera entièrement l’icône et le titre définis.
{% endhint %}

## Thèmes

Les thèmes vous permettent de personnaliser la palette de couleurs de votre contenu publié, en mode clair comme en mode sombre. Vous avez le choix entre quatre thèmes. Les couleurs de votre site seront directement influencées par la **couleur principale** et la **teinte** que vous choisissez. Ces deux paramètres modifient différentes parties de l’interface et peuvent complètement changer l’apparence de votre site.

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FtFNAAIZeXh1JKtnWepYZ%2Ftheme%402x.png?alt=media&#x26;token=d8d191df-5ed8-44b1-886a-bd9344add841" alt="A GitBook screenshot showing theme options"><figcaption></figcaption></figure>

### É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.

*É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.*

### Audacieux <picture><source srcset="broken://files/5v7vLpEB0s9GQaH8Au0V" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-48a4c82c8f3063c2ceadae94fdee6f61e289d874%2FEssential%20Badge%20Light.png?alt=media" alt=""></picture> <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

Un thème percutant aux couleurs marquées et aux 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 uniquement disponible pour les sites Essential ou Ultimate.*

### Dégradé <picture><source srcset="broken://files/5v7vLpEB0s9GQaH8Au0V" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-48a4c82c8f3063c2ceadae94fdee6f61e289d874%2FEssential%20Badge%20Light.png?alt=media" alt=""></picture> <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

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 évidence seront colorés par votre couleur principale (ou teinte).

*Gradient est uniquement disponible pour les sites Essential ou Ultimate.*

## Couleurs

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FkfBttkCRhIqoNFZGXkX4%2Fcolors%402x.png?alt=media&#x26;token=2ddbf1b0-7893-4fc2-a849-f92656b3151f" alt="A GitBook screenshot showing color customization"><figcaption></figcaption></figure>

### 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 comme 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 teinte de votre site modifiera subtilement la couleur de tous les textes et icônes de l’ensemble du site, notamment les liens de l’en-tête, la couleur des icônes et des éléments d’interface comme la **barre Poser une question ou rechercher** .

La teinte ne *modifie pas* les éléments de navigation comme les liens et les boutons, qui utilisent toujours la couleur principale.

Dans la section **Couleur de teinte** , vous verrez des couleurs suggérées en fonction de la couleur principale choisie. Vous pouvez en sélectionner une pour en voir un aperçu, utiliser votre couleur principale comme teinte ou choisir une couleur entièrement personnalisée à l’aide du sélecteur de couleurs.

<details>

<summary>Utiliser la teinte pour définir la couleur d'arrière-plan</summary>

Si vous choisissez une teinte très claire (proche du blanc) ou très sombre (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 impression de blanc cassé ou de papier chaud en mode clair, ou un arrière-plan 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 (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 clairement claire ou clairement sombre. Un gris intermédiaire ne changera pas l'arrière-plan.
* Avec le thème **Audacieux** , la teinte s’applique à l’en-tête plutôt qu’à l’arrière-plan de la page, qui conserve donc sa couleur actuelle.
  {% endhint %}

</details>

### Couleurs sémantiques <picture><source srcset="broken://files/5v7vLpEB0s9GQaH8Au0V" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-48a4c82c8f3063c2ceadae94fdee6f61e289d874%2FEssential%20Badge%20Light.png?alt=media" alt=""></picture> <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

Les couleurs sémantiques sont appliquées aux blocs d'information 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'information ; ces modifications seront répercutées sur le site publié que vous personnalisez.

{% hint style="info" %}
**Remarque :** Les blocs d’indication dans l’éditeur GitBook conservent toujours leurs couleurs standard et ne reprennent pas les couleurs sémantiques de votre site.
{% endhint %}

### Thème de code <picture><source srcset="broken://files/5v7vLpEB0s9GQaH8Au0V" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-48a4c82c8f3063c2ceadae94fdee6f61e289d874%2FEssential%20Badge%20Light.png?alt=media" alt=""></picture> <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

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 standard en mode clair et sombre utilisent la palette de couleurs de votre site pour s’accorder à votre marque.
* [**Thèmes**](https://shiki.style/themes) **Shiki** – Choisissez parmi plus de 60 préréglages de thèmes, en mode clair comme en mode 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’applique aux blocs de code et aux blocs OpenAPI. Pour définir un thème différent pour les blocs OpenAPI, cliquez sur le bouton **Personnaliser selon le type de bloc** <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F6uYUpJto7WTkJf9BUPHv%2Fsettings%20-%20dark.svg?alt=media&#x26;token=bf52415f-e999-43a2-9a1a-c85176a014cd" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FwkBqgOPry9HAcW4cxJk0%2Fsettings.svg?alt=media&#x26;token=67bdbb00-ebf3-4a2d-9df8-0c822406f71c" alt=""></picture> .

## Modes

### Afficher le sélecteur de 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 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 en mode clair ou sombre par défaut. Si l’option **Afficher le sélecteur de mode** est activée, ils peuvent changer de mode ; si elle est désactivée, ils ne verront que le mode choisi ici.

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

## Styles du site

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FB8hReiw1xjsXedx7kM2J%2FSite%20styles%402x.png?alt=media&#x26;token=99b1f18b-d1f3-42e4-b11f-4b7bee1c4ceb" alt="A GitBook screenshot showing site style settings"><figcaption></figcaption></figure>

### Famille de polices <picture><source srcset="broken://files/5v7vLpEB0s9GQaH8Au0V" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-48a4c82c8f3063c2ceadae94fdee6f61e289d874%2FEssential%20Badge%20Light.png?alt=media" alt=""></picture> <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

Choisissez une famille de polices standard et monospace pour votre contenu publié parmi une liste sélectionnée d'options populaires.

#### Police principale

C'est la police qui sera utilisée par défaut sur l'ensemble de votre site. Elle sera toujours utilisée pour le corps du texte et le texte de l'interface sur votre site.

#### Titres

La police des titres est facultative et ne s'appliquera qu'aux titres Page, H1, H2 et H3 sur votre site. Par défaut, la police des titres est définie pour correspondre à la police principale de votre site.

#### Monospace

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

### Polices personnalisées <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

Importez vos propres polices standard et à chasse fixe pour adapter votre contenu publié à la charte graphique de votre marque. Pour importer une police, cliquez sur **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 <support@gitbook.com>.

### Icônes <picture><source srcset="broken://files/5v7vLpEB0s9GQaH8Au0V" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-48a4c82c8f3063c2ceadae94fdee6f61e289d874%2FEssential%20Badge%20Light.png?alt=media" alt=""></picture> <picture><source srcset="broken://files/iRBqMn8OAyswwIZUIKbS" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fdea33fff377c3eff2104fd7eaf9e93f67018402%2FUltimate%20Badge%20Light.png?alt=media" alt=""></picture>

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

Ce paramètre contrôle l’épaisseur et le style des icônes de page sur votre site publié. Il ne définit pas les icônes des groupes de pages ni les icônes intégrées au texte. Définissez les icônes des groupes de pages dans la table des matières de la section. Ajoutez des icônes intégrées au texte dans [Contenu en ligne](https://gitbook.com/docs/documentation/fr/creer-du-contenu/formatting/inline.md).

### 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 :

* **Discret :** Quelques ombres et un léger relief.
* **Plat :** Aucune ombre ni aucun relief.

### Style des liens

Choisissez entre deux conceptions de liens :

* **Par défaut :** met en évidence l’intégralité du lien avec votre couleur principale ou une teinte.
* **Accentué :** ajoute un soulignement coloré au lien, sans modifier la couleur du texte.

## Styles de la barre latérale

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FjAXB2lbCWFVFhHTDmY3s%2Fsidebar_styles%402x.png?alt=media&#x26;token=c922b2e7-04de-4140-97e0-802375f9c92f" alt="A GitBook screenshot showing sidebar style options"><figcaption><p>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.</p></figcaption></figure>

### 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 choisi.

Deux options sont disponibles : **Par défaut** et **Rempli**. Chacune affiche un aperçu de son effet sur 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. Trois options sont disponibles : **Par défaut**, **Pastille**, et **Ligne**. Chacune affiche un aperçu de son effet sur 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/manage-your-site/customization/icons-colors-and-themes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
