-
Notifications
You must be signed in to change notification settings - Fork 38
/
about.html
122 lines (95 loc) · 6.51 KB
/
about.html
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
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<style type="text/css" media="screen">@import "css/common.css";
@import "css/validator.css";
@import "css/documentation.css";
@import "css/validator/base.css";
</style>
<title>About the W3C Feed Validation Service</title>
</head>
<body>
<div id="banner">
<h1 id="title">
<a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="/images/w3c.png" /></a>
<a href="./"><span>Feed Validation Service</span></a>
</h1>
<p id="tagline">Check the syntax of Atom or RSS feeds</p>
</div>
<div id="main" class="doc"><!-- This DIV encapsulates everything in this page - necessary for the positioning -->
<h2>About the Feed Validator</h2>
<ul>
<li><a href="#what">What is this?</a></li>
<li><a href="#why">Why a validator?</a></li>
<li><a href="#how">What does it validate?</a></li>
<li><a href="#who">Who wrote it?</a></li>
<li><a href="#where">Can I run it locally?</a></li>
<li><a href="#where2">Is there a Web Service with a public API for this service?</a></li>
<li><a href="#when">Feedback: Can I tell you something?</a></li>
</ul>
<h3 id="what">What is this?</h3>
<p>This is a validator for syndicated feeds. It works with RSS 0.90, 0.91, 0.92, 0.93, 0.94, 1.0, and 2.0. It also validates Atom feeds.</p>
<p>To use it, simply enter the address of your feed and click Validate. If the validator finds any problems in your feed, it will give you messages for each type of problem and highlight where the problem first occurs in your feed. If you're unsure what a message means, click the "help" link next to the message for a fuller explanation.</p>
<h3 id="why">Why a validator?</h3>
<p>Despite its relatively simple nature, RSS is poorly implemented by many tools. This validator is an attempt to codify the specification (literally, to translate it into code) to make it easier to know when you're producing RSS correctly, and to help you fix it when you're not.</p>
<p>The validator also supports the IETF standard Atom format for syndicated feeds. Early adopters who wish to support Atom should use the validator to make sure they generate it properly from day 1.</p>
<p>There are validators for other web technologies, such as <a href="http://validator.w3.org/">HTML</a>, <a href="http://jigsaw.w3.org/css-validator/validator-uri.html">CSS</a>, and <a href="http://webxact.watchfire.com">accessibility guidelines</a>, and these have all proven quite popular. As personal news syndication is becoming more widespread, we saw a need for a comprehensive but easy-to-use validator for syndicated feeds.</p>
<h3 id="how">What does it validate?</h3>
<p>It validates RSS feeds against the rules defined in the <a href="docs/rss2.html">RSS 2.0 specification</a>. It also validates elements of commonly used namespaces:</p>
<ul>
<li>blogChannel</li>
<li>Dublin Core</li>
<li>itunes</li>
<li>mod_admin</li>
<li>mod_syndication</li>
<li>mod_content (<code>content:encoded</code> only)</li>
</ul>
<p>For Atom feeds, it validates against <a href="http://ietfreport.isoc.org/idref/draft-ietf-atompub-format/">draft-ietf-atompub-format-11</a>, which describes version 1.0 of the Atom feed format. This draft will become an RFC when a number is assigned by the IETF.</p>
<p>The <a href="docs/">documentation index</a> lists all the error messages that the validator produces. You can also download the entire test suite that was used to create the validator (see below).</p>
<h3 id="who">Who wrote it?</h3>
<p>The validator was conceived and designed by <a href="https://web.archive.org/web/20110926231958/http://diveintomark.org/">Mark Pilgrim</a>, who also wrote most of the test cases and designed the web front end. Much of the actual back end coding was done by <a href="http://intertwingly.net/blog/">Sam Ruby</a>.</p>
<a name="opensource" id="opensource"></a>
<h3 id="where">Can I run it locally?</h3>
<p>Yes. The validator is open source, written in Python.</p>
<blockquote><p><a href="https://github.com/w3c/feedvalidator">Download the Feed Validator from github</a></p></blockquote>
<p>To run the validator:</p>
<blockquote>
<p><samp>[feedvalidator you@localhost]$</samp> <kbd>cd src</kbd><br />
<samp>[src you@localhost]$</samp> <kbd>python demo.py http://url/to/validate</kbd></p>
</blockquote>
<p>The source code distribution also includes a complete test suite of almost 1000 feeds that were used to test the validator during development. To run the test suite:</p>
<blockquote>
<p><samp>[feedvalidator you@localhost]$</samp> <kbd>cd src</kbd><br />
<samp>[src you@localhost]$</samp> <kbd>python validtest.py -v</kbd></p>
</blockquote>
<h3 id="where2">Is there a Web Service with a public API for this service?</h3>
<p>Yes, there is a SOAP interface, accessible by using the query parameter
output="soap12" on top of a regular query. The <a href="docs/soap.html">SOAP 1.2 Web Service
API documentation</a> has more details.<p>
<h3 id="when">Feedback: Can I tell you something?</h3>
<p>Of course! Feedback for this service can be sent to the <strong>public</strong>
<a href="http://lists.w3.org/Archives/Public/www-validator/">www-validator</a> mailing-list. Since
that list is used as a feedback channel for many tools, please make
sure to mention, in the subject and body of your e-mail, that you are sending feedback on the
<em>Feed Validation Service</em>.</p>
<p>Note that this service uses software that is not developed at W3C, and bug reports for
the feedvalidator software should be sent to the <a href="http://lists.sourceforge.net/lists/listinfo/feedvalidator-users">Sourceforge mailing list</a>. If in doubt, send a very clear and precise message
to www-validator, and we will tell you if your report should be sent to the original software
maintainers.</p>
</div><!-- main -->
<ul class="navbar" id="menu">
<li>
<a href="./" accesskey="1" title="Go to the Home Page for The W3C Feed Validation Service">Home</a></li>
<li><a href="about.html" title="Information About this Service">About...</a></li>
<li><a href="whatsnew.html" title="The changes made to this service recently">News</a></li>
<li><a href="docs/" accesskey="3" title="Documentation for this Service">Docs</a></li>
</ul>
<div id="footer">
<address>
Maintained by the <a href="http://www.w3.org/QA/Tools/qa-dev">W3C qa-dev group</a><br />
This service uses the <a href="https://github.com/w3c/feedvalidator">Feed validator software</a>.
</address>
</div>
</body>
</html>