linkchecker/doc/de/linkcheckerrc.5

.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH linkcheckerrc 5 2007\-11\-30 LinkChecker 
.SH NAME
linkcheckerrc \- Konfigurationsdatei für LinkChecker
.
.SH BESCHREIBUNG
\fBlinkcheckerrc\fP ist die Konfigurationsdatei für LinkChecker. Die Datei ist
in einem INI\-Format geschrieben.
.br
Die Standarddatei ist \fB~/.linkchecker/linkcheckerrc\fP unter Unix\-,
\fB%HOMEPATH%\e.linkchecker\elinkcheckerrc\fP unter Windows\-Systemen.
.SH EIGENSCHAFTEN
.SS [checking]
.TP 
\fBcookiefile=\fP\fIDateiname\fP
Lese eine Datei mit Cookie\-Daten. Das Cookie Datenformat wird in
linkchecker(1) erklärt.
.br
Kommandozeilenoption: \fB\-\-cookiefile\fP
.TP 
\fBlocalwebroot=\fP\fISTRING\fP
Beim Prüfen von absoluten URLs in lokalen Dateien wird das angegebene
Wurzelverzeichnis als Basis\-URL benutzt.
.br
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.
.br
Kommandozeilenoption: keine
.TP 
\fBnntpserver=\fP\fISTRING\fP
Gibt ein NNTP Rechner für \fBnews:\fP Links. Standard ist die Umgebungsvariable
\fBNNTP_SERVER\fP. Falls kein Rechner angegeben ist, wird lediglich auf
korrekte Syntax des Links geprüft.
.br
Kommandozeilenoption: \fB\-\-nntp\-server\fP
.TP 
\fBrecursionlevel=\fP\fINUMBER\fP
Prüfe rekursiv alle URLs bis zu der angegebenen Tiefe. Eine negative Tiefe
bewirkt unendliche Rekursion. Standard Tiefe ist unendlich.
.br
Kommandozeilenoption: \fB\-\-recursion\-level\fP
.TP 
\fBthreads=\fP\fINUMBER\fP
Generiere nicht mehr als die angegebene Anzahl von Threads. Standard Anzahl
von Threads ist 100. Um Threads zu deaktivieren, geben Sie eine nicht
positive Nummer an.
.br
Kommandozeilenoption: \fB\-\-threads\fP
.TP 
\fBtimeout=\fP\fINUMMER\fP
Setze den Timeout für TCP\-Verbindungen in Sekunden. Der Standard Timeout ist
60 Sekunden.
.br
Kommandozeilenoption: \fB\-\-timeout\fP
.TP 
\fBaborttimeout=\fP\fINUMBER\fP
Time to wait for checks to finish after the user aborts the first time (with
Ctrl\-C or the abort button).  The default abort timeout is 300 seconds.
.br
Kommandozeilenoption: \fB\-\-timeout\fP
.TP 
\fBuseragent=\fP\fISTRING\fP
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.
.br
Kommandozeilenoption: \fB\-\-user\-agent\fP
.TP 
\fBsslverify=\fP[\fB0\fP|\fB1\fP|\fIdateiname\fP]
Falls der Wert Null ist werden SSL Zertifikate nicht überprüft. Falls er auf
Eins gesetzt wird (der Standard) werden SSL Zertifikate mit der gelieferten
CA Zertifikatsdatei geprüft. Falls ein Dateiname angegeben ist wird dieser
zur Prüfung verwendet.
.br
Kommandozeilenoption: keine
.TP 
\fBmaxrunseconds=\fP\fINUMBER\fP
Hört nach der angegebenen Anzahl von Sekunden auf, neue URLs zu prüfen. Dies
ist dasselbe als wenn der Benutzer nach der gegebenen Anzahl von Sekunden
stoppt (durch Drücken von Strg\-C oder Klicken auf den Knopf Abbrechen im
GUI).
.br
Standard ist nicht zu stoppen bis alle URLs geprüft sind.
.br
Kommandozeilenoption: keine
.TP 
\fBmaxnumurls=\fP\fINUMBER\fP
Maximale Anzahl von URLs die geprüft werden. Neue URLs werden nicht
angenommen nachdem die angegebene Anzahl von URLs geprüft wurde.
.br
Standard ist alle URLs anzunehmen und zu prüfen.
.br
Kommandozeilenoption: keine
.TP 
\fBmaxrequestspersecond=\fP\fINUMBER\fP
Limit the maximum number of requests per second to one host.
.TP 
\fBallowedschemes=\fP\fINAME\fP[\fB,\fP\fINAME\fP...]
Allowed URL schemes as comma\-separated list.
.SS [filtering]
.TP 
\fBignore=\fP\fIREGEX\fP (MULTILINE)
Prüfe lediglich die Syntax von URLs, welche dem angegebenen regulären
Ausdruck entsprechen.
.br
Kommandozeilenoption: \fB\-\-ignore\-url\fP
.TP 
\fBignorewarnings=\fP\fINAME\fP[\fB,\fP\fINAME\fP...]
Ignoriere die kommagetrennte Liste von Warnungen. Siehe \fBWARNUNGEN\fP für die
Liste von erkannten Warnungen.
.br
Kommandozeilenoption: keine
.TP 
\fBinternlinks=\fP\fIREGEX\fP
Regulärer Ausdruck, um mehr URLs als interne Verknüpfungen
hinzuzufügen. Standard ist dass URLs der Kommandozeile als intern gelten.
.br
Kommandozeilenoption: keine
.TP 
\fBnofollow=\fP\fIREGEX\fP (MULTILINE)
Prüfe URLs die auf den regulären Ausdruck zutreffen, aber führe keine
Rekursion durch.
.br
Kommandozeilenoption: \fB\-\-no\-follow\-url\fP
.TP 
\fBcheckextern=\fP[\fB0\fP|\fB1\fP]
Check external links. Default is to check internal links only.
.br
Command line option: \fB\-\-checkextern\fP
.SS [authentication]
.TP 
\fBentry=\fP\fIREGEX\fP \fIBENUTZER\fP [\fIPASSWORT\fP] (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.
.br
Das Passwort ist optional und muss falls es fehlt auf der Kommandozeile
eingegeben werden.
.br
Falls der reguläre Ausdruck auf die zu prüfende URL zutrifft, wird das
angegebene Benutzer/Passwort\-Paar zum Authentifizieren genutzt. Die
Kommandozeilenoptionen \fB\-u\fP und \fB\-p\fP 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.
.br
Kommandozeilenoption: \fB\-u\fP, \fB\-p\fP
.TP 
\fBloginurl=\fP\fIURL\fP
A login URL to be visited before checking. Also needs authentication data
set for it.
.TP 
\fBloginuserfield=\fP\fINAME\fP
Der Name für das Benutzer CGI\-Feld. Der Standardname ist \fBlogin\fP.
.TP 
\fBloginpasswordfield=\fP\fINAME\fP
Der Name für das Passwort CGI\-Feld. Der Standardname ist \fBpassword\fP.
.TP 
\fBloginextrafields=\fP\fINAME\fP\fB:\fP\fIWERT\fP (MULTILINE)
Optional zusätzliche CGI Namen/Werte\-Paare. Die Default\-Werte werden
automatisch übermittelt.
.SS [output]
.TP 
\fBdebug=\fP\fISTRING\fP[\fB,\fP\fISTRING\fP...]
Gebe Testmeldungen aus für den angegebenen Logger. Verfügbare Logger sind
\fBcmdline\fP, \fBchecking\fP,\fBcache\fP, \fBgui\fP, \fBdns\fP, \fBthread\fP und \fBall\fP. Die
Angabe \fBall\fP ist ein Synonym für alle verfügbaren Logger.
.br
[output]
.TP 
\fBfileoutput=\fP\fITYPE\fP[\fB,\fP\fITYPE\fP...]
Ausgabe in Datei \fBlinkchecker\-out.\fP\fITYPE\fP, \fB$HOME/.linkchecker/blacklist\fP
für \fBblacklist\fP Ausgabe.
.br
Gültige Ausgabearten sind \fBtext\fP, \fBhtml\fP, \fBsql\fP, \fBcsv\fP, \fBgml\fP, \fBdot\fP,
\fBxml\fP, \fBnone\fP oder \fBblacklist\fP Standard ist keine Dateiausgabe. Die
verschiedenen Ausgabearten sind unten dokumentiert. Bemerke, dass man alle
Konsolenausgaben mit \fBoutput=none\fP unterdrücken kann.
.br
Kommandozeilenoption: \fB\-\-file\-output\fP
.TP 
\fBlog=\fP\fITYPE\fP[\fB/\fP\fIENCODING\fP]
Gib Ausgabetyp als \fBtext\fP, \fBhtml\fP, \fBsql\fP, \fBcsv\fP, \fBgml\fP, \fBdot\fP, \fBxml\fP,
\fBnone\fP oder \fBblacklist\fP an.  Stadard Typ ist \fBtext\fP. Die verschiedenen
Ausgabetypen sind unten dokumentiert.
.br
Das \fIENCODING\fP gibt die Ausgabekodierung an. Der Standard ist das der
lokalen Spracheinstellung. Gültige Enkodierungen sind aufgelistet unter
\fBhttp://docs.python.org/library/codecs.html#standard\-encodings\fP.
.br
Kommandozeilenoption: \fB\-\-output\fP
.TP 
\fBquiet=\fP[\fB0\fP|\fB1\fP]
Falls gesetzt, erfolgt keine Ausgabe. Ein Alias für \fBlog=none\fP. Dies ist
nur in Verbindung mit \fBfileoutput\fP nützlich.
.br
Kommandozeilenoption: \fB\-\-verbose\fP
.TP 
\fBstatus=\fP[\fB0\fP|\fB1\fP]
Kontrolle der Statusmeldungen. Standard ist 1.
.br
Kommandozeilenoption: \fB\-\-no\-status\fP
.TP 
\fBverbose=\fP[\fB0\fP|\fB1\fP]
Falls gesetzt, gebe alle geprüften URLs einmal aus. Standard ist es, nur
fehlerhafte URLs und Warnungen auszugeben.
.br
Kommandozeilenoption: \fB\-\-verbose\fP
.TP 
\fBwarnings=\fP[\fB0\fP|\fB1\fP]
Falls gesetzt, gebe keine Warnungen aus. Standard ist die Ausgabe von
Warnungen.
.br
Kommandozeilenoption: \fB\-\-no\-warnings\fP
.SS [text]
.TP 
\fBfilename=\fP\fISTRING\fP
Gebe Dateiname für Textausgabe an. Standard Dateiname ist
\fBlinkchecker\-out.txt\fP.
.br
Kommandozeilenoption: \fB\-\-file\-output=\fP
.TP 
\fBparts=\fP\fISTRING\fP
Kommagetrennte Liste von Teilen, die ausgegeben werden sollen. Siehe
\fBLOGGER PART\fP weiter unten.
.br
Kommandozeilenoption: keine
.TP 
\fBencoding=\fP\fISTRING\fP
Gültige Enkodierungen sind aufgelistet unter
\fBhttp://docs.python.org/library/codecs.html#standard\-encodings\fP.
.br
Die Standardenkodierung ist \fBiso\-8859\-15\fP.
.TP 
\fIcolor*\fP
Farbwerte für die verschiedenen Ausgabeteile. Syntax ist \fIcolor\fP oder
\fItype\fP\fB;\fP\fIcolor\fP. Der \fItype\fP kann \fBbold\fP, \fBlight\fP, \fBblink\fP oder
\fBinvert\fP sein.  Die \fIcolor\fP kann \fBdefault\fP, \fBblack\fP, \fBred\fP, \fBgreen\fP,
\fByellow\fP, \fBblue\fP, \fBpurple\fP, \fBcyan\fP, \fBwhite\fP, \fBBlack\fP, \fBRed\fP,
\fBGreen\fP, \fBYellow\fP, \fBBlue\fP, \fBPurple\fP, \fBCyan\fP oder \fBWhite\fP sein.
.br
Kommandozeilenoption: keine
.TP 
\fBcolorparent=\fP\fISTRING\fP
Setze Farbe des Vaters. Standard ist \fBwhite\fP.
.TP 
\fBcolorurl=\fP\fISTRING\fP
Setze URL Farbe. Standard ist \fBdefault\fP.
.TP 
\fBcolorname=\fP\fISTRING\fP
Kommandozeilenoption: \fB\-\-file\-output=\fP
.TP 
\fBcolorreal=\fP\fISTRING\fP
Setze Farbe für tatsächliche URL. Default ist \fBcyan\fP.
.TP 
\fBcolorbase=\fP\fISTRING\fP
Setzt Basisurl Farbe. Standard ist \fBpurple\fP.
.TP 
\fBcolorvalid=\fP\fISTRING\fP
Setze gültige Farbe. Standard ist \fBbold;green\fP.
.TP 
\fBcolorinvalid=\fP\fISTRING\fP
Setze ungültige Farbe. Standard ist \fBbold;red\fP.
.TP 
\fBcolorinfo=\fP\fISTRING\fP
Setzt Informationsfarbe. Standard ist \fBdefault\fP.
.TP 
\fBcolorwarning=\fP\fISTRING\fP
Setze Warnfarbe. Standard ist \fBbold;yellow\fP.
.TP 
\fBcolordltime=\fP\fISTRING\fP
Setze Downloadzeitfarbe. Standard ist \fBdefault\fP.
.TP 
\fBcolorreset=\fP\fISTRING\fP
Setze Reset Farbe. Standard ist \fBdefault\fP.
.SS [gml]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.SS [dot]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.SS [csv]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBseparator=\fP\fICHAR\fP
Das CSV Trennzeichen. Standard ist Komma (\fB,\fP).
.TP 
\fBquotechar=\fP\fICHAR\fP
Setze CSV Quotezeichen. Standard ist das doppelte Anführungszeichen (\fB"\fP).
.SS [sql]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBdbname=\fP\fISTRING\fP
Setze Datenbankname zum Speichern. Standard ist \fBlinksdb\fP.
.TP 
\fBseparator=\fP\fICHAR\fP
Setze SQL Kommandotrennzeichen. Standard ist ein Strichpunkt (\fB;\fP).
.SS [html]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBcolorbackground=\fP\fICOLOR\fP
Setze Reset Farbe. Standard ist \fBdefault\fP.
.TP 
\fBcolorurl=\fP
Setze HTML URL Farbe. Standard ist \fB#dcd5cf\fP.
.TP 
\fBcolorborder=\fP
Setze HTML Rahmenfarbe. Standard ist \fB#000000\fP.
.TP 
\fBcolorlink=\fP
Setze HTML Verknüpfungsfarbe. Standard ist \fB#191c83\fP.
.TP 
\fBcolorwarning=\fP
Setze HTML Warnfarbe. Standard ist \fB#e0954e\fP.
.TP 
\fBcolorerror=\fP
Setze HTML Fehlerfarbe. Standard ist \fB#db4930\fP.
.TP 
\fBcolorok=\fP
Setze HTML Gültigkeitsfarbe. Standard ist \fB#3ba557\fP.
.SS [blacklist]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.SS [xml]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.SS [gxml]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.SS [sitemap]
.TP 
\fBfilename=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBparts=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBencoding=\fP\fISTRING\fP
Siehe [text] Sektion weiter oben.
.TP 
\fBpriority=\fP\fINUMMER\fP
Eine Nummer zwischen 0.0 und 1.0, welche die Priorität festlegt. Die
Standardpriorität für die erste URL ist 1.0, für alle Kind\-URLs ist sie 0.5.
.TP 
\fBfrequency=\fP[\fBalways\fP|\fBhourly\fP|\fBdaily\fP|\fBweekly\fP|\fBmonthly\fP|\fByearly\fP|\fBnever\fP]
Die Häufigkeit mit der Seiten sich ändern.
.
.SH "AUSGABE PARTS"
 \fBall\fP       (für alle Teile)
 \fBid\fP        (eine eindeutige ID für jeden Logeintrag)
 \fBrealurl\fP   (die volle URL Verknüpfung)
 \fBresult\fP    (gültig oder ungültig, mit Nachrichten)
 \fBextern\fP    (1 oder 0, nur in einigen Ausgabetypen protokolliert)
 \fBbase\fP      (base href=...)
 \fBname\fP      (<a href=...>name</a> and <img alt="name">)
 \fBparenturl\fP (falls vorhanden)
 \fBinfo\fP      (einige zusätzliche Infos, z.B. FTP Willkommensnachrichten)
 \fBwarning\fP   (Warnungen)
 \fBdltime\fP    (Downloadzeit)
 \fBchecktime\fP (Prüfzeit)
 \fBurl\fP       (Der Original URL Name, kann relativ sein)
 \fBintro\fP     (Das Zeug am Anfang, "Beginne am ...")
 \fBoutro\fP     (Das Zeug am Ende, "X Fehler gefunden ...")
.SH MULTILINE
Einige Optionen können mehrere Zeilen lang sein. Jede Zeile muss dafür
eingerückt werden. Zeilen die mit einer Raute (\fB#\fP) beginnen werden
ignoriert, müssen aber eingerückt sein.

 ignore=
   lconline
   bookmark
   # a comment   ^mailto:
.
.SH BEISPIEL
 [output]
 log=html

 [checking]
 threads=5

 [filtering]
 ignorewarnings=http\-moved\-permanent

.SH PLUGINS
All plugins have a separate section. If the section appears in the
configuration file the plugin is enabled.  Some plugins read extra options
in their section.

.SS [AnchorCheck]
Checks validity of HTML anchors.

.SS [LocationInfo]
Adds the country and if possible city name of the URL host as info.  Needs
GeoIP or pygeoip and a local country or city lookup DB installed.

.SS [RegexCheck]
Define a regular expression which prints a warning if it matches any content
of the checked link. This applies only to valid pages, so we can get their
content.

Use this to check for pages that contain some form of error message, for
example 'This page has moved' or 'Oracle Application error'.

Man beachte, dass mehrere Werte in dem regulären Ausdruck kombiniert
werden können, zum Beispiel "(Diese Seite ist umgezogen|Oracle
Applikationsfehler)".

.SS [SslCertificateCheck]
Check SSL certificate expiration date. Only internal https: links will be
checked. A domain will only be checked once to avoid duplicate warnings.
.TP 
\fBsslcertwarndays=\fP\fINUMBER\fP
Configures the expiration warning time in days.

.SS [HtmlSyntaxCheck]
Check the syntax of HTML pages with the online W3C HTML validator.  See
http://validator.w3.org/docs/api.html.

.SS [HttpHeaderInfo]
Print HTTP headers in URL info.
.TP 
\fBprefixes=\fP\fIprefix1\fP[,\fIprefix2\fP]...
List of comma separated header prefixes. For example to display all HTTP
headers that start with "X\-".

.SS [CssSyntaxCheck]
Check the syntax of HTML pages with the online W3C CSS validator.  See
http://jigsaw.w3.org/css\-validator/manual.html#expert.

.SS [VirusCheck]
Checks the page content for virus infections with clamav.  A local clamav
daemon must be installed.
.TP 
\fBclamavconf=\fP\fIDateiname\fP
Dateiname von \fBclamd.conf\fP Konfigurationsdatei.
.
.SH WARNUNGEN
Die folgenden Warnungen werden vom Konfigurationseintrag 'ignorewarnings'
erkannt:
.br
.TP 
\fBfile\-missing\-slash\fP
Der file: URL fehlt ein abschließender Schrägstrich.
.TP 
\fBfile\-system\-path\fP
Der file: Pfad ist nicht derselbe wie der Systempfad.
.TP 
\fBftp\-missing\-slash\fP
Der ftp: URL fehlt ein abschließender Schrägstrich.
.TP 
\fBhttp\-cookie\-store\-error\fP
Ein Fehler trat auf während des Speicherns eines Cookies.
.TP 
\fBhttp\-empty\-content\fP
Die URL besitzt keinen Inhalt.
.TP 
\fBmail\-no\-mx\-host\fP
Der MX Mail\-Rechner konnte nicht gefunden werden.
.TP 
\fBnntp\-no\-newsgroup\fP
Die NNTP Nachrichtengruppe konnte nicht gefunden werden.
.TP 
\fBnntp\-no\-server\fP
Es wurde kein NNTP Server gefunden.
.TP 
\fBurl\-content\-size\-zero\fP
Der URL Inhaltsgrößenangabe ist Null.
.TP 
\fBurl\-content\-too\-large\fP
Der URL Inhalt ist zu groß.
.TP 
\fBurl\-effective\-url\fP
Die effektive URL unterscheidet sich vom Original.
.TP 
\fBurl\-error\-getting\-content\fP
Konnte den Inhalt der URL nicht bekommen.
.TP 
\fBurl\-obfuscated\-ip\fP
Die IP\-Adresse ist verschleiert.
.TP 
\fBurl\-whitespace\fP
Die URL %(url)s enthält Leerzeichen am Anfang oder Ende.

.SH "SIEHE AUCH"
BEISPIEL
.
.SH AUTHOR
Bastian Kleineidam <bastian.kleineidam@web.de>
.
.SH COPYRIGHT
Copyright \(co 2000\-2014 Bastian Kleineidam