Comment conserver le mode sombre pour le site de la base de connaissances par défaut

Par défaut, tous les articles sur votre site de base de connaissances s’affichent en mode Lumière. Les lecteurs peuvent alterner manuellement entre Lumière et Obscurité en utilisant le bouton thème en haut de chaque article. Si vous voulez que le mode Sombre soit l’expérience par défaut, afin que les lecteurs arrivent sur Noir sans avoir à changer, vous pouvez l’implémenter en utilisant un extrait JavaScript. Vous pouvez aussi verrouiller le site uniquement en mode Sombre, en supprimant complètement le bouton pour que les lecteurs consultent toujours en mode Ténèbres.

Quand utiliser cela

Utilisez cette personnalisation lorsque vous souhaitez :

Associez votre identité de marque à une base de connaissances à thème sombre comme première impression pour tous les lecteurs.
Réduire la fatigue oculaire pour les lecteurs qui lisent principalement la documentation technique dans des environnements peu éclairés.
Verrouillez l’expérience uniquement sur le mode Sombre, garantissant une présentation visuelle cohérente quelle que soit la préférence du lecteur.

Avant que tu commences

Vous avez besoin d’accéder aux paramètres (
) > site de la base de connaissances > personnalisation du site > CSS & JavaScript personnalisés dans le portail de la base de connaissances.
Le mode sombre par défaut permet toujours aux lecteurs de passer en mode Clair en utilisant le bouton de thème en haut de chaque article. Si vous souhaitez supprimer ce bouton et appliquer le mode Sombre, complétez les deux parties de ce guide.

NOTE

Par défaut, tous les articles s’affichent en mode Lumière. Le extrait JavaScript ci-dessous supprime cela, donc le mode sombre est appliqué lors du chargement de la page.

Partie 1 - Définir le mode Sombre comme défaut

Naviguer dans les paramètres (
) > site de la base de connaissances > personnalisation du site > CSS & JavaScript personnalisés dans le portail de la base de connaissances.
Dans le volet de navigation de gauche, sélectionnez l’onglet JavaScript et collez l’extrait suivant :

$(document).ready(function() {
setTimeout(function() { document.getElementById('darkTheme').click(); }, 100); 
});

Cliquez sur Enregistrer.

Tous les articles sur votre site de base de connaissances se chargent désormais par défaut en mode Sombre. Les lecteurs peuvent toujours passer en mode Lumière en utilisant l’option Lumière en haut de n’importe quel article.

Partie 2 - Verrouiller le site uniquement en mode Sombre (optionnel)

Si vous souhaitez que les lecteurs consultent le site exclusivement en mode Sombre, sans option pour passer en mode Clair, désactivez le bouton thème dans la personnalisation du site.

Naviguer dans les paramètres (
) > site de la base de connaissances dans la barre de navigation de gauche du portail de la base de connaissances.
Dans le panneau de navigation de gauche, naviguez vers la personnalisation du site.
Dans la section thème du site , sélectionnez l’option Noir uniquement et cliquez sur Enregistrer en haut.

Le bouton de thème a désormais été retiré de tous les articles. Les lecteurs consulteront toujours votre base de connaissances en mode Ténèbres.

Meilleures pratiques

Appliquez la Partie 1 et la Partie 2 ensemble si vous avez besoin d’une application complète des Ténèbres. La Partie 1 seule est par défaut sur Sombre mais laisse le basculement visible ; un lecteur peut toujours passer à la lumière. Si la cohérence de la marque est importante, complétez la Partie 2 pour supprimer le bascule.
Consultez vos articles les plus consultés. Après avoir activé le mode Sombre par défaut, vérifiez les articles contenant des images, des tableaux et des signalements. Certains contenus avec des arrière-plans clairs codés en dur peuvent nécessiter des ajustements CSS supplémentaires pour rester lisibles en mode sombre.
Réfléchissez à votre public avant de vous limiter uniquement à l’obscurité. Certains lecteurs ayant des besoins d’accessibilité ou des réglages d’affichage spécifiques préfèrent le mode Lumière. Retirer le bascule leur enlève leur choix ; N’utilisez la serrure que lorsque votre cas d’usage l’exige fortement.