2000-07-14 13:02:41 +00:00
|
|
|
Installation
|
|
|
|
|
==============
|
2000-02-26 10:24:46 +00:00
|
|
|
|
2000-06-11 20:26:08 +00:00
|
|
|
Requirements
|
|
|
|
|
------------
|
2000-11-09 12:02:38 +00:00
|
|
|
Python >= 1.5.2 from http://www.python.org/
|
|
|
|
|
Distutils >= 0.9.1 from http://www.python.org/sigs/distutils-sig/
|
|
|
|
|
Python 1.6 includes the Distutils 0.9.1,
|
|
|
|
|
Python 2.0 includes the Distutils 1.0.1
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Optionally packages
|
|
|
|
|
-------------------
|
|
|
|
|
OpenSSL from http://www.openssl.org/
|
|
|
|
|
You will need Perl for Win32 (available from
|
|
|
|
|
http://www.activestate.com/ActivePerl) if you want to install OpenSSL
|
|
|
|
|
on Windows!
|
|
|
|
|
|
2000-04-28 11:17:58 +00:00
|
|
|
|
2000-10-10 09:28:27 +00:00
|
|
|
Setup
|
|
|
|
|
-----
|
2000-12-17 01:32:05 +00:00
|
|
|
Run "python setup.py config" to configure. This tests if we can
|
|
|
|
|
compile the SSL extension and writes the result in the file
|
|
|
|
|
LinkCheckerConf.py.
|
|
|
|
|
You can give additional parameters to help compiling, for example
|
|
|
|
|
Linux users can run "python setup.py config -lcrypto" to use the SSL
|
2000-11-09 12:02:38 +00:00
|
|
|
module.
|
2000-12-17 01:32:05 +00:00
|
|
|
Run "python setup.py build" to build.
|
2000-11-02 10:34:22 +00:00
|
|
|
Run "python setup.py install" to install.
|
2000-10-10 16:43:54 +00:00
|
|
|
Run "python setup.py --help" for help.
|
2000-10-10 09:28:27 +00:00
|
|
|
Debian users can build the .deb package with "debian/rules binary" as
|
|
|
|
|
root or "fakeroot debian/rules binary" as a normal user.
|
|
|
|
|
|
2000-10-13 21:58:45 +00:00
|
|
|
After installation, the system wide configuration file is in
|
|
|
|
|
<prefix>/share/linkchecker/linkcheckerrc.
|
2000-12-22 16:25:32 +00:00
|
|
|
On Debian Linux systems it is in /etc/linkcheckerrc.
|
2000-12-17 01:32:05 +00:00
|
|
|
The local configuration file is ~/.linkcheckerrc on Unix platforms.
|
2000-10-13 21:58:45 +00:00
|
|
|
|
2000-10-10 16:43:54 +00:00
|
|
|
To run the program type "linkchecker" followed by your URLs you want
|
|
|
|
|
to check.
|
2000-05-22 17:40:42 +00:00
|
|
|
Type "linkchecker -h" for help.
|
2000-03-19 14:24:33 +00:00
|
|
|
|
2000-07-10 12:29:08 +00:00
|
|
|
|
2000-11-09 12:02:38 +00:00
|
|
|
Note
|
|
|
|
|
----
|
|
|
|
|
If you want to make your own distribution with "python setup.py sdist",
|
|
|
|
|
you will need Distutils >= 0.9.4. Older versions are hanging when
|
|
|
|
|
they try to parse the MANIFEST.in file.
|
|
|
|
|
|
|
|
|
|
|
2000-07-10 12:29:08 +00:00
|
|
|
(Fast)CGI web interface
|
|
|
|
|
-----------------------
|
2000-11-09 12:02:38 +00:00
|
|
|
The *cgi files are three CGI scripts which you can use to run LinkChecker
|
2000-07-15 14:14:16 +00:00
|
|
|
with a nice graphical web interface.
|
|
|
|
|
You can use and adjust the example HTML files in the lconline directory
|
|
|
|
|
to run the script.
|
2000-11-09 12:02:38 +00:00
|
|
|
1) Choose a CGI script. The simplest is lc.cgi and you need a web server
|
|
|
|
|
with CGI support.
|
|
|
|
|
The scripts lc.fcgi (I tested this a while ago) and lc.sz_fcgi
|
|
|
|
|
(untested) need a web server with FastCGI support.
|
|
|
|
|
2) Copy the script of your choice in the CGI directory.
|
|
|
|
|
3) Adjust the "action=..." parameter in lconline/lc_cgi.html
|
|
|
|
|
to point to your CGI script.
|
|
|
|
|
4) load the lconline/index.html file, enter an URL and klick on the
|
|
|
|
|
check button
|
2000-11-16 09:43:01 +00:00
|
|
|
5) If something goes wrong, check the following:
|
|
|
|
|
a) look in the error log of your web server
|
|
|
|
|
b) be sure that you have enabled CGI support in your web server
|
|
|
|
|
do this by running other CGI scripts from which you know that
|
|
|
|
|
they are working
|
|
|
|
|
c) try to run the lc.cgi script by hand
|
|
|
|
|
d) try the testit() function in the lc.cgi script
|
