playground:styleguide
Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
Styleguide
Style
- Boxen verwenden zum Highlighten von wichtigen Infos, siehe Seite boxen
- Accordeon-Stil für einklappbare Textbausteine über Folded-Plugin nutzen: https://www.dokuwiki.org/plugin:folded, möglichst mit Hinweis auf Ausklappbarkeit wie z.B. 🔽-Symbol oder Zusatz „(ausklappen)“
Bilder & Medien
- Bilder müssen ALT-Texte haben für Barrierefreiheit, Beispiel:
{ { Link zum Bild | ALT-Text als Bildbeschreibung, welcher bei Maus-Hover angezeigt und vom Screenreader vorgelesen werden kann } }
- Bilder, Videos, PDFs und weitere Medien sollen im richtigen Namensraum einsortiert werden, kann über den Medien-Manager erfolgen/geprüft werden
- Hinterlegte Dateien wie z.B. PDFs im Text kennzeichnen, zum Beispiel durch den Zusatz „(PDF)“ in Klammern für Barrierefreiheit
- Umlaute in Dateinamen vermeiden
Namenskonventionen
- ISIS|Moodle, sofern die Pipe | im Text möglich ist und nicht der Bild- oder Link-Formatierung dient
Verlinkungen
- TU-Seiten über Kurzlinks verlinken, Kurzlink findet sich bei jeder Seite ganz am unteren Seitenende rechts und dann mit Rechtsklick auf „Link kopieren“ gehen. Beispiel:
https://www.tu.berlin/go55014/
statthttps://www.tu.berlin/zewk/arbeitsbereiche/wissenschaftliche-weiterbildung/medienproduktion
(Hintergrund: Lange Links verhindern u.a. Lesbarkeit im Wiki-Editor) - Umlaute in Links vermeiden
- möglichst keine versteckten Seiten anlegen, die nicht aus der Sidebar erreichbar sind, sowie keine verwaisten Seiten, die nicht über Backlinks erreichbar sind: nicht wartungsfreundlich (werden schnell vergessen)!
playground/styleguide.1713179429.txt.gz · Zuletzt geändert: 2024/04/15 13:10 von julia