linkchecker/doc/en/index.txt
2007-07-16 01:16:39 +00:00

146 lines
4.2 KiB
Text
Raw Blame History

.. meta::
:navigation.order: 0
:navigation.name: LinkChecker
================================================================
LinkChecker - check websites and HTML documents for broken links
================================================================
The latest version of this document is available at
http://linkchecker.sourceforge.net/.
Features
========
- recursive checking
- multithreaded
- output in colored or normal text, HTML, SQL, CSV, XML or a sitemap
graph in different formats
- HTTP/1.1, HTTPS, FTP, mailto:, news:, nntp:, Gopher, Telnet and local
file links support
- restriction of link checking with regular expression filters for URLs
- proxy support
- username/password authorization for HTTP and FTP
- robots.txt exclusion protocol support
- i18n support
- a command line interface
- a (Fast)CGI web interface (requires HTTP server)
Download
========
LinkChecker is `OpenSource`_ software and licensed under the `GPL`_.
Downloads are available for Windows and Unix systems from the
`LinkChecker download section`_.
.. _OpenSource:
http://www.opensource.org/
.. _GPL:
http://www.gnu.org/licenses/licenses.html#TOCGPL
.. _LinkChecker download section:
http://sourceforge.net/project/showfiles.php?group_id=1913
Requirements and installation instructions are located at the
`install documentation`_. To see what has changed between releases
look at the ChangeLog_.
.. _install documentation:
install.html
.. _ChangeLog:
http://linkchecker.svn.sourceforge.net/viewvc/linkchecker/trunk/linkchecker/ChangeLog?view=markup
Screenshots
===========
+----------------------------+----------------------------+
| .. image:: shot1_thumb.jpg | .. image:: shot2_thumb.jpg |
| :align: center | :align: center |
| :target: shot1.png | :target: shot2.png |
+----------------------------+----------------------------+
| Commandline interface | Web interface |
+----------------------------+----------------------------+
Running
=======
Running under Unix or Mac OS X platforms
----------------------------------------
The local configuration file is $HOME/.linkcheckerrc
Type "linkchecker" followed by your URLs you want to check.
Type "linkchecker -h" for help.
Running under Windows platforms
-------------------------------
Start "Check URL" in your LinkChecker program group.
URL input is interactive.
Another way is executing on the command line.
If there is a file ``linkchecker.bat`` in your Python Scripts directory
you can run eg. ``c:\Python24\Scripts\linkchecker.bat``.
If there is only a ``linkchecker`` file in your Python Scripts
directory, you have to run eg.
``c:\Python24\python.exe c:\Python24\Scripts\linkchecker``.
Running under Mac OS 9.x platforms
----------------------------------
Read the MacOS Python documentation to find out about passing
commandline options to Python scripts.
Internationalization
--------------------
For german output execute "export LC_MESSAGES=de" in bash or
"setenv LC_MESSAGES de" in tcsh.
Under Windows, execute "set LC_MESSAGES=de".
Other supported languages are 'nl' (Nederlands) and 'fr' (fran<61>ais).
You can help to translate LinkChecker by copying the included
``po/linkchecker.pot`` file to ``po/language.po``, translate it and
send it to me.
Bug reporting
=============
The `SourceForge Bug interface`_ allows submitting of bugs, patches
and requests.
.. _SourceForge Bug interface:
http://sourceforge.net/tracker/?func=add&group_id=1913&atid=101913
Subversion access
=================
The `SourceForge Subversion page`_ has all the information on how to
obtain the development version of LinkChecker. Development of
LinkChecker requires some more software to be available, which
is documented on the `installation page`_.
.. _SourceForge Subversion page:
http://sourceforge.net/svn/?group_id=1913
.. _installation page:
install.html
.. image:: http://sourceforge.net/sflogo.php?group_id=1913&type=1
:align: right
:target: http://sourceforge.net/projects/linkchecker/
:alt: SourceForge Logo
:width: 88
:height: 31
.. image:: http://sourceforge.net/images/project-support.jpg
:align: right
:target: http://sourceforge.net/donate/index.php?group_id=1913
:alt: Support This Project
:width: 88
:height: 32