Codeblöcke in Document360 zeigen standardmäßig den Namen der Programmiersprache als Bezeichnung an, zum Beispiel css, javascript, oder xml. Für Wissensbasen, die proprietäre Systeme, interne Werkzeuge oder nicht-standardisierte Formate dokumentieren, können diese generischen Sprachlabels für Leser verwirrend oder irrelevant sein. Wenn Sie sie durch ein einheitliches benutzerdefiniertes Label wie "Beispiel" oder "Beispielcode" ersetzen, werden Codeblöcke klarer und Ihre Dokumentation ausgefeilter, gebrandeter gestaltet.
Wann sollte man das verwenden
Nutzen Sie diese Anpassung, wenn Sie:
- Ersetze technische Sprachnamen durch leserfreundliche Bezeichnungen (zum Beispiel "Beispielcode" statt "JavaScript").
- Verwenden Sie ein einheitliches Codeblock-Label auf Ihrer gesamten Wissensdatenbank für ein einheitliches Aussehen.
- Dokumentiere proprietäre Skriptsprachen oder Konfigurationsformate, bei denen das Standardlabel nicht mit deinem Inhalt übereinstimmt.
HINWEISDiese CSS-Änderung gilt für alle Codeblöcke in Ihrer gesamten Wissensdatenbank – nicht für einzelne Artikel oder spezifische Blöcke.
Bevor du anfängst
Sie benötigen Zugriff auf die Einstellungen > Knowledge Base-Website > Site-Anpassung > benutzerdefiniertes CSS und JavaScript im Knowledge Base-Portal.
Wie man das Sprachlabel in Codeblöcken ändert
-
Navigiere zu den Einstellungen (
) > Wissensdatenbank-Seite > Site-Anpassung > benutzerdefiniertes CSS und JavaScript im Knowledge Base-Portal.
-
Wählen Sie im linken Navigationsfeld den CSS-Tab aus und fügen Sie folgenden CSS-Snippet ein:
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;
}
-
Ersetzen Sie
"Example"den gewünschten Text des Etiketts, zum Beispiel"Sample code","Command", oder Ihren Produktnamen. -
Klicken Sie auf Speichern.

Best Practices
- Wählen Sie ein Label, das Ihr Publikum widerspiegelt. Leser, die keine Entwickler sind, finden Bezeichnungen wie "Beispiel" oder "Befehl" intuitiver als "bash" oder "python". Passen Sie das Etikett an das ab, was Ihre Leser diese Art von Inhalten nennen.
- Halte das Etikett kurz. Codeblock-Etiketten haben nur begrenzten Anzeigeplatz. Beschriftungen über 20 Zeichen können je nach Bildschirmgröße des Lesers abgeschnitten werden.
- Test nach dem Speichern. Öffnen Sie einen Artikel auf Ihrer Wissensdatenbank und bestätigen Sie, dass das neue Label bei verschiedenen Codeblocktypen korrekt erscheint, bevor es an die Leser veröffentlicht wird.
- Betrachten Sie für technische Zielgruppen Per-Block-Labels. Wenn Ihre Leser Entwickler sind, die die genaue Sprache sehen möchten, verwenden Sie die integrierte benutzerdefinierte Label-Funktion von Document360 auf einzelnen Codeblöcken anstelle dieser siteweiten CSS-Überschreibung. Navigiere zum Codeblock im Editor, wähle im Sprach-Dropdown-Menü benutzerdefiniert , klicke auf das Bearbeiten-Symbol und gib für diesen Block einen Titel ein.