From d8825ad58784dde368cb690f015de5f908302570 Mon Sep 17 00:00:00 2001 From: Sascha Date: Mon, 13 Jul 2026 10:46:35 +0200 Subject: [PATCH] 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 --- INSTALLIEREN.html | 111 ---------------------------------------------- README.md | 38 ++++++++++++++++ 2 files changed, 38 insertions(+), 111 deletions(-) delete mode 100644 INSTALLIEREN.html create mode 100644 README.md diff --git a/INSTALLIEREN.html b/INSTALLIEREN.html deleted file mode 100644 index 49109a0..0000000 --- a/INSTALLIEREN.html +++ /dev/null @@ -1,111 +0,0 @@ - - - - - Alt-Text Checker – Installationsanleitung - - - - -

Alt-Text Checker

-

Barrierefreiheits-Bookmarklet – Installationsanleitung

- -

1. Bookmarklet installieren

-

Ziehe den folgenden Link per Drag & Drop in deine Lesezeichenleiste (Favoritenleiste):

- -

- Alt-Text Checker -

- -
-

Ist die Lesezeichenleiste nicht sichtbar? In Chrome/Edge/Firefox: Strg+Umschalt+B (Mac: Cmd+Umschalt+B).

-
- -
-

Falls Drag & Drop nicht funktioniert: Lesezeichen manuell anlegen (Rechtsklick auf Lesezeichenleiste → „Seite hinzufügen" o.ä.), als Namen „Alt-Text Checker" und als Adresse den Link-Code aus dist/bookmarklet.txt eintragen.

-
- -

2. Bookmarklet benutzen

- - -

Was bedeuten die Farben?

- - -

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 deines 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.

- - - diff --git a/README.md b/README.md new file mode 100644 index 0000000..c74c0ce --- /dev/null +++ b/README.md @@ -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.