Barrierefreiheit
================

Textalternativen
----------------

Personen, die nicht gut sehen oder hören können, müssen sich auf
Textalternativen für visuelle oder auditive Inhalte verlassen. Auf dieser Seite
wird beschrieben, wie ihr Bilder, Grafiken, Audio und Video zugänglich machen
könnt.

Textalternativen für Tabellen
-----------------------------

Tabellen bieten im Wesentlichen eine Gliderung über die Anordnung der Inhalte.
Daher empfehlen wir euch, Tabellen mit ``<caption/>`` zu beschreiben, alternativ
könnt ihr jedoch auch ``<table summary=""/>`` verwenden.

In reStructuredText könnt ihr für ``<caption/>`` die ``table``-Direktive
verwenden, :abbr:`z.B. (zum Beispiel)`::

    .. table:: Tabellentitel

       +-------+-------+
       …

oder::

    .. csv-table:: Tabellentitel

oder::

    .. list-table:: Tabellentitel

Dies führt zu folgendem HTML:

.. code-block:: html

    <table class="docutils align-default" id="id1">
        <caption>
            <span class="caption-text">
                Tabellentitel
            </span>
            <a class="headerlink" href="#id1" title="Link zu dieser Tabelle">
                ¶
            </a>
        </caption>
        …
    </table>

Alternative Texte für aussagekräftige Bilder und visuelle Daten
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Kommentiert dekorative Bilder

  Manche Bilder enthalten keine aussagekräftigen Informationen oder
  Zusammenhänge sondern sind dekorativ oder dienen nur der visuellen
  Formatierung. Idealerweise sollten solche Bilder entfernt werden. Falls dies
  nicht möglich ist, solltet ihr sie als *dekorativ* kommentieren oder mit ``alt
  = ""``.

  .. seealso::
     * `An alt Decision Tree
       <https://www.w3.org/WAI/tutorials/images/decision-tree/>`_
     * `WAI Decorative Images
       <https://www.w3.org/WAI/tutorials/images/decorative/>`_
     * `WebAIM Decorative Images
       <https://webaim.org/techniques/alttext/#decorative>`_

* Wenn ein aussagekräftiges Bild leicht beschrieben werden kann, gebt eine
  Textalternative an

  Schreibt klare und prägnante Textalternativen für die verbleibenden Bilder im
  Inhalt.

  Wenn das Bild anderes Material auf der Seite nur verstärkt, sollten nur sehr
  wenige Wörter verwendet werden. Viele Bilder benötigen nur ein Nomen,
  `alt="Portrait"` oder eine Nomen-Verb-Substantiv-Beschreibung `alt="Wahl der
  richtigen Datenbank"`. Bei Bildern mit aussagekräftigem Text, :abbr:`z.B. (zum
  Beispiel)` dem Screenshot einer Fehlermeldung, sollte die Textalternative
  dieselben Wörter wiederholen.

* Ist das Bild ein Steuerelement, soll die Alternative den Zweck beschreiben,
  nicht das Bild.

  .. seealso::
     * `Functional Images
       <https://www.w3.org/WAI/tutorials/images/functional/>`_

* Wird der Alternativtext länger, solltet ihr andere Optionen in Betracht ziehen

  Viele Browser und Leseprogramme beschränken die Zeichenlänge des alternativen
  Textes. In diesem Fall solltet ihr einen kurzen alternativen Text zusammen mit
  ausführlicheren Bildunterschriften erwägen.

  .. seealso::
     * `Complex Images <https://www.w3.org/WAI/tutorials/images/complex/>`_

Namen und Symbole für Videos
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Gebt kurze Namen für Symbole ohne Beschriftungen an.

  .. seealso::
     * `Icon Usability <https://www.nngroup.com/articles/icon-usability/>`_

* Gebt Videos einen Titel und eine kurze Beschreibung

  .. seealso::
     * `How to Write the Best YouTube Descriptions: Tips and Examples
       <https://blog.hootsuite.com/youtube-descriptions/>`_
     * `Providing a short text alternative that describes the purpose of live
       audio-only and live video-only content
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G68>`_
     * `Providing a short text alternative which is the accepted name or a
       descriptive name of the non-text content
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G100>`_

* Untertitel hinzufügen

  Stellt sicher, dass die Untertitel korrekt, verständlich und vollständig sind

  .. seealso::
     * `Captions/Subtitles <https://www.w3.org/WAI/media/av/captions/>`_
     * `508 Accessible Videos – How to Caption Videos
       <https://digital.gov/2014/06/30/508-accessible-videos-how-to-caption-videos/>`_
     * `BBC Subtitle Guidelines <https://bbc.github.io/subtitle-guidelines/>`_

Medienalternativen bereitstellen
--------------------------------

* Stellt aussagekräftige Alternativen zu visuellen Inhalten und Videos bereit.

  .. seealso::
     * `Providing audio that describes the important video content and
       describing it as such
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G166>`_
     * `Understanding Success Criterion 1.2.5: Audio Description (Prerecorded)
       <https://www.w3.org/WAI/WCAG21/Understanding/audio-description-prerecorded.html>`_

* Stellt eine Beschreibung des sinnvollen visuellen Inhalts in einem Audiotrack
  oder Transkript bereit. Dies kann eine separate Audiospur mit Beschreibungen
  der aussagekräftigen Visuals sein oder eine Volltextalternative ähnlich einem Drehbuch.

  .. seealso::
     * `Transcripts <https://www.w3.org/WAI/media/av/transcripts/>`_
     * `Providing a movie with extended audio descriptions
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G8>`_
     * `Providing an alternative for time based media
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G69>`_
     * `Placing a link to the alternative for time-based media immediately next
       to the non-text content
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G58>`_
     * `Providing a second, user-selectable, audio track that includes audio
       descriptions <https://www.w3.org/WAI/WCAG21/Techniques/general/G78>`_
     * `Providing an alternative for time-based media for video-only content
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G159>`_
     * `Providing a version of a movie with audio descriptions
       <https://www.w3.org/WAI/WCAG21/Techniques/general/G173>`_
     * `Understanding Success Criterion 1.2.8: Media Alternative (Prerecorded)
       <https://www.w3.org/WAI/WCAG21/Understanding/media-alternative-prerecorded.html>`_
     * `WCAG confusion around audio description
       <https://www.visionaustralia.org/community/news/2019-08-23/wcag-confusion-around-audio-description-0>`_