Richtlinien zum Schreiben von Shell-Prompt-Codebeispielen

Eine Shell ist ein Programm, das darauf wartet, dass Sie einen Befehl eingeben und dann die Eingabetaste drücken. Um anzuzeigen, welche Befehle Sie eingeben sollten, sind sie in den Inhalten von MDN Web Docs in Codeblöcken aufgelistet, ähnlich wie Codebeispiele.

Ein solcher Block sieht folgendermaßen aus:

# This may take a while...
git clone https://github.com/mdn/content
cd content

Meinungen über korrekte Einrückung, Leerzeichen und Zeilenlängen waren schon immer umstritten. Diskussionen über diese Themen lenken vom Erstellen und Pflegen von Inhalten ab.

Auf MDN Web Docs verwenden wir Prettier als Code-Formatierer, um den Code-Stil konsistent zu halten (und um themenfremde Diskussionen zu vermeiden). Sie können unsere Konfigurationsdatei einsehen, um die aktuellen Regeln kennenzulernen, und die Prettier-Dokumentation lesen.

Prettier formatiert den gesamten Code und hält den Stil konsistent. Dennoch gibt es einige zusätzliche Regeln, die Sie befolgen müssen.

Beim Schreiben eines Shell-Codeblocks:

• Schließen Sie kein $ oder > am Anfang einer Shell-Anweisung ein. Es verwirrt mehr als es hilft und ist nicht nützlich beim Kopieren der Anweisungen.
• Kommentare beginnen mit #.
• Wählen Sie "bash", um die Sprache in Markdown anzugeben.

Dokumentation zur serverseitigen Entwicklung mit Django zeigt eine gute Praxis zur Darstellung von Shell-Prompt-Befehlen.