NAME¶

linkchecker - Kommandozeilenprogramm zum Prüfen von HTML Dokumenten und Webseiten auf ungültige Verknüpfungen

SYNTAX¶

linkchecker [Optionen] [Datei-oder-URL]...

BESCHREIBUNG¶

LinkChecker beinhaltet

BEISPIELE¶

Der häufigste Gebrauchsfall prüft die angegebene Domäne rekursiv:

$ linkchecker http://www.example.com/

Beachten Sie dass dies die komplette Domäne überprüft, welche aus mehreren tausend URLs bestehen kann. Benutzen Sie die Option -r, um die Rekursionstiefe zu beschränken.

Prüfe keine /secret URLs. Alle anderen Verknüpfungen werden wie üblich geprüft:

$ linkchecker --ignore-url=/secret mysite.example.com

Überprüfung einer lokalen HTML Datei unter Unix:

$ linkchecker ../bla.html

Überprüfung einer lokalen HTML Datei unter Windows:

C:\> linkchecker c:empest.html

Sie können den http:// URL Anteil weglassen wenn die Domäne mit www. beginnt:

$ linkchecker www.example.com

Sie können den ftp:// URL Anteil weglassen wenn die Domäne mit ftp. beginnt:

$ linkchecker -r0 ftp.example.com

Erzeuge einen Sitemap Graphen und konvertiere ihn mit dem graphviz dot Programm:

$ linkchecker -odot -v www.example.com | dot -Tps > sitemap.ps

OPTIONEN¶

KONFIGURATIONSDATEIEN¶

Konfigurationsdateien können alle obigen Optionen enthalten. Sie können zudem Optionen enthalten, welche nicht auf der Kommandozeile gesetzt werden können. Siehe linkcheckerrc(5) für mehr Informationen.

AUSGABETYPEN¶

Beachten Sie, dass standardmäßig nur Fehler und Warnungen protokolliert werden. Sie sollten die --verbose Option benutzen, um eine komplette URL Liste zu erhalten, besonders bei Ausgabe eines Sitemap-Graphen.

REGULÄRE AUSDRÜCKE¶

LinkChecker akzeptiert Pythons reguläre Ausdrücke. Siehe https://docs.python.org/howto/regex.html für eine Einführung. Eine Ergänzung ist, dass ein regulärer Ausdruck negiert wird falls er mit einem Ausrufezeichen beginnt.

COOKIE-DATEIEN¶

Eine Cookie-Datei enthält Standard HTTP-Header (RFC 2616) mit den folgenden möglichen Namen:

Mehrere Einträge sind durch eine Leerzeile zu trennen. Das untige Beispiel sendet zwei Cookies zu allen URLs die mit http://example.org/hello/ beginnen, und eins zu allen URLs die mit https://example.org beginnen:

Host: example.com
Path: /hello
Set-cookie: ID="smee"
Set-cookie: spam="egg"

Host: example.org
Set-cookie: baggage="elitist"; comment="hologram"

PROXY UNTERSTÜTZUNG¶

Um einen Proxy unter Unix oder Windows zu benutzen, setzen Sie die http_proxy, https_proxy oder ftp_proxy Umgebungsvariablen auf die Proxy URL. Die URL sollte die Form http://[user:pass@]host[:port] besitzen. LinkChecker erkennt auch die Proxy-Einstellungen des Internet Explorers auf einem Windows-System, und GNOME oder KDE auf Linux Systemen. Auf einem Mac benutzen Sie die Internet Konfiguration. Sie können eine komma-separierte Liste von Domainnamen in der no_proxy Umgebungsvariable setzen, um alle Proxies für diese Domainnamen zu ignorieren.

Einen HTTP-Proxy unter Unix anzugeben sieht beispielsweise so aus:

$ export http_proxy="http://proxy.example.com:8080"

Proxy-Authentifizierung wird ebenfalls unterstützt:

$ export http_proxy="http://user1:mypass@proxy.example.org:8081"

Setzen eines Proxies unter der Windows Befehlszeile:

C:\> set http_proxy=http://proxy.example.com:8080

DURCHGEFÜHRTE PRÜFUNGEN¶

Alle URLs müssen einen ersten Syntaxtest bestehen. Kleine Kodierungsfehler ergeben eine Warnung, jede andere ungültige Syntaxfehler sind Fehler. Nach dem Bestehen des Syntaxtests wird die URL in die Schlange zum Verbindungstest gestellt. Alle Verbindungstests sind weiter unten beschrieben.

PLUGINS¶

There are two plugin types: connection and content plugins. Connection plugins are run after a successful connection to the URL host. Content plugins are run if the URL type has content (mailto: URLs have no content for example) and if the check is not forbidden (ie. by HTTP robots.txt). Use the option --list-plugins for a list of plugins and their documentation. All plugins are enabled via the linkcheckerrc(5) configuration file.

REKURSION¶

Bevor eine URL rekursiv geprüft wird, hat diese mehrere Bedingungen zu erfüllen. Diese werden in folgender Reihenfolge geprüft:

Beachten Sie, dass die Verzeichnisrekursion alle Dateien in diesem Verzeichnis liest, nicht nur eine Untermenge wie bspw. index.htm.

BEMERKUNGEN¶

URLs von der Kommandozeile die mit ftp. beginnen werden wie ftp://ftp. behandelt, URLs die mit www. beginnen wie http://www.. Sie können auch lokale Dateien angeben. Falls sich Ihr System automatisch mit dem Internet verbindet (z.B. mit diald), wird es dies tun wenn Sie Links prüfen, die nicht auf Ihren lokalen Rechner verweisen Benutzen Sie die Option --ignore-url, um dies zu verhindern.

Javascript Links werden nicht unterstützt.

Wenn Ihr System keine Threads unterstützt, deaktiviert diese LinkChecker automatisch.

Sie können mehrere Benutzer/Passwort Paare in einer Konfigurationsdatei angeben.

Beim Prüfen von news: Links muß der angegebene NNTP Rechner nicht unbedingt derselbe wie der des Benutzers sein.

UMGEBUNG¶

RÜCKGABEWERT¶

Der Rückgabewert ist 2 falls

Der Rückgabewert ist 1 falls

Sonst ist der Rückgabewert Null.

LIMITIERUNGEN¶

LinkChecker benutzt Hauptspeicher für jede zu prüfende URL, die in der Warteschlange steht. Mit tausenden solcher URLs kann die Menge des benutzten Hauptspeichers sehr groß werden. Dies könnte das Programm oder sogar das gesamte System verlangsamen.

DATEIEN¶

~/.linkchecker/linkcheckerrc - Standardkonfigurationsdatei

~/.linkchecker/failures - Standard Dateiname der failures Logger Ausgabe

linkchecker-out.TYP - Standard Dateiname der Logausgabe

SIEHE AUCH¶

linkcheckerrc(5)

https://docs.python.org/library/codecs.html#standard-encodings - gültige Ausgabe Enkodierungen

https://docs.python.org/howto/regex.html - Dokumentation zu regulären Ausdrücken

AUTHOR¶

Bastian Kleineidam <bastian.kleineidam@web.de>

COPYRIGHT¶

2000-2016 Bastian Kleineidam, 2010-2021 LinkChecker Authors