Hoe verander je de taalnaamtekst in codeblokken

Codeblokken in Document360 tonen standaard de naam van de programmeertaal als label, bijvoorbeeld css, javascript, , of xml. Voor kennisbanken die propriëtaire systemen, interne tools of niet-standaard formaten documenteren, kunnen deze generieke taallabels verwarrend of irrelevant zijn voor lezers. Door ze te vervangen door een consistent aangepast label zoals "Voorbeeld" of "Voorbeeldcode" wordt de codeblokken duidelijker en krijgt je documentatie een meer verzorgd, merkgebonden uitstraling.

Wanneer dit te gebruiken

Gebruik deze aanpassing wanneer je wilt:

• Vervang technische taalnamen door lezervriendelijke labels (bijvoorbeeld "Sample code" in plaats van "javascript").
• Pas een consistent codebloklabel toe op je hele kennisbank voor een uniforme uitstraling.
• Documenteer eigen scripttalen of configuratieformaten waarbij het standaardlabel niet overeenkomt met je inhoud.

OPMERKING

Deze CSS-wijziging geldt voor alle codeblokken in je hele kennisbank — niet voor individuele artikelen of specifieke blokken.

Voordat je begint

Je hebt toegang nodig tot instellingen > kennisbanksite > site-aanpassing > aangepaste CSS en JavaScript in het kennisbankportaal.

Hoe verander je het taallabel in codeblokken

1. Navigeer naar Instellingen (

   ) > Kennisbanksite > Site-aanpassing > Custom CSS & JavaScript in het kennisbankportaal.

   

2. Selecteer in het linker navigatiepaneel het CSS-tabblad en plak het volgende CSS-fragment:

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;
}

3. Vervang "Example" het door de gewenste labeltekst, bijvoorbeeld "Sample code", "Command", , of je productnaam.

4. Klik op Opslaan.

   

Best practices

• Kies een label dat je publiek weerspiegelt. Lezers die geen ontwikkelaars zijn, kunnen labels als "Voorbeeld" of "Commando" intuïtiever vinden dan "bash" of "python". Koppel het label aan wat je lezers dit soort content noemen.
• Houd het label kort. Codebloklabels hebben beperkte weergaveruimte. Labels van meer dan 20 tekens kunnen worden afgekapt, afhankelijk van de schermgrootte van de lezer.
• Test na het opslaan. Open een artikel op je kennisbanksite en bevestig of het nieuwe label correct verschijnt over verschillende codebloktypes voordat je het aan lezers publiceert.
• Overweeg per-block labels voor technische doelgroepen. Als je lezers ontwikkelaars zijn die de exacte taal willen zien, gebruik dan de ingebouwde custom label-functie van Document360 op individuele codeblokken in plaats van deze site-brede CSS-override. Navigeer naar het codeblok in de editor, selecteer Aangepast in het taalkeuzemenu, klik op het Bewerken-icoon en voer alleen voor dat blok een titel in.