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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
<!--#set var="revision" value="\$Id: index.html,v 1.42 2006-10-24 06:43:24 ot Exp $"
--><!--#set var="date" value="\$Date: 2006-10-24 06:43:24 $"
--><!--#set var="title" value="Source Code Availability for The W3C Markup Validation Service"
--><!--#set var="relroot" value="../"
--><!--#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">Fedora/Red Hat RPM package</a></li>
<li><a href="#suse">openSUSE/SUSE Linux RPM package</a></li>
<li><a href="#deb">Debian GNU/Linux 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><a name="getting" id="getting"></a>Retrieving and browsing the Code</h3>
<p><a id="skip" name="skip"></a>
The source code for the <a href="../"><acronym title="World Wide Web Consortium">W3C</acronym>
Markup Validation Service</a> is available under the terms of the <a
href="http://www.w3.org/Consortium/Legal/copyright-software"><acronym
title="World Wide Web Consortium">W3C</acronym>
Software License</a>. Source tarball 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>
<h4><a id="browse" name="browse"></a>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
the web</a>.
</p>
<p>
The most interesting files are currently
<a href="http://dev.w3.org/cvsweb/validator/httpd/cgi-bin/check">a
CGI script called "check"</a> that does pretty much everything,
and possibly also <a
href="http://dev.w3.org/cvsweb/validator/httpd/conf/httpd.conf">the
httpd.conf configuration file snippet for Apache</a>.
Select the topmost revision numbers on these
pages to see the most recent revision of each file.
</p>
<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
the web</a>.
</p>
<p>
The most interesting files are currently
<a href="http://dev.w3.org/cvsweb/validator/httpd/cgi-bin/check">a
CGI script called "check"</a> that does pretty much everything,
and possibly also <a
href="http://dev.w3.org/cvsweb/validator/httpd/conf/httpd.conf">the
httpd.conf configuration file snippet for Apache</a>.
Select the topmost revision numbers on these
pages to see the most recent revision of each file.
</p>
<h4><a id="tarball" name="tarball"></a>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="http://validator.w3.org/validator.tar.gz">the code</a>
(~300kB) and <a href="http://validator.w3.org/sgml-lib.tar.gz">the <acronym
title="Document Type Definitions">DTDs</acronym></a> (~500kB).
</p>
<h4><a id="rpm" name="rpm"></a>Fedora/Red Hat RPM package</h4>
<p>
Fedora/Red Hat RPM packages are available, courtesy of Ville Skyttä, at
Fedora Extras,
<<a href="http://fedoraproject.org/wiki/Extras">http://fedoraproject.org/wiki/Extras</a>>.
</p>
<p>
In addition to different Fedora Core versions, the RPMs
should be adaptable to other RPM based systems.
</p>
<p>
Note that the Validator RPMs have several dependencies, you'll
have to get at least the following RPMs from Fedora Extras (other
dependencies are included in the Fedora Core distribution):
</p>
<ul id="rpmdeps">
<li>w3c-markup-validator</li>
<li>w3c-markup-validator-libs</li>
<li>perl-Config-General</li>
<li>perl-HTML-Template</li>
<li>perl-Net-IP</li>
<li>perl-Set-IntSpan</li>
<li>perl-Text-Iconv</li>
</ul>
<p>
In addition, each of these may have further dependencies that must
be satisfied. All the necessary RPMs are either included in
the Fedora Core distribution(s) or are available from
<a href="http://fedoraproject.org/wiki/Extras">Fedora Extras</a>.
Use of an automated package management tool to install the
packages, such as yum or up2date is <em>strongly</em>
recommended. See the Fedora Extras
<a href="http://fedoraproject.org/wiki/Extras/UsingExtras">documentation</a>
for information about configuring these tools.
</p>
<h4><a id="suse" name="suse"></a>openSUSE/SUSE Linux RPM package</h4>
<p>
openSUSE/SUSE Linux RPM packages are available, courtesy of Sierk
Bornemann, at sierkbornemann.de,
<<a href="http://sierkbornemann.de/pub/tools/w3c-markup-validator/">http://sierkbornemann.de/pub/tools/w3c-markup-validator/</a>>.
Additionally, you can also get these packages from the new
<a href="http://software.opensuse.org/">software repository of the openSUSE build service</a> at
<<a href="http://software.opensuse.org/download/validators/">http://software.opensuse.org/download/validators/</a>>
or one of its mirrors.
</p>
<p>
The RPM packages, maintained by Sierk Bornemann, are optimized for use in
a local network (running in a VirtualHost is recommended) for home
office or web agency use.
</p>
<p>
Note that the Validator RPMs have several dependencies, you'll
have to satisfy at least the same <a href="#rpmdeps">RPM
dependencies</a> as listed above for Fedora/Red Hat.
You can get these RPMs from openSUSE (other dependencies are included
in the openSUSE distribution) or partly from
sierkbornemann.de.
</p>
<p>
In addition, each of these may have further dependencies that must
be satisfied. All the necessary RPMs are either included in
the openSUSE distribution or are additionally available at
<a href="http://sierkbornemann.de/pub/tools/w3c-markup-validator/perl-modules/">sierkbornemann.de</a> or at
<<a href="http://software.opensuse.org/download/validators/">http://software.opensuse.org/download/validators/</a>>
or one of its mirrors.
Use of an automated package management tool to install the
packages, such as <em>YaST</em>, <em>rug</em>, <em>y2pmsh</em>, <em>smart</em>,
<em>apt4rpm</em> or <em>yum</em> is recommended.
See the openSUSE
<a href="http://en.opensuse.org/Category:Package_Management">documentation</a>
for information about configuring these tools.
</p>
<h4><a name="deb" id="deb"></a>Debian GNU/Linux package</h4>
<p>
A Debian package is available, courtesy of Frédéric
Schütz.
</p>
<p>
Starting with Debian 3.1 ("Sarge"), the package and all its
dependencies are included in the official Debian distribution, and
can be installed by running the command <kbd>apt-get install
w3c-markup-validator</kbd> as root.
</p>
<p>
Debian Sarge includes version 0.6.7 of the validator; the Debian
Testing and Unstable distributions usually include the latest
version.
</p>
<h4><a id="CVS" name="CVS"></a>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
with <a href="http://www.nongnu.org/cvs/">CVS</a>;
this is the tool we use for revision control and is generally
a good thing to <a href="http://ximbiot.com/cvs/manual/">get to
know</a>.
</p>
<p>
Our CVS base is available read-only, using CVS pserver
authentication a la:
</p>
<pre>
bash$ <kbd>export CVSROOT=":pserver:anonymous@dev.w3.org:/sources/public"</kbd>
bash$ <kbd>cvs login</kbd>
(Logging in to anonymous@dev.w3.org)
CVS password: <kbd>anonymous</kbd>
bash$ <kbd>cvs get -r validator-0_7_3-release validator</kbd>
cvs server: Updating validator
cvs server: Updating validator/htdocs
U validator/htdocs/about.html
...
</pre>
<h3><a id="using" name="using"></a>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>
<!--#include virtual="../footer.html" -->
</body>
</html>
|
