2014-06-11 20:44:57 +00:00
LinkChecker
============
2017-11-10 13:26:13 +00:00
|Build Status|_ |License|_
2014-07-01 17:56:50 +00:00
2020-03-31 10:08:51 +00:00
.. |Build Status| image :: https://travis-ci.com/linkchecker/linkchecker.svg?branch=master
.. _Build Status: https://travis-ci.com/linkchecker/linkchecker
2014-07-01 18:13:40 +00:00
.. |License| image :: http://img.shields.io/badge/license-GPL2-d49a6a.svg
2014-07-01 17:56:50 +00:00
.. _License: http://opensource.org/licenses/GPL-2.0
2014-06-11 20:44:57 +00:00
Check for broken links in web sites.
Features
---------
- recursive and multithreaded checking and site crawling
- 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:, Telnet and local file links support
- restrict link checking with regular expression filters for URLs
- proxy support
- username/password authorization for HTTP, FTP and Telnet
- honors robots.txt exclusion protocol
- Cookie support
- HTML5 support
2016-01-23 12:28:15 +00:00
- a command line and web interface
2014-06-11 20:44:57 +00:00
- various check plugins available, eg. HTML syntax and antivirus checks.
Installation
-------------
2018-06-22 13:54:36 +00:00
2018-11-28 14:42:56 +00:00
See `doc/install.txt`_ in the source code archive for general information. Except the given information there, please take note of the following:
.. _doc/install.txt: doc/install.txt
2018-06-22 13:54:36 +00:00
2020-05-09 12:03:23 +00:00
Python 3 or later is needed.
2014-06-11 20:44:57 +00:00
2019-10-21 13:58:41 +00:00
The version in the pip repository is old. Instead, you can use pip to install the latest release from git: `` pip install git+https://github.com/linkchecker/linkchecker.git@v9.4.0 `` . See `#4 <https://github.com/linkchecker/linkchecker/pull/4> `_ .
2017-11-10 13:26:13 +00:00
2018-06-22 13:54:36 +00:00
Windows builds are seriously lagging behind the Linux releases, see `#53 <https://github.com/linkchecker/linkchecker/issues/53> `_ for details. For now, the only two options are to install from source or use `Docker for Windows <https://www.docker.com/docker-windows> `_ .
2014-06-11 20:44:57 +00:00
Usage
------
Execute `` linkchecker http://www.example.com `` .
For other options see `` linkchecker --help `` .
2018-03-25 08:55:22 +00:00
Docker usage
-------------
If you do not want to install any additional libraries/dependencies you can use the Docker image.
Example for external web site check:
`` `
docker run --rm -it -u $(id -u):$(id -g) linkchecker/linkchecker --verbose https://google.com
`` `
Local HTML file check:
`` `
docker run --rm -it -u $(id -u):$(id -g) -v "$PWD":/mnt linkchecker/linkchecker --verbose index.html
`` `
