mirror of
https://github.com/viq/NewsBlur.git
synced 2025-08-20 05:14:26 +00:00
88 lines
4.6 KiB
Cheetah
88 lines
4.6 KiB
Cheetah
<$MTInclude module="doctype"$>
|
|
<head>
|
|
<title>About the Feed Validator</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
<$MTInclude module="css"$>
|
|
</head>
|
|
<body>
|
|
|
|
<div id="logo">
|
|
<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>
|
|
<p>About</p>
|
|
<a class="skip" href="#startnavigation">Jump to navigation</a>
|
|
</div> <!--logo-->
|
|
|
|
<div id="main">
|
|
|
|
<p>On this page:</p>
|
|
|
|
<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>
|
|
</ul>
|
|
|
|
<h2 id="what">What is this?</h2>
|
|
|
|
<p>This is a validator for syndicated feeds. It works with RSS 0.91, 0.92, 0.93, 0.94, 1.0, 1.1, 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>
|
|
|
|
<h2 id="why">Why a validator?</h2>
|
|
|
|
<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 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>
|
|
|
|
<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>
|
|
|
|
<h2 id="how">What does it validate?</h2>
|
|
|
|
<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>mod_admin</li>
|
|
<li>mod_syndication</li>
|
|
<li>mod_content (<code>content:encoded</code> only)</li>
|
|
</ul>
|
|
|
|
<p>For Atom feeds, it validates against the <a href="http://www.ietf.org/internet-drafts/draft-ietf-atompub-format-10.txt">Atom 1.0 internet draft</a>. While deprecated, the validator will also validate the pre-IETF <a href="http://www.mnot.net/drafts/draft-nottingham-atom-format-02.html">Atom 0.3</a> standard for a period of time.</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>
|
|
|
|
<h2 id="who">Who wrote it?</h2>
|
|
|
|
<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>
|
|
|
|
<a name="opensource" id="opensource"></a>
|
|
<h2 id="where">Can I run it locally?</h2>
|
|
|
|
<p>Yes. The validator is open source, written in Python, and distributed under the same <a href="../LICENSE">MIT license</a>. 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>
|
|
|
|
<blockquote><p><a href="/download/rssvalidator-latest.zip">Download the Feed Validator</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 700 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>
|
|
|
|
</div><!--main-->
|
|
|
|
<$MTInclude module="navigation"$>
|
|
<$MTInclude module="footer"$>
|
|
<$MTInclude module="poweredby"$>
|
|
</body>
|
|
</html>
|