Contrôle de la barre latérale

La barre latérale est le panneau de navigation à gauche de votre site de documentation Docsbook : l'arbre des pages, plus une recherche optionnelle, des fils d'Ariane, un sélecteur de langue et des icônes par page. Chaque paramètre ici est un choix d'affichage et ne coûte rien à votre solde de projet.

Paramètres de la barre latérale#

Comment configurer la barre latérale#

1. Ouvrez votre site de documentation.
2. Widget flottant → Design → onglet Barre latérale gauche.
3. Activez les options souhaitées.
4. Enregistrer.

Modifier la barre latérale depuis la page#

La plupart des éléments suivants peuvent également être modifiés sans ouvrir le panneau de paramètres. Sur votre site de documentation, appuyez sur Éditeur dans la barre d'outils, puis cliquez sur l'entrée de la barre latérale que vous souhaitez modifier. Une petite barre d'action apparaît au-dessus, offrant :

• Renommer — changez l'étiquette affichée dans la barre latérale.
• Icône — choisissez une icône, décrivez celle que vous souhaitez ou supprimez-la.
• Analytique — demandez ce que les lecteurs font réellement avec cette page.

Renommer ici change uniquement l'étiquette. La page conserve son adresse, donc chaque lien pointant vers elle — depuis vos propres documents, depuis Google, depuis le blog de quelqu'un d'autre — continue de fonctionner. Si vous souhaitez que l'URL elle-même change, renommez le fichier dans votre dépôt à la place.

Chaque action est envoyée au chat AI en tant que demande, qui l'applique ensuite. Vous voyez ce qui a été demandé et ce qui a changé, et vous pouvez dire "annuler cela" dans la même conversation.

Sélecteur de langue dans la barre latérale#

Le sélecteur de langue de la barre latérale est un sélecteur de langue affiché dans le panneau gauche afin que les lecteurs puissent changer de langue de traduction.

Quand l'utiliser : Activez ceci lorsque votre en-tête est déjà encombré d'autres éléments.

Remarque : Activez soit le sélecteur de la barre latérale soit le sélecteur de langue de l'en-tête — pas les deux. L'afficher à deux endroits crée une redondance.

Nécessite qu'au moins une langue de traduction soit activée. D'ici là, ouvrir le sélecteur sur votre propre site affiche Activer les langues, ce qui vous mène directement aux paramètres de traduction. Vos lecteurs voient à la place un simple avis Aucune langue ajoutée. Configurer les traductions →

Rechercher dans la barre latérale#

La recherche dans la barre latérale est un champ de recherche affiché dans le panneau latéral gauche de votre site Docsbook.

Il s’agit d’une alternative au bouton de recherche de l’en-tête. Certains lecteurs préfèrent la recherche dans la barre latérale, car elle ne masque pas le contenu de la page.

En savoir plus sur les options de recherche →

Fil d'Ariane#

Les fils d'Ariane montrent l'emplacement actuel de la page dans votre documentation sous forme de fil au-dessus du titre de la page :

Home > Guides > Custom Domain

Les fils d'Ariane aident les lecteurs dans les grands sites de documentation à comprendre où ils se trouvent et à naviguer rapidement vers le niveau supérieur.

Recommandé : Gardez les fils d'Ariane activés pour les documents de plus de 20 pages ou avec plusieurs sections imbriquées.

Icônes de la barre latérale#

Ajoutez une icône à côté de chaque page ou dossier individuel dans la barre latérale gauche, afin que les lecteurs puissent parcourir l'arborescence visuellement plutôt que par étiquette seule.

Comment configurer

1. Ouvrez votre site de documentation.
2. Widget Flottant → Design → onglet Barre latérale gauche.
3. Dans la carte Icônes de la barre latérale, recherchez la page ou le dossier que vous souhaitez marquer, puis choisissez une icône lucide pour cela (par exemple, rocket, book-open).
4. Répétez pour d'autres pages ou dossiers.
5. Enregistrez.

Le sélecteur n'offre que des noms d'icônes de l'ensemble d'icônes lucide actuel — rechercher par nom (par exemple, "fusée", "livre", "dossier") réduit les résultats. Une attribution d'icône s'applique à une page ou un dossier ; attribuez l'icône d'un dossier séparément de toutes les pages à l'intérieur.

Quand utiliser : Les icônes aident les lecteurs à repérer les sections clés (démarrer, référence API, FAQ) d'un coup d'œil dans une barre latérale longue ou profondément imbriquée. Pour un petit site de documentation avec seulement quelques pages de niveau supérieur, les icônes sont facultatives.

Dossiers de sous-en-tête#

Les dossiers de sous-en-tête transforment n'importe quel dossier de dépôt de niveau supérieur en son propre onglet dans le sous-en-tête — la rangée d'onglets affichée sous l'en-tête principal, sur les pages de documentation. Chaque dossier activé peut également porter une icône lucide sur son onglet.

Comment configurer

1. Ouvrez votre site de documentation.
2. Widget flottant → Design → onglet En-tête.
3. Dans la carte Dossiers de sous-en-tête, activez tout dossier de niveau supérieur que vous souhaitez afficher comme un onglet de sous-en-tête.
4. Optionnellement, cliquez sur le bouton d'icône à côté d'un dossier activé pour choisir une icône lucide pour son onglet (ou Supprimer l'icône pour effacer une icône déjà définie).
5. Enregistrer.

Un dossier affiché dans le sous-en-tête peut également être masqué ou conservé dans la barre latérale gauche de manière indépendante ; voir la carte Visibilité du dossier à côté des Dossiers de sous-en-tête pour ce basculement.

Un dossier est exempt : Commencer reste toujours dans la barre latérale, et son basculement est verrouillé. C'est là où un lecteur qui ferme l'introduction trop tôt revient, donc le cacher les laisse sans moyen de revenir.

Pages connexes#

• Mise en page de l’en-tête et navigation — la barre supérieure et l’autre emplacement où le sélecteur de langue peut se trouver
• Options de recherche — ce que recherche le champ de recherche de la barre latérale
• Paramètres de traduction — les langues proposées par le sélecteur
• Thèmes — clair, sombre, système — l’autre emplacement où le bouton de changement de thème peut se trouver