Les blocs de code dans Document360 affichent par défaut le nom du langage de programmation comme une étiquette, par exemple, css, javascript, ou xml. Pour les bases de connaissances qui documentent des systèmes propriétaires, des outils internes ou des formats non standardisés, ces étiquettes de langage génériques peuvent être confuses ou sans rapport avec les lecteurs. Les remplacer par une étiquette personnalisée cohérente comme « Exemple » ou « Exemple de code » rend les blocs de code plus clairs et donne à votre documentation une apparence plus soignée et de marque.
Quand utiliser cela
Utilisez cette personnalisation lorsque vous souhaitez :
- Remplacer les noms des langages techniques par des libellés adaptés à la lecture (par exemple, « Exemple de code » au lieu de « javascript »).
- Appliquez une étiquette de bloc de code cohérente sur toute votre base de connaissances pour un rendu uniforme.
- Documentez des langages de script propriétaires ou des formats de configuration où l’étiquette par défaut ne correspond pas à votre contenu.
NOTECe changement CSS s’applique à tous les blocs de code de l’ensemble de votre base de connaissances — pas aux articles individuels ou à des blocs spécifiques.
Avant que tu commences
Vous devez 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.
Comment modifier l’étiquette de langage dans les blocs de code
-
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.
-
Depuis le panneau de navigation de gauche, sélectionnez l’onglet CSS et collez le extrait CSS suivant :
div.code-toolbar>.toolbar .toolbar-item:first-child {
visibility: hidden;
}
div.code-toolbar>.toolbar .toolbar-item:first-child span:before {
visibility: visible;
content: "Example" !important;
}
-
Remplacez
"Example"par le texte de votre étiquette souhaité, par exemple,"Sample code","Command", ou le nom de votre produit. -
Cliquez sur Enregistrer.

Meilleures pratiques
- Choisissez une étiquette qui reflète votre public. Les lecteurs qui ne sont pas développeurs peuvent trouver des étiquettes comme « Example » ou « Command » plus intuitives que « bash » ou « python ». Associez l’appellation à ce que vos lecteurs appellent ce type de contenu.
- Gardez l’appellation courte. Les labels de blocs de code ont un espace d’affichage limité. Les étiquettes de plus de 20 caractères peuvent être tronquées selon la taille d’écran du lecteur.
- Test après avoir sauvegardé. Ouvrez un article sur votre site de base de connaissances et assurez-vous que la nouvelle étiquette apparaît correctement dans différents types de blocs de code avant de le publier aux lecteurs.
- Envisagez des labels par bloc pour les publics techniques. Si vos lecteurs sont des développeurs qui doivent voir exactement le langage, utilisez la fonction d’étiquette personnalisée intégrée de Document360 sur chaque bloc de code au lieu de cette dérogation CSS à l’échelle du site. Naviguez jusqu’au bloc de code dans l’éditeur, sélectionnez Personnalisé dans le menu déroulant de la langue, cliquez sur l’icône Modifier , et entrez un titre pour ce bloc uniquement.