|
| 1 | +<?xml version="1.0" encoding="ISO-8859-1"?> |
| 2 | +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| 3 | +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> |
| 4 | +<head> |
| 5 | +<title>About the Feed Validator</title> |
| 6 | +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> |
| 7 | +<style type="text/css" media="screen">@import "css/common.css"; |
| 8 | +@import "css/documentation.css";</style> |
| 9 | +<script type="text/javascript"><!-- --></script> |
| 10 | +</head> |
| 11 | +<body> |
| 12 | + |
| 13 | +<div id="logo"> |
| 14 | +<h1><a href="/"><span id="feed"><span id="f">F</span><span id="e1">E</span><span id="e2">E</span></span><span id="d">D</span> Validator</a></h1> |
| 15 | +<p>About</p> |
| 16 | +<a class="skip" href="#startnavigation">Jump to navigation</a> |
| 17 | +</div> <!--logo--> |
| 18 | + |
| 19 | +<div id="main"> |
| 20 | + |
| 21 | +<p>On this page:</p> |
| 22 | + |
| 23 | +<ul> |
| 24 | +<li><a href="#what">What is this?</a></li> |
| 25 | +<li><a href="#why">Why a validator?</a></li> |
| 26 | +<li><a href="#how">What does it validate?</a></li> |
| 27 | +<li><a href="#who">Who wrote it?</a></li> |
| 28 | +<li><a href="#where">Can I run it locally?</a></li> |
| 29 | +</ul> |
| 30 | + |
| 31 | +<h2 id="what">What is this?</h2> |
| 32 | + |
| 33 | +<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> |
| 34 | + |
| 35 | +<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> |
| 36 | + |
| 37 | +<h2 id="why">Why a validator?</h2> |
| 38 | + |
| 39 | +<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> |
| 40 | + |
| 41 | +<p>The validator also supports the new 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> |
| 42 | + |
| 43 | +<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://bobby.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> |
| 44 | + |
| 45 | +<h2 id="how">What does it validate?</h2> |
| 46 | + |
| 47 | +<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> |
| 48 | + |
| 49 | +<ul> |
| 50 | +<li>blogChannel</li> |
| 51 | +<li>Dublin Core</li> |
| 52 | +<li>mod_admin</li> |
| 53 | +<li>mod_syndication</li> |
| 54 | +<li>mod_content (<code>content:encoded</code> only)</li> |
| 55 | +</ul> |
| 56 | + |
| 57 | +<p>For Atom feeds, it validates against <a href="http://www.mnot.net/drafts/draft-nottingham-atom-format-02.html">draft-nottingham-atom-format-02</a>, which describes version 0.3 of the Atom feed format. As the specification changes, the validator will be updated to support newer versions.</p> |
| 58 | + |
| 59 | +<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> |
| 60 | + |
| 61 | +<h2 id="who">Who wrote it?</h2> |
| 62 | + |
| 63 | +<p>The validator was conceived and designed by <a href="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> |
| 64 | + |
| 65 | +<a name="opensource" id="opensource"></a> |
| 66 | +<h2 id="where">Can I run it locally?</h2> |
| 67 | + |
| 68 | +<p>Yes. The validator is open source, written in Python, and distributed under the same license as Python itself. To run it, you will need <a href="http://python.org/">Python 2.2</a> or later, and an XML parser. Most Python distributions include a minimal XML parser which will work just fine. Mac OS X 10.2 users should install <a href="http://sourceforge.net/projects/pyxml/">PyXML</a>.</p> |
| 69 | + |
| 70 | +<blockquote><p><a href="http://feedvalidator.org/download/feedvalidator-latest.zip">Download the Feed Validator</a></p></blockquote> |
| 71 | + |
| 72 | +<p>To run the validator:</p> |
| 73 | + |
| 74 | +<blockquote> |
| 75 | +<p><samp>[feedvalidator you@localhost]$</samp> <kbd>cd src</kbd><br /> |
| 76 | +<samp>[src you@localhost]$</samp> <kbd>python demo.py http://url/to/validate</kbd></p> |
| 77 | +</blockquote> |
| 78 | + |
| 79 | +<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> |
| 80 | + |
| 81 | +<blockquote> |
| 82 | +<p><samp>[feedvalidator you@localhost]$</samp> <kbd>cd src</kbd><br /> |
| 83 | +<samp>[src you@localhost]$</samp> <kbd>python validtest.py -v</kbd></p> |
| 84 | +</blockquote> |
| 85 | + |
| 86 | +</div><!--main--> |
| 87 | + |
| 88 | +<div class="centered"> |
| 89 | +<a name="startnavigation" id="startnavigation"></a> |
| 90 | +<div class="navbarWrapper"> |
| 91 | + <div class="navbarContent"> |
| 92 | + <img class="borderTL" src="/images/borderTL.gif" alt="" width="14" height="14" /> |
| 93 | + <img class="borderTR" src="/images/borderTR.gif" alt="" width="14" height="14" /> |
| 94 | + |
| 95 | +<p> |
| 96 | +<a href="/">Home</a> · |
| 97 | +<a href="/about.html">About</a> · |
| 98 | +<a href="/news/">News</a> · |
| 99 | +<a href="/docs/">Docs</a> · |
| 100 | +<a href="/terms.html">Terms</a> |
| 101 | +</p> |
| 102 | + |
| 103 | + <div class="roundedCornerSpacer"> </div> |
| 104 | + </div><!-- .content --> |
| 105 | + <div class="bottomCorners"> |
| 106 | + <img class="borderBL" src="/images/borderBL.gif" alt="" width="14" height="14" /> |
| 107 | + <img class="borderBR" src="/images/borderBR.gif" alt="" width="14" height="14" /> |
| 108 | + </div><!-- .bottomCorners --> |
| 109 | +</div><!-- .contentWrapper --> |
| 110 | +</div><!-- .centered --> |
| 111 | + |
| 112 | +<div class="centered"> |
| 113 | +<address>Copyright © 2002-3 <a href="http://diveintomark.org/">Mark Pilgrim</a> and <a href="http://www.intertwingly.net/blog/">Sam Ruby</a></address> |
| 114 | +</div> |
| 115 | + |
| 116 | +</body> |
| 117 | +</html> |
0 commit comments