Arthur de Jong

Open Source / Free Software developer

summaryrefslogtreecommitdiffstats
path: root/README
blob: adab9a63689fb7d7e065c9c11c80b968edda8e73 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
   webcheck - a website link checker

   webcheck was originally named linbot which was developed by Albert
   Hopkins (marduk) <marduk@python.net>.

   Versions up till 1.0 were maintained by Mike W. Meyer <mwm@mired.org> who
   changed the name to webcheck, http://www.mired.org/webcheck/.

   After that Arthur de Jong <arthur@arthurdejong.org> took up the work and did
   a complete rewrite, http://arthurdejong.org/webcheck/.

   Copyright (C) 1998, 1999 Albert Hopkins (marduk)
   Copyright (C) 2002 Mike W. Meyer
   Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2013 Arthur de Jong

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA

   The files produced as output from the software do not automatically fall
   under the copyright of the software, unless explicitly stated otherwise.

   webcheck includes the FancyTooltips javascript library to display readable
   tooltips. FancyTooltips is distributed under the MIT license and has the
   following copyright notices (see fancytooltips/fancytooltips.js for
   details):

   Copyright (C) 2005 Victor Kulinski
   Copyright (C) 2003 Dunstan Orchard, Ethan Marcotte, Mark Wubben
   Copyright (C) 2003 Stuart Langridge, Paul McLanahan, Peter Janes,
                 Brad Choate

INTRODUCTION
============

webcheck is a website checking tool for webmasters. It crawls a given website
and generates a number of reports. The whole system is pluggable allowing
easily adding extra reports and checks.

Features of webcheck include:
 * support for http, https, ftp and file schemes
 * view the structure of a site
 * track down broken links
 * find potentially outdated and new pages
 * list links pointing to external sites
 * can run without user intervention

webcheck is written in Python and is developed on a Debian system with
Python 2.7. Previous versions of Python are not tested regularly. Patches
to support a wider range of Python releases are welcome (provided they are
not too intrusive).


INSTALLING WEBCHECK
===================

This will install the latest version from PyPi.

  % easy_install webcheck


MANUAL INSTALLATION
===================

Installation is relatively easy. These installation instructions are for
Unix-like systems. Other operating systems may differ.

  1. Unpack the tarball in the location that you want to have it installed.
     Maybe something like /usr/local/lib/python/site-packages or /opt.
     % tar -xvzf webcheck-1.10.4.tar.gz

  2. Add a symbolic link to some place in your PATH.
     % ln -s /opt/webcheck-1.10.4/webcheck.py /usr/local/bin/webcheck

  3. Put the manual page in the MANPATH.
     % ln -s /opt/webcheck-1.10.4/webcheck.1 /usr/local/man/man1/webcheck.1


RUNNING WEBCHECK
================

Executing webcheck without any command line arguments will cause it to give a
simple synopsis of its usage and then quit. Giving it the --help option will
cause it to print out all command line options.

Webcheck writes its reports to an output directory. This is the current
directory by default. Running webcheck as something like:

  % webcheck -o /tmp/myreport http://www.example.com/

Should crawl the site and write the reports to the /tmp/myreport directory.
The reports are simple HMTL pages that should look fine with most modern
browsers.

For more information on webcheck usage and command line options, see the
webcheck manual page. If the manual page is not in the MANPATH you can
probably open the manual with something like:
  % man -l /opt/webcheck-1.10.4/webcheck.1


FEEDBACK AND BUG REPORTS
========================

If you have any questions about webcheck or would like to report a bug, please
include the following:

 * the exact webcheck command that was run
 * output of webcheck (prefferably with the --debug option)
 * gzipped webcheck.dat file from the output directory

(a simple HTML file demonstrating the bug would even be better)

Suggestions for improvements are also welcome. Patches and code contributions
are even better.

Please send all your reports to <webcheck-users@lists.arthurdejong.org>.