- From: Olivier Thereaux <ot@hutz.w3.org>
- Date: Thu, 06 May 2004 05:51:48 +0000
- To: www-validator-cvs@w3.org
Update of /sources/public/validator/htdocs/source
In directory hutz:/tmp/cvs-serv29968
Modified Files:
Tag: validator-0_6_0-branch
index.html
Log Message:
refactoring download/install/devel doc
Index: index.html
===================================================================
RCS file: /sources/public/validator/htdocs/source/index.html,v
retrieving revision 1.22.2.23
retrieving revision 1.22.2.24
diff -u -d -r1.22.2.23 -r1.22.2.24
--- index.html 27 Apr 2004 23:15:38 -0000 1.22.2.23
+++ index.html 6 May 2004 05:51:45 -0000 1.22.2.24
@@ -5,6 +5,26 @@
--><!--#include virtual="../header.html" -->
<div class="doc">
<h2>Source code availability<br />for the W3C Markup Validator</h2>
+<h3 id="TableOfContents">Table of Contents</h3>
+
+ <div id="toc">
+ <ul>
+ <li><a href="#getting">Retrieving and browsing the Code</a>
+ <ul>
+ <li><a href="#browse">Browsing the code</a></li>
+ <li><a href="#tarball">Download tarballs</a></li>
+ <li><a href="#rpm">RPM package</a></li>
+ <li><a href="#deb">Debian package</a></li>
+ <li><a href="#CVS">CVS repository</a></li>
+ </ul>
+ </li>
+ <li><a href="#using">Using the code</a></li>
+ </ul>
+ </div>
+
+
+ <h3 name="getting" id="getting">Retrieving and browsing the Code</h3>
+
<p id="skip">
The source code for the <a
href="../"><acronym title="World Wide Web Consortium">W3C</acronym>
@@ -12,24 +32,14 @@
terms of the <a
href="http://www.w3.org/Consortium/Legal/copyright-software"><acronym
title="World Wide Web Consortium">W3C</acronym>
- Software Copyright</a>. Tarballs of the source, and available binary
+ Software License</a>. Tarballs of the source, and available binary
distributions, of the latest production version is always available at
<<a href="http://validator.w3.org/validator.tar.gz">http://validator.w3.org/validator.tar.gz</a>>.
Development code is only available from CVS.
</p>
- <p>
- The purpose of making the source code available is partly to allow
- others to set up mirrors of the service (either publicly or within
- an intranet behind a firewall), but also to allow us to collaborate
- on making the service better!
- </p>
- <div id="getting">
- <h3>Retrieving the Code</h3>
- <p>You can retrieve the code a number of ways:</p>
- <ul>
- <li>
- <p>
+ <h4 id="browse" name="browse">Browsing the code</h4>
+ <p>
If you just want to glance at the code, or see its revision
history, you can
<a href="http://dev.w3.org/cvsweb/validator/">browse it on
@@ -45,16 +55,14 @@
Select the topmost revision numbers on these
pages to see the most recent revision of each file.
</p>
- </li>
- <li>
- <p>
+ <h4 id="tarball" name="tarball">Download the code in tarballs</h4>
+ <p>
If you want a copy of all the files that make up the service, you
can download a tarball of <a href="../validator.tar.gz">the code</a>
(~161kB) and <a href="../sgml-lib.tar.gz">the <acronym
title="Document Type Definitions">DTDs</acronym></a> (~2.6MB).
</p>
- </li>
- <li id="rpm">
+ <h4 id="rpm" name="rpm">RPM package</h4>
<p>
RPM packages are available, courtesy of Ville Skyttä, at
<<a href="http://cachalot.mine.nu/1/">http://cachalot.mine.nu/1/</a>>.
@@ -87,8 +95,7 @@
or yum is strongly recommended. See the links above for more
information about getting and configuring these tools.
</p>
- </li>
- <li id="deb">
+ <h4 name="deb" id="deb">Debian package</h4>
<p>
A Debian package is available, courtesy of Frédéric
Schütz. The latest version is available for the Debian Woody
@@ -110,8 +117,7 @@
directly use the <kbd>apt-get</kbd> command if your
/etc/apt/sources.list file is correctly configured.
</p>
- </li>
- <li id="CVS">
+ <h4 id="CVS" name="CVS">CVS repository</h4>
<p>
If you intend to actively mirror the code and/or contribute
patches to the code, you should install and become familiar
@@ -131,7 +137,7 @@
bash$ <kbd>cvs login</kbd>
(Logging in to anonymous@dev.w3.org)
CVS password: <kbd>anonymous</kbd>
- bash$ <kbd>cvs get -r validator-0_6_5-beta2 validator</kbd>
+ bash$ <kbd>cvs get -r validator-0_6_5 validator</kbd>
cvs server: Updating validator
cvs server: Updating validator/htdocs
U validator/htdocs/about.html
@@ -147,117 +153,19 @@
</p>
</li>
</ul>
- </div>
- <div>
- <h3 id="prereq">Prerequisites</h3>
- <p>
- Before you will be able to get the code to run, you will need a few
- things already installed on your system:
- </p>
- <ul>
- <li>
- A Unix-like operating system. It may also work with Windows
- NT, Mac OS X or other systems. It has worked on Linux,
- Solaris, FreeBSD, HP-UX, and Digital UNIX. If you try it on other
- systems and get it to work, please <a href="../feedback.html">let
- us know</a> (and <a href="../feedback.html">send us patches</a>,
- if they are needed to get it to work elsewhere).
- </li>
- <li>
- <a href="http://openjade.sourceforge.net/">OpenSP</a>, version 1.5
- or newer. OpenSP is the SGML and XML parser used by the service.
- </li>
- <li>
- <a href="../sgml-lib.tar.gz">A collection of DTDs and other
- files</a> to validate against. (You do not need to download this
- if you mirror everything using <a href="#CVS">CVS</a>.)
- </li>
- <li>
- A web server: we are currently running <a
- href="http://httpd.apache.org/">Apache</a> version 1.3.27, but
- likely any version will work, and other web servers may work as
- well with some tweaking. In particular, the server needs to be
- able to run <a href="http://www.w3.org/CGI/"><acronym
- title="Common Gateway Interface">CGI</acronym></a> scripts and
- have support for
- <a href="http://httpd.apache.org/docs/howto/ssi.html"><acronym
- title="Server Side Includes">SSI</acronym></a>.
- </li>
- <li>
- <a href="http://www.perl.org/">Perl</a>: the <a
- href="http://dev.w3.org/cvsweb/validator/httpd/cgi-bin/check">main
- CGI script</a> that does everything is written in Perl.
- You'll need version 5.6.0 or newer. Additionally, the following
- <a href="http://www.cpan.org/"><acronym
- title="Comprehensive Perl Archive Network">CPAN</acronym></a>
- distributions are needed. <em>Note</em>: latest versions of these
- module distributions may require Perl newer than 5.6.0.
- As long as the minimum version requirement(s) below are satisfied,
- everything should be fine. The latest version should not be
- needed, just get an older version that works with your Perl.
- <ul>
- <li>
- <a href="http://search.cpan.org/dist/CGI.pm/">CGI.pm</a>,
- version 2.81 or newer
- </li>
- <li>
- <a href="http://search.cpan.org/dist/Config-General/">Config-General</a>
- </li>
- <li>
- <a href="http://search.cpan.org/dist/HTML-Parser/">HTML-Parser</a>,
- version 3.25 or newer
- </li>
- <li>
- <a href="http://search.cpan.org/dist/libwww-perl/">libwww-perl</a>,
- version 5.60 or newer
- </li>
- <li>
- <a href="http://search.cpan.org/dist/Net-IP/">Net-IP</a>
- </li>
- <li>
- <a href="http://search.cpan.org/dist/Set-IntSpan/">Set-IntSpan</a>
- </li>
- <li>
- <a href="http://search.cpan.org/dist/Text-Iconv/">Text-Iconv</a>
- </li>
- <li>
- <a href="http://search.cpan.org/dist/URI/">URI</a>
- </li>
- </ul>
- </li>
- <li>
- Note that the
- <a href="http://validator.w3.org/checklink">W3C Link Checker</a> is
- no longer included in the validator distribution but is now
- separately available from
- <a href="http://search.cpan.org/dist/W3C-LinkChecker/">CPAN</a>.
- </li>
- </ul>
- <p>
- If you try to use the code and succeed (or fail), please <a
- href="../feedback.html">let us know</a>!
- </p>
- </div>
+ <h3 id="using" name="using">Using the code</h3>
+
+ <p>
+ The purpose of making the source code available is partly to allow
+ others to set up mirrors of the service (either publicly or within
+ an intranet behind a firewall), but also to allow us to collaborate
+ on making the service better! If you are interested in helping with
+ the development, we suggest you first <a href="../docs/install.html">install</a>
+ the code and <a href="../docs/devel.html">read our instructions for developers</a>.
+ </p>
+
- <div id="dev">
- <h3>Development</h3>
- <p>
- For information on current development activity, see the <a
- href="http://lists.w3.org/Archives/Public/www-validator/">www-validator
- mailing list archives</a>. To join in discussions about the
- Validator, please join us in the <code>#validator</code> IRC channel
- on <code>irc.freenode.net</code>.
- </p>
- <p>
- Any changes to the service will attempt to maintain
- compatibility with a <a href="../dev/tests/">list of test cases</a>.
- Any changes to the code or documentation related to the service cause
- a notification message to be sent to the <a
- href="http://lists.w3.org/Archives/Public/www-validator-cvs/">www-validator-cvs
- mailing list</a>.
- </p>
- </div>
</div>
<!--#include virtual="../footer.html" -->
</body>
Received on Thursday, 6 May 2004 01:55:54 UTC