...
Einsatz von Schriften
- Bitte Überschrift-Typen 1 2 - 3 verwendet werden. Die nachfolgenden anderen Überschriften-Größen sehen unschön aus und nehmen Lesbarkeit.
- Überschriften sollen über das Absatz-Menü (oben links) ausgewählt werden und nicht fett markiert oder oder großgestellt groß gestellt werden.
- Code sollte im Fließtext mit der
Festbreitenschriftart
gekennzeichnet werden. Neben der Schriftfarbe unter mehr.
...
Abstände sollten durch die jeweilige Auszeichnung der Textes definiert werden. BedeutetDas bedeutet, man darf vor oder nach einer Überschrift keine händische Leerzeile einfügen. Die Darstellung in der Bearbeiten-Ansicht kann sich gegenüber von der tatsächlichen Darstellung unterscheiden. Fließtext sollten Fließtexte sollen auch ohne Umbrüche geschrieben werden da das Styling der Seite die Umbrüche selbst definiert.
Bilder
- Bilder sollten mit der maximalen Breite von 800px und in guter Qualität eingebunden werden.
- Bilder sollen immer in Original-Größe platziert werden.
- Auf einen Rahmen oder Effekt soll verzichtet werden.
- Screenshots sollten nur den relevanten Bild-Bereich enthalten und dementsprechend auch ohne unschönen Hintergrund eingebunden werden.
Tipp: Firefox bietet eine Screenshot-Funktion mit der es Möglich ist einen speziellen DOM-Node zu screenshotten um tatsächlich nur dieses Element auf dem Screenshot zu haben https://developer.mozilla.org/en-US/docs/Tools/Taking_screenshots#Taking_a_screenshot_of_an_element.
Tabellen
Tabellen sollen mit flexibler Breite erstellt werden. Ziehen Sie die Tabelle nach dem Anlegen auf die gesamte Breite.
...
Codebeispiele sollten mit dem Makro Code
dargestellt werden. Das findet sich im Menü unter dem Plus-Icon unter Andere Makros (oder strg + shift + a). Dort kann man nach Code suchen. Verwenden Sie bitte folgende Einstellungen:
ergibtBeispiel:
Codeblock | ||||||
---|---|---|---|---|---|---|
| ||||||
// Man beachte die Code-Guidelines $foo = 'bar'; $fooA = [ 'index' => 'value' ]; |
...
Tipp: Es kann dort auch bei Erweitert „Erweitert“ auf eine spezielle Überschrift verknüpft werden. Ein Beispiel.
...