Replace INSTALLIEREN.html with README

README is rendered on the repo landing page; the drag-and-drop
installer moves to the pages branch since Codeberg strips
javascript: links from rendered markdown and raw file views.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Sascha 2026-07-13 10:46:35 +02:00
parent df96466cf1
commit d8825ad587
2 changed files with 38 additions and 111 deletions

File diff suppressed because one or more lines are too long

38
README.md Normal file
View File

@ -0,0 +1,38 @@
# Alt-Text Checker
Barrierefreiheits-Bookmarklet zur Prüfung von Alt-Texten auf beliebigen Webseiten.
## Installation
**Installationsseite mit Drag-&-Drop-Button:** https://saschab.codeberg.page/altchecker/
Falls die Seite nicht erreichbar ist oder Drag & Drop nicht funktioniert, geht es auch manuell:
1. Rechtsklick auf die Lesezeichenleiste deines Browsers → „Seite hinzufügen" o. ä.
2. Als Namen `Alt-Text Checker` eintragen.
3. Als Adresse den kompletten Inhalt von [`dist/bookmarklet.txt`](dist/bookmarklet.txt) einfügen.
4. Speichern.
Ist die Lesezeichenleiste nicht sichtbar? In Chrome/Edge/Firefox: `Strg+Umschalt+B` (Mac: `Cmd+Umschalt+B`).
## Benutzung
- Öffne eine beliebige Website.
- Klicke in der Lesezeichenleiste auf **„Alt-Text Checker"**.
- Jedes Bild bekommt sofort ein kleines Label mit Status.
- Erneuter Klick auf das Bookmarklet aktualisiert die Analyse (z. B. nach dem Scrollen zu neu geladenen Bildern).
## Was bedeuten die Farben?
- **Rot Fehler**: Kein `alt`-Attribut und kein ARIA-Ersatz. Screenreader können das Bild nicht beschreiben.
- **Orange Warnung**: Leeres `alt=""` (dekorativ) oder nur über ARIA benannt statt über `alt`.
- **Grün OK**: Alt-Text ist vorhanden und nicht leer.
- **Grau Ignoriert**: Das Bild wurde manuell von der Prüfung ausgeschlossen (z. B. bewusst dekorativ).
## Bild von Prüfung ausschließen
Klicke direkt auf das kleine Label neben einem Bild. Das Bild wird sofort als „ausgeschlossen" markiert. Erneuter Klick macht das rückgängig. Der Ausschluss wird im `localStorage` des Browsers pro Website-URL gespeichert und bleibt auch nach einem Neuladen der Seite erhalten.
## Datenschutz
Das Bookmarklet führt reines JavaScript im Browser aus. Es werden keine Daten an externe Server gesendet die einzige Speicherung erfolgt lokal im `localStorage` des Browsers.