linkchecker/doc/de/linkchecker.1

.\" This file was generated with po4a. Translate the source file.
.\" 
.TH LINKCHECKER 1 "10. März 2001"  

.SH NAME
linkchecker \- prüfe HTML Dokumente auf kaputte Verknüpfungen

.SH SYNTAX
\fBlinkchecker\fP [ \fIOptionen\fP ] [ \fIDatei\-oder\-URL\fP ]...

.SH BESCHREIBUNG
.LP
LinkChecker bietet rekursives Prüfen, Multithreading,Ausgabe als farbigen 
oder normalen Text, HTML, SQL, CSV oder einen Sitemap\-Graphen in GML oder 
XML,Unterstützung für HTTP/1.1, HTTPS, FTP, mailto:, news:, nntp:, Gopher, 
Telnet und lokale Dateiverknüpfungen,Einschränkung der 
Verknüpfungsüberprüfung mit URL Filtern bestehend aus regulären 
Ausdrücken, Proxy Unterstützung, Benutzer/Passwort Authentifizierung für 
HTTP und FTP, Unterstützung des robots.txt Protokolls, Mehrsprachigkeit, 
eine Kommandozeilenschnittstelle sowie eine CGI Webschnittstelle (benötigt 
einen HTTP Server).

.SH BEISPIELE
Der häufigste Gebrauchsfall prüft die angegebene Domäne rekursiv,
inklusive aller einzelnen nach außen zeigenden Verknüpfungen:
  \fBlinkchecker http://treasure.calvinsplayground.de/\fP

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

Keine Verbindungen zu \fBmailto:\fP Rechnern, nur die URL Syntax wird geprüft. Alle
anderen Verknüpfungen werden wie üblich geprüft:
  \fBlinkchecker \-\-ignore\-url=^mailto: www.mysite.org\fP

Überprüfung einer lokalen HTML Datei unter Unix:
  \fBlinkchecker ../bla.html\fP

Überprüfung einer lokalen HTML Datei unter Windows:
  \fBlinkchecker c:\etemp\etest.html\fP

Sie können den \fBhttp://\fP URL Anteil weglassen wenn die Domäne mit \fBwww.\fP beginnt:
  \fBlinkchecker www.myhomepage.de\fP

Sie können den \fBftp://\fP URL Anteil weglassen wenn die Domäne mit \fBftp.\fP beginnt:
  \fBlinkchecker \-r0 ftp.linux.org\fP

.SH OPTIONEN

.SS "Allgemeine Optionen"
.TP
\fB\-h\fP, \fB\-\-help\fP
Hilfe! Gebe Gebrauchsanweisung für dieses Programm aus.
.TP
\fB\-f\fP\fIDATEINAME\fP, \fB\-\-config=\fP\fIDATEINAME\fP
Benutze \fIDATEINAME\fP als Konfigurationsdatei. Standardmäßig sucht 
LinkChecker zuerst nach \fB/etc/linkchecker/linkcheckerrc\fP und dann 
\fB~/.linkchecker/linkcheckerrc\fP.
.TP
\fB\-I\fP, \fB\-\-interactive\fP
Frage nach URLs, falls keine auf der Kommandozeile eingegeben wurden.
.TP
\fB\-t\fP\fINUMMER\fP, \fB\-\-threads=\fP\fINUMMER\fP
Generate no more than the given number of threads. Default number of threads 
is 10. To disable threading specify a non\-positive number.
.TP
\fB\-\-priority\fP
Starte mit normaler Threadpriorität. Als Standard läuft LinkChecker mit 
niedriger Threadpriorität, um als Hintergrundprozess geeignet zu sein.
.TP
\fB\-\-disable\-psyco\fP
Do not use the psyco optimization module even if it is installed.
.TP
\fB\-V\fP, \fB\-\-version\fP
Gebe die Version aus und beende das Programm.

.SS Ausgabeoptionen
.TP
\fB\-v\fP, \fB\-\-verbose\fP
Log all checked URLs. Default is to log only errors and warnings.
.TP
\fB\-\-no\-warnings\fP
Don't log warnings. Default is to log warnings.
.TP
\fB\-W\fP\fIREGEX\fP, \fB\-\-warning\-regex=\fP\fIREGEX\fP
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, for example 
"This page has moved" or "Oracle Application Server error".
.TP
\fB\-\-warning\-size\-bytes=\fP\fINUMMER\fP
Print a warning if content size info is available and exceeds the given 
number of \fIbytes\fP.
.TP
\fB\-q\fP, \fB\-\-quiet\fP
Keine Ausgabe, ein Alias für \fB\-o none\fP. Dies ist nur in Verbindung mit 
\fB\-F\fP nützlich.
.TP
\fB\-o\fP\fITYP\fP[\fB/\fP\fIENKODIERUNG\fP], \fB\-\-output=\fP\fITYP\fP[\fB/\fP\fIENKODIERUNG\fP]
Specify output type as \fBtext\fP, \fBhtml\fP, \fBsql\fP, \fBcsv\fP, \fBgml\fP, \fBdot\fP, 
\fBxml\fP, \fBnone\fP or \fBblacklist\fP.  Default type is \fBtext\fP. The various 
output types are documented below.  The \fIENCODING\fP specifies the output 
encoding, the default is that of your locale.  Valid encodings are listed at 
\fBhttp://docs.python.org/lib/standard\-encodings.html\fP.
.TP
\fB\-F\fP\fITYP\fP[\fB/\fP\fIENKODIERUNG\fP][\fB/\fP\fIDATEINAME\fP], \fB\-\-file\-output=\fP\fITYP\fP[\fB/\fP\fIENKODIERUNG\fP][\fB/\fP\fIDATEINAME\fP]
Ausgabe in eine Datei namens \fBlinkchecker\-out.\fP\fITYP\fP, 
\fB$HOME/.linkchecker/blacklist\fP bei \fBblacklist\fP Ausgabe, oder \fIDATEINAME\fP 
falls angegeben. Der \fIDATEINAME\fP und \fIENKODIERUNG\fP Teil wird beim 
Ausgabetyp \fBnone\fP ignoriert, ansonsten wird die Datei überschreiben falls 
sie existiert. Sie können diese Option mehr als einmal verwenden. Gültige 
Ausgabetypen sind \fBtext\fP, \fBhtml\fP, \fBsql\fP, \fBcsv\fP, \fBgml\fP, \fBdot\fP, \fBxml\fP, 
\fBnone\fP oder \fBblacklist\fP. Standard ist keine Dateiausgabe. \fIENKODIERUNG\fP 
gibt die Ausgabekodierung an,der Standard ist die Enkodierung der 
ausgewählten Spracheinstellung. Gültige Enkodierungen sind unter 
\fBhttp://docs.python.org/lib/standard\-encodings.html\fP aufgelistet. Beachten 
Sie, dass Sie mit der Option \fB\-o none\fP jegliche Ausgaben auf der Konsole 
verhindern können.
.TP
\fB\-\-no\-status\fP
Gebe keine Statusmeldungen aus.
.TP
\fB\-D\fP\fINAME\fP, \fB\-\-debug=\fP\fINAME\fP
Print debugging output for the given logger.  Available loggers are 
\fBcmdline\fP, \fBchecking\fP, \fBcache\fP, \fBgui\fP and \fBall\fP.  Specifying \fBall\fP is 
an alias for specifying all available loggers.  The option can be given 
multiple times to debug with more than one logger.  For accurate results, 
threading and the psyco optimization module will be disabled during debug 
runs.
.TP
\fB\-\-trace\fP
Print tracing information. The psyco optimization module will be disabled 
during traced runs.
.TP
\fB\-\-profile\fP
Schreibe Profiling\-Daten in eine Datei namens \fBlinkchecker.prof\fP im 
aktuellen Arbeitsverzeichnis. Siehe auch \fB\-\-viewprof\fP.
.TP
\fB\-\-viewprof\fP
Gebe vorher generierte Profiling\-Daten aus. Siehe auch \fB\-\-profile\fP.

.SS "Optionen zum Prüfen"
.TP
\fB\-r\fP\fINUMMER\fP, \fB\-\-recursion\-level=\fP\fINUMMER\fP
Check recursively all links up to given depth.  A negative depth will enable 
infinite recursion.  Default depth is infinite.
.TP
\fB\-\-no\-follow\-url=\fP\fIREGEX\fP
Check but do not recurse into URLs matching the given regular 
expression. This option can be given multiple times.
.TP
\fB\-\-ignore\-url=\fP\fIREGEX\fP
Only check syntax of URLs matching the given regular expression.  This 
option can be given multiple times.
.TP
\fB\-C\fP, \fB\-\-cookies\fP
Akzeptiere und sende HTTP Cookies nach der RFC 2109. Lediglich Cookies, die 
zum ursprünglichen Server zurückgesendet werden, werden akzeptiert.  
Gesendete und akzeptierte Cookies werden als zusätzlicheLoginformation 
aufgeführt.
.TP
\fB\-a\fP, \fB\-\-anchors\fP
Check HTTP anchor references. Default is not to check anchors.
.TP
\fB\-\-no\-anchor\-caching\fP
Behandle url#anchora und url#anchorb beim Cachen als gleich. Dies ist zwar 
Standard bei Browsern, aber in der URI Spezifikation nicht 
enthalten. Benutzen Sie diese Option mit Vorsicht.
.TP
\fB\-u\fP\fINAME\fP, \fB\-\-user=\fP\fINAME\fP
Try the given username for HTTP and FTP authorization.  For FTP the default 
username is \fBanonymous\fP. For HTTP there is no default username. See also 
\fB\-p\fP.
.TP
\fB\-p\fP\fINAME\fP, \fB\-\-password=\fP\fINAME\fP
Verwende das angegebene Passwort für HTTP und FTP Authorisierung. Für FTP 
ist das Standardpasswort \fBanonymous@\fP. Für HTTP gibt es kein 
Standardpasswort. Siehe auch \fB\-u\fP.
.TP
\fB\-\-timeout=\fP\fINUMMER\fP
Setze den Timeout für TCP\-Verbindungen in Sekunden. Der Standard Timeout 
ist 30 Sekunden.
.TP
\fB\-P\fP\fINUMMER\fP, \fB\-\-pause=\fP\fINUMMER\fP
Pause the given number of seconds between each url check. This option 
disables threading. Default is no pause between requests.
.TP
\fB\-N\fP\fINAME\fP, \fB\-\-nntp\-server=\fP\fINAME\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.
.TP
\fB\-\-no\-proxy\-for=\fP\fIREGEX\fP
Contact hosts that match the given regular expression directly instead of 
going through a proxy. This option can be given multiple times.

.SH AUSGABETYPEN
Note that by default only errors and warnings are logged.

.TP
\fBtext\fP
Standard Textausgabe in "Schlüssel: Wert"\-Form.
.TP
\fBhtml\fP
Gebe URLs in "Schlüssel: Wert"\-Form als HTML formatiert aus. Besitzt zudem 
Verknüpfungen auf die referenzierten Seiten. Ungültige URLs haben 
Verknüpfungen zur HTML und CSS Syntaxprüfung angehängt.
.TP
\fBcsv\fP
Gebe Prüfresultat in CSV\-Format aus mit einer URL pro Zeile.
.TP
\fBgml\fP
Gebe Vater\-Kind Beziehungen zwischen verknüpften URLs als GML Graphen 
aus. Sie sollten die Option \fB\-\-verbose\fP benutzen, um einen vollständigen 
Graphen zu erhalten.
.TP
\fBdot\fP
Gebe Vater\-Kind Beziehungen zwischen verknüpften URLs als DOT Graphen 
aus. Sie sollten die Option \fB\-\-verbose\fP benutzen, um einen vollständigen 
Graphen zu erhalten.
.TP
\fBxml\fP
Gebe Prüfresultat als maschinenlesbare XML\-Datei aus.
.TP
\fBsql\fP
Gebe Prüfresultat als SQL Skript mit INSERT Befehlen aus. Ein 
Beispielskript, um die initiale SQL Tabelle zu erstellen ist unter 
create.sql zu finden.
.TP
\fBblacklist\fP
Für Cronjobs geeignet. Gibt das Prüfergebnis in eine Datei 
\fB~/.linkchecker/blacklist\fP aus, welche nur Einträge mit fehlerhaften URLs 
und die Anzahl der Fehlversuche enthält.
.TP
\fBnone\fP
Gibt nichts aus. Für Skripte geeignet.

.SH "REGULÄRE AUSDRÜCKE"
Only Python regular expressions are accepted by LinkChecker.  See 
\fBhttp://www.amk.ca/python/howto/regex/\fP for an introduction in regular 
expressions.

The only addition is that a leading exclamation mark negates the regular 
expression.

.SH BEMERKUNGEN
URLs on the commandline starting with \fBftp.\fP are treated like 
\fBftp://ftp.\fP, URLs starting with \fBwww.\fP are treated like \fBhttp://www.\fP.  
You can also give local files as arguments.

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 Optionen \fB\-s\fP und \fB\-i\fP, um dies zu 
verhindern.

Javascript Links werden zur Zeit ignoriert.

If your platform does not support threading, LinkChecker disables it 
automatically.

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

Um Proxies zu benutzen, setzen Sie $http_proxy, $https_proxy unter Unix oder 
Windows. Auf einem Mac benutzen Sie die Internet Config.

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

.SH UMGEBUNG
\fBNNTP_SERVER\fP \- gibt Standard NNTP Server an

\fBhttp_proxy\fP \- gibt Standard HTTP Proxy an

\fBftp_proxy\fP \- gibt Standard FTP Proxy an

\fBLC_MESSAGES\fP, \fBLANG\fP, \fBLANGUAGE\fP \- gibt Ausgabesprache an

.SH RÜCKGABEWERT
Der Rückgabewert ist nicht Null falls
.IP \(bu
ungültige Verknüpfungen gefunden wurden oder
.IP \(bu
link warnings were found and warnings are enabled
.IP \(bu
ein Programmfehler aufgetreten ist.

.SH DATEIEN
\fB/etc/linkchecker/linkcheckerrc\fP, \fB~/.linkchecker/linkcheckerrc\fP \- 
Standardkonfigurationsdateien

\fB~/.linkchecker/blacklist\fP \- Standard Dateiname der blacklist Logger 
Ausgabe

\fBlinkchecker\-out.\fP\fITYP\fP \- Standard Dateiname der Logausgabe

\fBhttp://docs.python.org/lib/standard\-encodings.html\fP \- gültige Ausgabe 
Enkodierungen

\fBhttp://www.amk.ca/python/howto/regex/\fP \- regular expression documentation

.SH AUTHOR
Bastian Kleineidam <calvin@users.sourceforge.net>