README
1W3C::LogValidator
2=================
3
4A comprehensive, step-by-step validation tool for webmasters and web developers.
5More info, documentation, downloads : http://www.w3.org/QA/Tools/LogValidator/
6
7INSTALLATION
8 See also : DEPENDENCIES below
9
10To configure this module, cd to the directory that contains this README file
11and type the following:
12 perl Makefile.PL
13
14Alternatively, if you plan to install the W3C libraries somewhere other than
15your system's perl library directory. You can type something like this:
16 perl Makefile.PL PREFIX=/home/me/perl INSTALLDIRS=perl
17
18Then to build you run make.
19 make
20
21You can then test the module by typing:
22 make test
23
24If you have write access to the installation directories, you may then install
25by typing:
26 make install
27It will install the library in the perl tree.
28
29RUNNING THE SCRIPT
30
31Along with the library you should have received a simple script and configuration file
32that allows you to easily use the library.
33
34From the directory where this README is:
35 ( cd perl/modules/W3C/LogValidator )
36 cd bin/
37
38Edit the configuration file, using the sample as a basis:
39 cp samples/logprocess.conf path/to/file.conf
40The sample conf is commented with notes and pointers to help you understand
41the syntax of this file. It should be easy to create a config file for your server.
42 $EDITOR path/to/file.conf
43
44Make the script executable:
45 chmod a+x process.pl
46
47Learn the options:
48 ./logprocess.pl -h
49
50Then simply run the script with your favorite options, e.g:
51 ./logprocess.pl -f path/to/file.conf [options]
52
53
54DEPENDENCIES
55
56This module requires these other perl modules and libraries:
57 LWP::UserAgent (libwww-perl)
58 URI::Escape
59 Sys::Hostname (for automatic configuration)
60 Config::General
61 File::Temp
62 DB_File
63 Mail::Sendmail
64 WebService::Validator::CSS::W3C
65 W3C::LinkChecker
66read more about dependencies at http://www.w3.org/QA/Tools/LogValidator/Manual-Install#dep
67
68COPYRIGHT AND LICENCE
69
70written by Olivier Thereaux <ot@w3.org> for the W3C
71
72* W3C� SOFTWARE NOTICE AND LICENSE *
73
74Copyright � 1994-2005 World Wide Web Consortium, (Massachusetts
75Institute of Technology, European Research Consortium for Informatics
76and Mathematics, Keio University). All Rights Reserved.
77http://www.w3.org/Consortium/Legal/
78
79____________________________________
80
81This W3C work (including software, documents, or other related items) is
82being provided by the copyright holders under the following license. By
83obtaining, using and/or copying this work, you (the licensee) agree that
84you have read, understood, and will comply with the following terms and
85conditions:
86
87Permission to use, copy, modify, and distribute this software and
88its documentation, with or without modification, for any purpose and
89without fee or royalty is hereby granted, provided that you include the
90following on ALL copies of the software and documentation or portions
91thereof, including modifications, that you make:
92
93 1. The full text of this NOTICE in a location viewable to users of
94the redistributed or derivative work.
95 2. Any pre-existing intellectual property disclaimers, notices,
96or terms and conditions. If none exist, a short notice of the
97following form (hypertext is preferred, text is permitted) should
98be used within the body of any redistributed or derivative code:
99"Copyright � [$date-of-software] World Wide Web Consortium,
100(Massachusetts Institute of Technology, Institut National de Recherche
101en Informatique et en Automatique, Keio University). All Rights
102Reserved. http://www.w3.org/Consortium/Legal/"
103 3. Notice of any changes or modifications to the W3C files, including
104the date changes were made. (We recommend you provide URIs to the
105location from which the code is derived.)
106
107THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT
108HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED,
109INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR
110FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR
111DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS,
112TRADEMARKS OR OTHER RIGHTS.
113
114COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL
115OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR
116DOCUMENTATION.
117
118The name and trademarks of copyright holders may NOT be used in
119advertising or publicity pertaining to the software without specific,
120written prior permission. Title to copyright in this software and
121any associated documentation will at all times remain with copyright
122holders.
123
124____________________________________
125
126