Documentation Index

Fetch the complete documentation index at: https://docs.document360.com/llms.txt

Use this file to discover all available pages before exploring further.

Clause de non-responsabilité: Cet article a été généré par traduction automatique.

As of 22 Nov 2025, the Markdown editor has been upgraded from v1.4.10 to v3.2.2. The toolbar, layout, icons, and editor structure remain unchanged.

Comment modifier le texte du nom de la langue dans les blocs de code

Prev Next

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.

NOTE

Ce 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

  1. 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.

    Custom CSS and JavaScript settings panel in the Document360 Knowledge base portal

  2. 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;
}
  1. Remplacez "Example" par le texte de votre étiquette souhaité, par exemple, "Sample code", "Command", ou le nom de votre produit.

  2. Cliquez sur Enregistrer.

    CSS tab showing the custom label snippet saved in the Custom CSS and JavaScript panel


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.