Skip to main content

Codeblöcke in Ihren Inhalten

Zu den häufigsten Anforderungen bei der Dokumentation von Software zählt das Schreiben von Codeblöcken. Das wichtigste Element hierfür ist programlisting.

So fügen Sie ein programlisting-Element hinzu:

  1. Positionieren Sie den Cursor am Anfang der Zeile, in die der Codeblock eingefügt werden soll.

  2. Drücken Sie Alt + Enter ⏎ (Windows) oder Command ⌘ + Enter ⏎ (Mac), um den Kontextmenü „Elemente“ anzuzeigen.

    Element context menu shows a search field and a list of elements that are valid at the current position.
  3. Suchen Sie das programlisting-Element und wählen Sie es aus.

    programlisting-element-added.jpg

    Sobald Sie ein programlisting-Element hinzufügen, erscheint ein Codefragment-Feld im Topic.

    code-snippet-box-added.jpg
  4. Fügen Sie Ihren Code in das Codefragment-Feld ein.

    programlisting-show.jpg

Das programlisting-Element wird manchmal als „verbatim“ bezeichnet, da der in das Element eingefügte Code exakt so dargestellt wird, wie er im Editor erscheint. Beispielsweise werden Leerzeichen und Zeilenumbrüche beibehalten, um den Code korrekt darzustellen. Einige andere Elemente funktionieren genauso, wie z. B. screen oder literallayout.

Beispiel 1. Ein programlisting-Beispiel

Hier wurde eine Javascript-Funktion innerhalb eines programlisting-Elements hinzugefügt. So sieht der Code in der Ausgabe aus.

function myFunction() { 1
    var x = "", i;
    for (i=0; i<5; i++) {
        x = x + "The number is " + i + "<br>";
    }
    document.getElementById("demo").innerHTML = x; 2
}

1

Dies ist eine Javascript-Funktion

2

Hiermit wird ein Wert für ein Element mithilfe des DOM-Modells festgelegt.

In dem gezeigten Beispiel wird ein Codeblock innerhalb des programlisting-Elements hinzugefügt. Die Javascript-Funktion enthält (1) in der ersten Zeile und (2) in der letzten Zeile. Hierbei handelt es sich um Callouts, mit denen Sie Anmerkungen erstellen können.