NAME¶

linkcheckerrc - Konfigurationsdatei für LinkChecker

BESCHREIBUNG¶

linkcheckerrc ist die Standardkonfigurationsdatei von LinkChecker. Die Datei ist in einem INI-Format geschrieben.

EIGENSCHAFTEN¶

[checking]¶

threads=NUMBER

Generiere nicht mehr als die angegebene Anzahl von Threads. Standard Anzahl von Threads ist 10. Um Threads zu deaktivieren, geben Sie eine nicht positive Nummer an.

 

Kommandozeilenoption: --threads

timeout=NUMMER

Setze den Timeout für TCP-Verbindungen in Sekunden. Der Standard Timeout ist 60 Sekunden.

 

Kommandozeilenoption: --timeout

anchors=[0|1]

Prüfe HTTP Ankerverweise. Standard ist, Ankerverweise nicht zu prüfen. Diese Option aktiviert die Ausgabe der Warnung url-anchor-not-found.

 

Kommandozeilenoption: --anchors

recursionlevel=NUMBER

Prüfe rekursiv alle URLs bis zu der angegebenen Tiefe. Eine negative Tiefe bewirkt unendliche Rekursion. Standard Tiefe ist unendlich.

 

Kommandozeilenoption: --recursion-level

warningregex==REGEX

Definieren Sie einen regulären Ausdruck der eine Warnung ausgibt falls er auf den Inhalt einer geprüften URL zutrifft. Dies gilt nur für gültige Seiten deren Inhalt wir bekommen können.

 

Benutzen Sie dies, um nach Seiten zu suchen, welche bestimmte Fehler enthalten, zum Beispiel "Diese Seite wurde entfernt" oder "Oracle Applikationsfehler".

 

Kommandozeilenoption: --warning-regex

warnsizebytes=NUMBER

Gebe eine Warnung aus, wenn die Inhaltsgröße bekannt ist und die angegebene Anzahl von Bytes übersteigt.

 

Kommandozeilenoption: --warning-size-bytes

nntpserver=STRING

Gibt ein NNTP Rechner für news: Links. Standard ist die Umgebungsvariable NNTP_SERVER. Falls kein Rechner angegeben ist, wird lediglich auf korrekte Syntax des Links geprüft.

 

Kommandozeilenoption: --nntp-server

useragent=STRING

Gibt den User-Agent an, der zu HTTP-Servern geschickt wird, z.B. "Mozilla/4.0". Der Standard ist "LinkChecker/X.Y", wobei X.Y die aktuelle Version von LinkChecker ist.

 

Kommandozeilenoption: --user-agent

checkhtml=[0|1]

Prüfe Syntax von HTML URLs mit HTML tidy. Wenn HTML tidy nicht installiert ist, prüfe mit dem W3C Online Validator.

 

Kommandozeilenoption: --check-html

checkcss=[0|1]

Prüfe Syntax von CSS URLs mit cssutils. Wenn cssutils nicht installiert ist, prüfe mit dem W3C Online Validator.

 

Kommandozeilenoption: --check-css

scanvirus=[0|1]

Prüfe Inhalt von URLs auf Viren mit ClamAV.

 

Kommandozeilenoption: --scan-virus

clamavconf=Dateiname

Dateiname von clamd.conf Konfigurationsdatei.

 

Kommandozeilenoption: keine

cookies=[0|1]

Akzeptiere und sende HTTP cookies.

 

Kommandozeilenoption: --cookies

cookiefile=Dateiname

Lese eine Datei mit Cookie-Daten. Das Cookie Datenformat wird in linkchecker(1) erklärt.

 

Kommandozeilenoption: --cookiefile

pause=NUMBER

Pausiere die angegebene Anzahl von Sekunden zwischen zwei aufeinander folgenden Verbindungen zum demselben Rechner.

 

Kommandozeilenoption: --pause

debugmemory=[0|1]

Schreibe einen Speicherabzug in eine temporäre Datei wenn die Prüfung endet. Der Speicherabzug wird sowohl beim normalen Beenden der Prüfung als auch wenn die Prüfung abgebrochen wird geschrieben.

 

Der Speicherabzug funktioniert nur falls das Paket python-meliae installiert ist. Andernfalls wird eine Warnung angezeigt mit dem Hinweis dieses Paket zu installieren.

 

Kommandozeilenoption: keine

localwebroot=STRING

Beim Prüfen von absoluten URLs in lokalen Dateien wird das angegebene Wurzelverzeichnis als Basis-URL benutzt.

 

Beachten Sie dass das angegebene Verzeichnis in URL-Syntax sein muss, d.h. es muss einen normalen statt einen umgekehrten Schrägstrich zum Aneinanderfügen von Verzeichnissen benutzen. Und das angegebene Verzeichnis muss mit einem Schrägstrich enden.

 

Kommandozeilenoption: keine

[filtering]¶

ignore=REGEX (MULTILINE)

Prüfe lediglich die Syntax von URLs, welche dem angegebenen regulären Ausdruck entsprechen.

 

Kommandozeilenoption: --ignore-url

nofollow=REGEX (MULTILINE)

Prüfe URLs die auf den regulären Ausdruck zutreffen, aber führe keine Rekursion durch.

 

Kommandozeilenoption: --no-follow-url

ignorewarnings=NAME[,NAME...]

Ignoriere die kommagetrennte Liste von Warnungen. Siehe WARNUNGEN für die Liste von erkannten Warnungen.

 

Kommandozeilenoption: keine

internlinks=REGEX

Regulärer Ausdruck, um mehr URLs als interne Verknüpfungen hinzuzufügen. Standard ist dass URLs der Kommandozeile als intern gelten.

 

Kommandozeilenoption: keine

[authentication]¶

entry=REGEX BENUTZER [PASSWORT] (MULTILINE)

Erstelle verschiedene Benutzer/Passwort-Paare für verschiedene Verknüpfungsarten. Einträge sind ein Tripel (URL regulärer Ausdruck, Benutzername, Passwort) oder ein Tupel (URL regulärer Ausdruck, Benutzername), wobei die Einträge durch Leerzeichen getrennt sind.

 

Das Passwort ist optional und muss falls es fehlt auf der Kommandozeile eingegeben werden.

 

Falls der reguläre Ausdruck auf die zu prüfende URL zutrifft, wird das angegebene Benutzer/Passwort-Paar zum Authentifizieren genutzt. Die Kommandozeilenoptionen -u und -p treffen auf jede Verknüpfung zu und überschreiben daher die Einträge hier. Der erste Treffer gewinnt. Im Moment wird Authentifizierung für http[s] und ftp Verknüpfungen benutzt.

 

Kommandozeilenoption: -u, -p

loginurl=URL

Eine Anmelde-URL, die vor der Prüfung besucht wird. Benötigt einen Eintrag zur Authentifizierung und impliziert die Benutzung von Cookies, weil die meisten Anmeldungen heutzutage Cookies benutzen.

loginuserfield=NAME

Der Name für das Benutzer CGI-Feld. Der Standardname ist login.

loginpasswordfield=NAME

Der Name für das Passwort CGI-Feld. Der Standardname ist password.

loginextrafields=NAME:WERT (MULTILINE)

Optional zusätzliche CGI Namen/Werte-Paare. Die Default-Werte werden automatisch übermittelt.

[output]¶

debug=STRING[,STRING...]

Gebe Testmeldungen aus für den angegebenen Logger. Verfügbare Logger sind cmdline, checking,cache, gui, dns, thread und all. Die Angabe all ist ein Synonym für alle verfügbaren Logger.

 

[output]

status=[0|1]

Kontrolle der Statusmeldungen. Standard ist 1.

 

Kommandozeilenoption: --no-status

log=TYPE[/ENCODING]

Gib Ausgabetyp als text, html, sql, csv, gml, dot, xml, none oder blacklist an. Stadard Typ ist text. Die verschiedenen Ausgabetypen sind unten dokumentiert.

 

Das ENCODING gibt die Ausgabekodierung an. Der Standard ist das der lokalen Spracheinstellung. Gültige Enkodierungen sind unter http://docs.python.org/library/codecs.html#standard-encodings aufgelistet.

 

Kommandozeilenoption: --output

verbose=[0|1]

Falls gesetzt, gebe alle geprüften URLs einmal aus. Standard ist es, nur fehlerhafte URLs und Warnungen auszugeben.

 

Kommandozeilenoption: --verbose

complete=[0|1]

Falls gesetzt, gebe alle geprüften URLs aus, sogar Duplikate. Standard ist es, URLs nur einmal auszugeben.

 

Kommandozeilenoption: --complete

warnings=[0|1]

Falls gesetzt, gebe keine Warnungen aus. Standard ist die Ausgabe von Warnungen.

 

Kommandozeilenoption: --no-warnings

quiet=[0|1]

Falls gesetzt, erfolgt keine Ausgabe. Ein Alias für log=none. Dies ist nur in Verbindung mit fileoutput nützlich.

 

Kommandozeilenoption: --verbose

fileoutput=TYPE[,TYPE...]

Ausgabe in Datei linkchecker-out.TYPE, $HOME/.linkchecker/blacklist für blacklist Ausgabe.

 

Gültige Ausgabearten sind text, html, sql, csv, gml, dot, xml, none oder blacklist Standard ist keine Dateiausgabe. Die verschiedenen Ausgabearten sind unten dokumentiert. Bemerke, dass man alle Konsolenausgaben mit output=none unterdrücken kann.

 

Kommandozeilenoption: --file-output

[text]¶

filename=STRING

Gebe Dateiname für Textausgabe an. Standard Dateiname ist linkchecker-out.txt.

 

Kommandozeilenoption: --file-output=

parts=STRING

Kommagetrennte Liste von Teilen, die ausgegeben werden sollen. Siehe LOGGER PART weiter unten.

 

Kommandozeilenoption: keine

encoding=STRING

Gültige Enkodierungen sind unter http://docs.python.org/library/codecs.html#standard-encodings aufgelistet.

 

Die Standardenkodierung ist iso-8859-15.

color*

Farbwerte für die verschiedenen Ausgabeteile. Syntax ist color oder type;color. Der type kann bold, light, blink oder invert sein. Die color kann default, black, red, green, yellow, blue, purple, cyan, white, Black, Red, Green, Yellow, Blue, Purple, Cyan oder White sein.

 

Kommandozeilenoption: keine

colorparent=STRING

Setze Farbe des Vaters. Standard ist white.

colorurl=STRING

Setze URL Farbe. Standard ist default.

colorname=STRING

Kommandozeilenoption: --file-output=

colorreal=STRING

Setze Farbe für tatsächliche URL. Default ist cyan.

colorbase=STRING

Setzt Basisurl Farbe. Standard ist purple.

colorvalid=STRING

Setze gültige Farbe. Standard ist bold;green.

colorinvalid=STRING

Setze ungültige Farbe. Standard ist bold;red.

colorinfo=STRING

Setzt Informationsfarbe. Standard ist default.

colorwarning=STRING

Setze Warnfarbe. Standard ist bold;yellow.

colordltime=STRING

Setze Downloadzeitfarbe. Standard ist default.

colorreset=STRING

Setze Reset Farbe. Standard ist default.

[gml]¶

filename=STRING

Siehe [text] Sektion weiter oben.

parts=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

[dot]¶

filename=STRING

Siehe [text] Sektion weiter oben.

parts=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

[csv]¶

filename=STRING

Siehe [text] Sektion weiter oben.

parts=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

separator=CHAR

Das CSV Trennzeichen. Standard ist Komma (,).

quotechar=CHAR

Setze CSV Quotezeichen. Standard ist das doppelte Anführungszeichen ( ").

[sql]¶

filename=STRING

Siehe [text] Sektion weiter oben.

parts=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

dbname=STRING

Setze Datenbankname zum Speichern. Standard ist linksdb.

separator=CHAR

Setze SQL Kommandotrennzeichen. Standard ist ein Strichpunkt ( ;).

[html]¶

filename=STRING

Siehe [text] Sektion weiter oben.

parts=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

colorbackground=COLOR

Setze Reset Farbe. Standard ist default.

colorurl=

Setze HTML URL Farbe. Standard ist #dcd5cf.

colorborder=

Setze HTML Rahmenfarbe. Standard ist #000000.

colorlink=

Setze HTML Verknüpfungsfarbe. Standard ist #191c83.

colorwarning=

Setze HTML Warnfarbe. Standard ist #e0954e.

colorerror=

Setze HTML Fehlerfarbe. Standard ist #db4930.

colorok=

Setze HTML Gültigkeitsfarbe. Standard ist #3ba557.

[blacklist]¶

filename=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

[xml]¶

filename=STRING

Siehe [text] Sektion weiter oben.

parts=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

[gxml]¶

filename=STRING

Siehe [text] Sektion weiter oben.

parts=STRING

Siehe [text] Sektion weiter oben.

encoding=STRING

Siehe [text] Sektion weiter oben.

AUSGABE PARTS¶

all (für alle Teile)
id (eine eindeutige ID für jeden Logeintrag)
realurl (die volle URL Verknüpfung)
result (gültig oder ungültig, mit Nachrichten)
extern (1 oder 0, nur in einigen Ausgabetypen protokolliert)
base (base href=...)
name (<a href=...>name</a> and <img alt="name">)
parenturl (falls vorhanden)
info (einige zusätzliche Infos, z.B. FTP Willkommensnachrichten)
warning (Warnungen)
dltime (Downloadzeit)
checktime (Prüfzeit)
url (Der Original URL Name, kann relativ sein)
intro (Das Zeug am Anfang, "Beginne am ...")
outro (Das Zeug am Ende, "X Fehler gefunden ...")

MULTILINE¶

Einige Optionen können mehrere Zeilen lang sein. Jede Zeile muss dafür eingerückt werden. Zeilen die mit einer Raute ( #) beginnen werden ignoriert, müssen aber eingerückt sein.
ignore=
lconline
bookmark
# a comment ^mailto:

BEISPIEL¶

[output]
log=html
[checking]
threads=5
[filtering]
ignorewarnings=http-moved-permanent

WARNUNGEN¶

Die folgenden Warnungen werden vom Konfigurationseintrag 'ignorewarnings' erkannt:

file-missing-slash

Der file: URL fehlt ein abschließender Schrägstrich.

file-system-path

Der file: Pfad ist nicht derselbe wie der Systempfad.

ftp-missing-slash

Der ftp: URL fehlt ein abschließender Schrägstrich.

http-auth-unknonwn

Nicht unterstützte HTTP Authentifizierungsmethode.

http-cookie-store-error

Ein Fehler trat auf während des Speicherns eines Cookies.

http-decompress-error

Ein Fehler trat beim Dekomprimieren des URL Inhalts auf.

http-empty-content

Die URL besitzt keinen Inhalt.

http-moved-permanent

Die URL wurde dauerhaft verschoben.

http-robots-denied

Die http: URL-Überprüfung wurde verweigert.

http-unsupported-encoding

Der URL-Inhalt ist in einer unbekannten Kodierung verfasst.

http-wrong-redirect

Die URL wurde zu einem anderen URL-Typ umgeleitet.

ignore-url

Die URL wurde ignoriert.

mail-no-connection

Es konnte keine Verbindung zu einem MX-Rechner hergestellt werden.

mail-no-mx-host

Der MX Mail-Rechner konnte nicht gefunden werden.

mail-unverified-address

Die mailto: Addresse konnte nicht überprüft werden.

nntp-no-newsgroup

Die NNTP Nachrichtengruppe konnte nicht gefunden werden.

nntp-no-server

Es wurde kein NNTP Server gefunden.

url-anchor-not-found

URL Anker wurde nicht gefunden.

url-content-size-unequal

Der URL Inhaltsgrößenangabe und die Download-Größe sind unterschiedlich.

url-content-size-zero

Der URL Inhaltsgrößenangabe ist Null.

url-content-too-large

Der URL Inhalt ist zu groß.

url-effective-url

Die effektive URL unterscheidet sich vom Original.

url-error-getting-content

Konnte den Inhalt der URL nicht bekommen.

url-obfuscated-ip

Die IP-Adresse ist verschleiert.

url-warnregex-found

Der reguläre Ausdruck für Warnungen wurde in den URL Inhalten gefunden.

url-whitespace

Die URL %(url)s enthält Leerzeichen am Anfang oder Ende.

 

SIEHE AUCH¶

BEISPIEL

AUTHOR¶

Bastian Kleineidam <calvin@users.sourceforge.net>

COPYRIGHT¶

Copyright © 2000-2012 Bastian Kleineidam