Barrierefreie Inhalte in GitLab
Auf dieser Seite
READMEs, Wikis, Tickets und Merge Requests auf gitlab.git.nrw schreiben Sie selbst. Ob andere sie mit Screenreader, starker Vergrößerung oder ohne Maus lesen können, hängt deshalb vor allem von Ihnen ab. Die folgenden Hinweise gelten für alles, was Sie in GitLab mit Markdown schreiben.
Für die Barrieren der GitLab-Oberfläche selbst ist der Hersteller verantwortlich. Was wir darüber wissen, steht in der Erklärung zur Barrierefreiheit.
Überschriften der Reihe nach
Screenreader springen über Überschriften durch ein Dokument. Beginnen Sie mit einer Überschrift erster Ebene und lassen Sie keine Ebene aus. Nutzen Sie Überschriften für die Gliederung, nicht für Hervorhebungen.
# Projektname
## Installation
### Voraussetzungen
Bilder brauchen einen Alternativtext
Beschreiben Sie in den eckigen Klammern, was das Bild zeigt und wozu es da ist. Wenn Sie ein Bild in GitLab hineinziehen oder einfügen, setzt GitLab den Dateinamen als Alternativtext ein. Ersetzen Sie ihn durch eine Beschreibung.
Die erste Zeile sagt nichts, die zweite beschreibt den Inhalt. Zeigt ein Screenshot Code oder eine Fehlermeldung, schreiben Sie den Text als Codeblock dazu oder ersetzen Sie den Screenshot ganz.
Linktexte, die für sich stehen
Viele Menschen lassen sich alle Links einer Seite als Liste vorlesen. „Hier“ oder „Link“ sagt dort nichts. Schreiben Sie das Ziel in den Linktext.
Die [Installationsanleitung](docs/install.md) beschreibt alle Schritte.
Tabellen nur für Daten
Markdown-Tabellen haben immer eine Kopfzeile. Füllen Sie sie mit Spaltennamen, damit Screenreader jede Zelle ihrer Spalte zuordnen können. Nutzen Sie Tabellen nicht, um Text nebeneinander anzuordnen.
Farbe nie als einziges Merkmal
Rot und Grün sind für viele Menschen kaum zu unterscheiden. Geben Sie Labels einen Namen, der ohne Farbe verständlich ist, zum Beispiel „Fehler“ statt nur einer roten Markierung. In Diagrammen und Grafiken helfen Beschriftungen, Muster oder Symbole zusätzlich zur Farbe.
Diagramme mit Textbeschreibung
Diagramme aus Mermaid oder PlantUML erscheinen als Grafik. Fassen Sie im Text davor oder danach zusammen, was das Diagramm zeigt, zum Beispiel die Schritte eines Ablaufs als Liste.
Videos und animierte Bilder
Videos mit Sprache brauchen Untertitel. Zeigt das Bild etwas, das der Ton nicht sagt, beschreiben Sie es im Text. Animierte GIFs dürfen nicht mehr als dreimal pro Sekunde aufblitzen.
Websites mit GitLab Pages
Eine Website, die Sie mit GitLab Pages veröffentlichen, ist eine eigene Website. Für sie gelten dieselben Grundsätze, dazu kommen Kontraste, Tastaturbedienung und die Darstellung auf kleinen Bildschirmen. Ob sie eine eigene Erklärung zur Barrierefreiheit braucht, klären Sie mit der zuständigen Stelle Ihrer Hochschule.
Barriere gefunden?
Barrieren auf gitlab.git.nrw oder auf dieser Website können Sie uns über das Kontaktformular melden. Sie brauchen dafür kein GitLab-Konto.