W3C home > Mailing lists > Public > www-validator-cvs@w3.org > May 2004

validator/htdocs/source index.html,1.22.2.23,1.22.2.24

From: Olivier Thereaux <ot@hutz.w3.org>
Date: Thu, 06 May 2004 05:51:48 +0000
To: www-validator-cvs@w3.org
Message-Id: <20040506055149.0D790481A@hutz.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
       &lt;<a href="http://validator.w3.org/validator.tar.gz">http://validator.w3.org/validator.tar.gz</a>&gt;.
       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&auml;, at
             &lt;<a href="http://cachalot.mine.nu/1/">http://cachalot.mine.nu/1/</a>&gt;.
@@ -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&eacute;d&eacute;ric
             Sch&uuml;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

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 23:02:06 UTC