Options d'en-tête
L'en-tête est la barre de navigation supérieure de votre site de documentation Docsbook. Il contient le nom et le logo de votre projet, vos propres liens, des icônes sociales, ainsi que les contrôles de recherche, Demander à l'IA, de thème et de langue. Chaque paramètre sur cette page est un choix d'affichage — changer l'en-tête ne coûte rien à votre solde de projet.
Paramètres de l’en-tête#
| Paramètre | Fonction |
|---|---|
| Préréglage de mise en page de l’en-tête | Organise les blocs de l’en-tête (thème, recherche, Ask AI, liens de navigation) selon l’un des 5 préréglages |
| Afficher l’en-tête | Afficher ou masquer toute la barre de navigation supérieure |
| Liens de l’en-tête | Liens textuels personnalisés dans la navigation de l’en-tête |
| Liens sociaux | Liens avec icônes vers GitHub, Twitter et Discord |
| Sélecteur de thème dans l’en-tête | Afficher le sélecteur clair/sombre dans l’en-tête |
| Sélecteur de langue dans l’en-tête | Afficher le sélecteur de langue dans l’en-tête |
| Bouton de recherche dans l’en-tête | Afficher une icône ou un bouton de recherche dans l’en-tête |
| Couleur d’arrière-plan du bouton de recherche | Couleur d’arrière-plan personnalisée pour le bouton de recherche de l’en-tête — voir ci-dessous |
| Couleur d’arrière-plan du bouton Ask AI | Couleur d’arrière-plan personnalisée pour le bouton Ask AI de l’en-tête — voir ci-dessous |
Comment configurer l'en-tête#
- Ouvrez votre site de documentation.
- Widget flottant → Design → onglet En-tête.
- Remplissez les champs et activez les options.
- Enregistrer.
Modifier l'en-tête depuis la page#
Vous pouvez également changer l'en-tête là où vous le voyez. Sur votre site de documentation, appuyez sur Éditeur dans la barre d'outils, puis cliquez sur la partie que vous souhaitez modifier :
| Cliquez sur | Vous pouvez |
|---|---|
| Le nom du projet ou le logo | Changer le nom, le logo ou l'icône |
| Un lien d'en-tête | Changer son texte ou son URL, ou le transformer en bouton rempli |
| Recherche / Demander à l'IA / langue / thème | Le cacher |
| Une icône sociale | La pointer ailleurs, ou la supprimer |
| Espace vide dans la barre | Changer le modèle de mise en page |
Chaque action est envoyée au chat IA comme une demande, qui l'applique ensuite — vous voyez donc ce qui a été demandé et ce qui a changé, et vous pouvez l'annuler dans la même conversation.
Préréglages de mise en page de l'en-tête#
La carte Mise en page de l'en-tête est la première carte de l'onglet En-tête. Elle choisit un agencement prédéfini pour les blocs de votre navigation supérieure — bascule de thème, recherche, Demander à l'IA et liens de navigation — sans changer les blocs affichés.
| Préréglage | Agencement | Meilleur pour |
|---|---|---|
| Classique (par défaut) | Thème, Demander à l'IA et recherche regroupés à droite | Par défaut universel — fonctionne pour la plupart des sites de documentation |
| Centré sur la recherche | Large barre de recherche centrée dans l'en-tête, Demander à l'IA à droite | Documents riches en contenu où la recherche est primordiale |
| Recherche + Demander à l'IA | Large recherche centrée avec le bouton Demander à l'IA juste à côté | Documents où demander à l'IA est aussi important que de rechercher |
| Centré | Logo à gauche, liens de navigation centrés, utilitaires à droite | Style de page d'atterrissage avec 3 à 5 liens |
| Minimal | Demander à l'IA et recherche affichés sous forme d'icônes simples | Maximum d'espace pour les liens de navigation et les icônes sociales |
Cliquez sur un préréglage pour l'appliquer — un clic définit tous les six champs de placement sous-jacents à la fois (côté thème, largeur de recherche, emplacement de Demander à l'IA, Demander à l'IA uniquement en icône, recherche uniquement en icône, position du lien de navigation).
Demander à l'IA à côté de la recherche n'a d'effet que lorsque la barre de recherche est large. Avec une recherche compacte, il n'y a pas de cluster central pour que le bouton se joigne, donc il reste dans le groupe de droite.
Mise en page ≠ visibilité. Un préréglage ne contrôle que où un bloc se trouve, jamais s'il est affiché. Si vous désactivez un bloc en utilisant son propre interrupteur (par exemple, Bascule de thème dans l'en-tête), ce bloc disparaît et le reste de l'en-tête continue de suivre le même préréglage — les blocs restants ne se déplacent pas à sa place ni ne changent d'agencement.
Couleur d’arrière-plan des boutons de l’en-tête#
Les cartes Rechercher dans l’en-tête et Demander à l’IA dans l’en-tête disposent chacune de leur propre champ Couleur d’arrière-plan, défini sous forme de code hexadécimal (par ex. #5B47E0). Une couleur définie ici remplace l’arrière-plan estompé par défaut du bouton ; le texte devient automatiquement noir ou blanc pour rester lisible sur celui-ci.
Laissez le champ vide pour conserver l’arrière-plan par défaut — cela ne nécessite pas que la Couleur d’accent du site soit définie, et la définition de l’une ne modifie pas l’autre.
Liens d'en-tête#
Les liens d'en-tête sont les liens textuels personnalisés dans la barre supérieure de votre site Docsbook. Ajoutez-les pour qu'ils apparaissent dans la barre supérieure — utile pour lier votre produit, blog, journal des modifications ou support.
Format : Chaque lien a un label et une URL.
Exemple :
| Label | URL |
|---|---|
| Produit | https://yourapp.com |
| Journal des modifications | https://yourapp.com/changelog |
| Support | https://yourapp.com/support |
Liens sociaux#
Les liens sociaux sont des liens d'icônes dans l'en-tête de Docsbook pointant vers votre communauté — GitHub, Twitter / X et Discord. Ajoutez-en un par plateforme.
Plateformes prises en charge :
- GitHub — liens vers votre dépôt ou organisation
- Twitter / X — liens vers votre profil Twitter
- Discord — liens vers votre serveur communautaire
Les liens sociaux apparaissent sous forme de petites icônes dans l'en-tête. Ils aident les lecteurs à trouver votre communauté sans encombrer la navigation avec des liens textuels.
Contrôles de thème et de langue dans l'en-tête#
Vous pouvez placer le commutateur de thème et le sélecteur de langue dans l'en-tête au lieu de (ou en plus de) la barre latérale.
Pour un contrôle plus précis sur où dans l'en-tête le commutateur de thème et la recherche se situent par rapport aux liens de navigation, voir Préréglages de mise en page de l'en-tête ci-dessus.
Recommandation : Choisissez un emplacement pour chaque contrôle afin d'éviter la duplication.
-
Placement dans l'en-tête : plus visible, moins de profondeur de clic pour les nouveaux visiteurs.
-
Placement dans la barre latérale : économise de l'espace dans l'en-tête, mieux pour les en-têtes denses.
Masquer le header#
Définir Afficher le header sur désactivé supprime l'ensemble de la barre de navigation supérieure.
Ne faites cela que pour des cas d'utilisation d'intégration ou de kiosque où vos documents sont encadrés à l'intérieur d'un autre produit. Pour les sites de documentation autonomes, gardez toujours le header visible.
Liens#
- Mise en page et configuration de la barre latérale — l'autre moitié de votre navigation
- Thématisation — clair, sombre, système — ce que le commutateur de thème dans l'en-tête change
- Marque — nom, logo, couleurs, polices — le nom et le logo affichés dans l'en-tête
- Paramètres de traduction — ce que le sélecteur de langue dans l'en-tête propose