Skip to content

Commit a38f359

Browse files
author
Joseph Walton
committed
Bulk import of current documentation in a templatable XML format.
git-svn-id: http://feedvalidator.googlecode.com/svn/trunk@378 34a10a33-d82d-0410-ba40-81c901463ecc
1 parent eb2cfb3 commit a38f359

File tree

149 files changed

+2615
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

149 files changed

+2615
-0
lines changed

‎docs-xml/error/AtomLinkNotEmpty.xml‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p><code>foo</code> should not have text (all data is in attributes)</p>
5+
</div>
6+
<div id='explanation'>
7+
<p>You have an old-style <code>link</code> in your Atom feed.</p>
8+
</div>
9+
<div id='solution'>
10+
<p>In Atom 0.3, the format of <code>link</code> changed. Instead of simply containing an address of a page or resource, it now contains three attributes that describe the type of link, and the MIME type of the linked resource, and the address of the resource.</p>
11+
12+
<p>This was the format in Atom 0.2:</p>
13+
14+
<blockquote><code>&lt;link&gt;http://www.example.com/&lt;/link&gt;</code></blockquote>
15+
16+
<p>This is the new format in Atom 1.0 and later:</p>
17+
18+
<blockquote><code>&lt;link href="http://www.example.com/"/&gt;</code></blockquote>
19+
20+
<p>Note: this information only applies to Atom feeds (not RSS feeds).</p>
21+
</div>
22+
</div>
23+
</fvdoc>

‎docs-xml/error/BadXmlVersion.xml‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
<!DOCTYPE fvdoc [
2+
<!ENTITY nbsp "&#160;">
3+
]>
4+
<fvdoc>
5+
<div xmlns='http://www.w3.org/1999/xhtml'>
6+
<div id='message'>
7+
<p>Feeds must specify XML Version 1.0</p>
8+
</div>
9+
<div id='explanation'>
10+
<p>All <a href="http://feeds.archive.org/validator/docs/rss2.html#whatIsRss">RSS</a> files must conform to the <a href="http://www.w3.org/TR/2004/REC-xml-20040204/">XML 1.0</a> specification</p>
11+
</div>
12+
<div id='solution'>
13+
<p>Replace the version string in the XML declaration with "1.0".&nbsp; The result should look something like this:</p>
14+
<blockquote><p><code>&lt;?xml version="1.0" encoding="iso-8859-1"?&gt;</code></p></blockquote>
15+
</div>
16+
</div>
17+
</fvdoc>

‎docs-xml/error/ContainsSystemEntity.xml‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p>Feeds must not contain SYSTEM entities</p>
5+
</div>
6+
<div id='explanation'>
7+
<p>Your feed contains a <code>SYSTEM</code> entity. This is a security risk.</p>
8+
</div>
9+
<div id='solution'>
10+
<p>Remove the <code>SYSTEM</code> entity. RSS feeds must be self-contained.</p>
11+
</div>
12+
</div>
13+
</fvdoc>

‎docs-xml/error/DuplicateAtomLink.xml‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p>Duplicates alternate links with the same type and hreflang</p>
5+
</div>
6+
<div id='explanation'>
7+
<p>atom:feed elements MUST NOT contain more than one atom:link
8+
element with a rel attribute value of "alternate" that has the
9+
same combination of type and hreflang attribute values.</p>
10+
</div>
11+
<div id='solution'>
12+
<p>Remove one of the links.</p>
13+
</div>
14+
</div>
15+
</fvdoc>

‎docs-xml/error/DuplicateElement.xml‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p><code>foo</code> contains more than one <code>bar</code></p>
5+
</div>
6+
<div id='explanation'>
7+
<p>Only one occurrence of the specified element is allowed in this context. For example, <code>channel</code> can only contain one <code>title</code> element.</p>
8+
</div>
9+
<div id='solution'>
10+
<p>Delete the redundant element.</p>
11+
</div>
12+
</div>
13+
</fvdoc>

‎docs-xml/error/EightDaysAWeek.xml‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p>skipDays can not contain more than 7 day elements</p>
5+
</div>
6+
<div id='explanation'>
7+
<p><a href="http://backend.userland.com/skipHoursDays#skipdays"><code>skipDays</code></a> can not contain more than 7 <code>day</code> elements.</p>
8+
</div>
9+
<div id='solution'>
10+
<p>Remove the duplicate <code>days</code> elements.</p>
11+
</div>
12+
</div>
13+
</fvdoc>

‎docs-xml/error/HttpError.xml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p>HTTP Error</p>
5+
</div>
6+
<div id='explanation'>
7+
<p>Your feed couldn't be validated because there was a problem downloading
8+
it from the web server. You should try to diagnose this using a web browser,
9+
and make sure that the URL you supplied resolves to an accessible file.</p>
10+
<p>This usually means that the URL was wrong, or that permissions on
11+
the server don't allow us to fetch that file. The error shows the
12+
message that the server sent, which may help.</p>
13+
</div>
14+
<div id='solution'>
15+
<p>Make sure this URL can be downloaded with a browser, then try again.</p>
16+
</div>
17+
</div>
18+
</fvdoc>

‎docs-xml/error/HttpProtocolError.xml‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
<!DOCTYPE fvdoc [
2+
<!ENTITY ldquo "&#8220;">
3+
<!ENTITY rdquo "&#8221;">
4+
<!ENTITY rsquo "&#8217;">
5+
]>
6+
<fvdoc>
7+
<div xmlns='http://www.w3.org/1999/xhtml'>
8+
<div id='message'>
9+
<p>HTTP Protocol Error</p>
10+
</div>
11+
<div id='explanation'>
12+
<p>The HTTP response from the server was invalid. This will prevent some
13+
aggregators from downloading the feed at all.</p>
14+
</div>
15+
<div id='solution'>
16+
<p>One common cause for this is WordPress&rsquo;s &ldquo;Last Modified&rdquo; header
17+
(with a space, rather than a dash, separating the words).
18+
See
19+
<a href="http://wordpress.org/support/3/13097#post-87665" title="RSS Feed Problems &#xab; WordPress Support">WordPress support</a>,
20+
or upgrade to
21+
<a href="http://wordpress.org/development/2004/12/one-point-two-two/" title="WordPress Development Blog">a version that includes the fix</a>.</p>
22+
</div>
23+
</div>
24+
</fvdoc>

‎docs-xml/error/IOError.xml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p>IO Error</p>
5+
</div>
6+
<div id='explanation'>
7+
<p>Your feed couldn't be validated because there was a problem downloading
8+
it from the web server. You should try to diagnose this using a web browser,
9+
and make sure that the URL you supplied resolves to an accessible file.</p>
10+
<p>One specific case that causes this is a server that claims the file
11+
is compressed, but then serves an uncompressed file. You may need to contact
12+
your host's administrators to resolve this problem.</p>
13+
</div>
14+
<div id='solution'>
15+
<p>Make sure this URL can be downloaded with a browser, then try again.</p>
16+
</div>
17+
</div>
18+
</fvdoc>

‎docs-xml/error/InvalidAddrSpec.xml‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
<fvdoc>
2+
<div xmlns='http://www.w3.org/1999/xhtml'>
3+
<div id='message'>
4+
<p><code>foo</code> must be an email address</p>
5+
</div>
6+
<div id='explanation'>
7+
<p>MUST conform to the "addr-spec" production in <a href="http://www.faqs.org/rfcs/rfc2822.html">RFC 2822</a></p>
8+
</div>
9+
<div id='solution'>
10+
<p>Convert the email address to a valid form. Examples of valid email
11+
addresses:</p>
12+
<ul>
13+
<li>joesmith@example.com</li>
14+
<li>joesmith+nospamplease@nospam.example.com</li>
15+
</ul>
16+
<p>Note: addr-spec does not include a provision for a display-name. Use
17+
atom:name instead. Examples of invalid email addresses:</p>
18+
<ul>
19+
<li>joesmith@example.com (Joe Smith)</li>
20+
<li>Joe Smith &amp;lt;joesmith@example.com&amp;gt;</li>
21+
</ul>
22+
</div>
23+
</div>
24+
</fvdoc>

0 commit comments

Comments
 (0)