Checkweb – Anleitung

Checkweb

Webseiten lokal oder online prüfen und die Ergebnisse nachvollziehbar auswerten.

Installation und Start

Lade das DEB-Paket auf der Downloadseite herunter. Unter Linux Mint kannst du es mit der Paketverwaltung öffnen und installieren. Alternativ im Ordner der heruntergeladenen Datei:

sudo apt install ./checkweb_*.deb

Im Ordner sollte dafür nur das gewünschte Checkweb-DEB-Paket liegen. APT installiert die benötigten Abhängigkeiten automatisch mit. Nach erfolgreicher Installation wird Checkweb über den Menüeintrag gestartet.

Start des Python-Projekts

Nur wenn du Checkweb direkt als Python-Projekt verwendest, startest du es im Projektordner mit:

start.sh

Die start.sh gehört ausschließlich zum Python-Projekt. Sie dient zum Starten dieser Projektversion und installiert selbst keine Pakete.

Eine Webseite prüfen

Wähle eine lokale Prüfung oder eine Online-Prüfung.
Für eine lokale Prüfung wählst du den Projektordner. Für eine Online-Prüfung gibst du die Webseitenadresse an, beispielsweise https://example.org.
Wähle die gewünschten Prüfkategorien und kontrolliere die Grenzen für Seiten, Linktiefe und Dateien beziehungsweise HTTP-Anfragen.
Starte die Prüfung und warte auf das Ergebnis. Fehlende optionale Werkzeuge und nicht geprüfte Bereiche werden gesondert gemeldet.
Öffne die Fundstellen und behebe bestätigte Probleme im jeweiligen Projekt.

Ergebnisse richtig lesen

Fehler, Warnungen, Hinweise und nicht geprüfte Bereiche sind getrennt zu betrachten. Ein abgeschlossener Prüflauf bedeutet nicht automatisch, dass alle Bereiche geprüft werden konnten. Erreichte Grenzen machen die Prüfung unvollständig.

HTTP 404 und 410 sind bestätigte Linkfehler des Zielservers. Zugriffssperren, Mengenbegrenzungen, Serverfehler und Zeitüberschreitungen können eine manuelle oder spätere Prüfung erfordern.

Berichte speichern

Exportiere die Ergebnisse als HTML für eine lesbare Übersicht oder als JSON für die Weiterverarbeitung. Die Berichte enthalten Fundstellen, Hinweise und die Grenzen der Prüfung.

Einstellungen und Hilfe

Über „Optionen“ erreichst du Werkzeuge und Einstellungen. Unter „Hilfe“ findest du die Bedienungsanleitung und Angaben zum Programm. Die Oberfläche unterstützt Deutsch und Englisch; zusätzliche Sprachpakete können importiert werden.

Prüfung im Terminal

Lokales Projekt ohne Netzwerkzugriff prüfen:

python3 checkweb.py --local /pfad/zum/projekt --no-network --output bericht.html

Online-Prüfung mit ausgewählten Kategorien:

python3 checkweb.py --url https://example.org --checks html,links --output bericht.json

Diese Beispiele werden im Quellcodeordner ausgeführt. --help, --tools und --version liefern weitere Informationen. Exit-Code 0 steht für einen beendeten Lauf ohne Fehlerbefund, 1 für Fehlerbefunde und 2 für eine fehlgeschlagene oder unvollständige Prüfung. Hinweise und ausgelassene Bereiche bleiben trotzdem zu beachten.

Grenzen

Online wird JavaScript nicht im Browser ausgeführt. Dynamische Inhalte und serverseitiger PHP-Code können dabei nicht vollständig geprüft werden. Automatische Prüfungen ersetzen weder eine vollständige Sicherheitsprüfung noch eine vollständige Prüfung der Barrierefreiheit.

Aktuelle Projektdokumentation auf GitHub · Zu den Downloads · Kontakt