Benutzer-Werkzeuge

Webseiten-Werkzeuge


playground:styleguide

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
playground:styleguide [2024/04/15 13:17] juliaplayground:styleguide [2024/05/07 13:47] (aktuell) julia
Zeile 1: Zeile 1:
 ====== Styleguide ====== ====== Styleguide ======
 ===== Style ===== ===== Style =====
-  * **Boxen verwenden** zum Highlighten von wichtigen Infos, siehe Seite [[id=playground:boxen]]+  * **Boxen verwenden** zum Highlighten von wichtigen Infos, siehe Seite [[playground: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)"   * 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 & 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 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 } }'', alternativ bitte "Bild zur Dekoration" schreiben, wenn Bild irrelevant für Inhalt ist
   * Bilder, Videos, PDFs und weitere Medien sollen im **richtigen Namensraum** einsortiert werden, kann über den Medien-Manager erfolgen/geprüft werden   * 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   * Hinterlegte Dateien wie z.B. PDFs im Text kennzeichnen, zum Beispiel durch den Zusatz "(PDF)" in Klammern für Barrierefreiheit
Zeile 17: Zeile 17:
   * Umlaute in Links vermeiden   * 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)!   * 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)!
-  * neue Seiten im richtigen und sinnvollen **Namensraum** anlegen, z.B. eine Seite zu Mikrofonen im Namensraum Medien anlegen ''medien:mikrofone'' und nicht im Namensraum ''pruefung:mikrofone'' und nicht auf der Hauptebene. Übersicht der Seiten und Namensräume: [[https://digit.zewk.tu-berlin.de/wiki/doku.php?id=sidebar&do=index]] oder über "Übersicht" im Top-Menü+  * neue Seiten im richtigen und sinnvollen **Namensraum** anlegen, z.B. eine Seite zu Mikrofonen im Namensraum Medien anlegen ''medien:mikrofone'' und nicht im Namensraum ''pruefung:mikrofone'' und nicht auf der Hauptebene. Übersicht der Seiten und Namensräume: [[https://digit.zewk.tu-berlin.de/wiki/doku.php?id=sidebar&do=index]] oder über "Übersicht" im Top-Menü oder über die Excel-Datei in unserem Isis-Kurs beim Wiki-Wartungstag 
 + 
 +===== Rating-Plugin ===== 
 +Das Rating wird automatisch unter jeden Beitrag eingefügt und kann vom Ersteller nicht geändert oder ausgeblendet werden. Aktuelles Rating (10 beste Seiten): 
 +{{rating|tag=ol,score=true,startdate=2024-04-01}} 
 + 
 +===== Seitenmanagement ===== 
 +Mittels [[https://www.dokuwiki.org/plugin:displayorphans|"display orphans"-Plugin]] lassen sich Seiten im Wiki finden, die verwaist, geplant und verlinkt sind. 
 + 
 +Verwaist ("Displays a table of orphaned pages, ie pages that exist but aren't linked to."): 
 + 
 +<<display orphaned>> 
 + 
 +Geplant ("Displays a table of wanted pages, ie pages that do not exist but are linked to."): 
 + 
 +<<display wanted>> 
 + 
 +Verlinkt (" Displays a table of linked pages, ie pages that do exist and are linked to."): 
 + 
 +<<display linked>>
  
  
War dieser Artikel hilfreich?-10+1
playground/styleguide.1713179846.txt.gz · Zuletzt geändert: 2024/04/15 13:17 von julia