NewsBlur/vendor/feedvalidator/demo/docs/warning/DuplicateDescriptionSemantics.html

95 lines
4 KiB
HTML
Raw Normal View History

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title>Avoid foo:bar</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<link rel="icon" href="http://www.feedvalidator.org/favicon.ico" />
<link rel="shortcut icon" href="http://www.feedvalidator.org/favicon.ico" />
<style type="text/css" media="screen">@import "../../css/common.css";
@import "../../css/documentation.css";</style>
<script type="text/javascript"><!-- --></script>
<link rel="start" href="http://feedvalidator.org/docs/" title="Home" />
</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>Documentation</p>
<a class="skip" href="#startnavigation">Jump to navigation</a>
</div> <!--logo-->
<div id="main">
<h2>Message</h2>
<div class="docbody">
<p>Avoid <code>foo:bar</code></p>
</div>
<h2>Explanation</h2>
<div class="docbody">
<p>Avoid using elements in namespaces when there are already core elements
that do the same thing.</p>
<p>The item contains an element that duplicates the semantics of the
description element. Be advised that clients will behave unpredictably in the
presence of such an element: some will prefer it over the description element,
others will ignore it, and the behavior may depend on the order in which such
elements appear in the item.</p>
<p>Here are a few links to prior discussions on the topic:</p>
<ul>
<li>Dave Winer
<ul>
<li><a href="http://backend.userland.com/davesRss2PoliticalFaq#questionWhatDoesFunkyMeanInTheContextOfRss20">RSS 2.0 Political FAQ</a></li>
<li><a href="http://scripting.wordpress.com/2006/03/08/a-busy-developers-guide-to-rss-20/">A Busy Developer&#8217;s Guide to RSS 2.0</a></li>
</ul>
</li>
<li><a href="http://www.cadenhead.org/workbench/news/1598/improving-movable-types-rss-20-feed">Rogers Cadenhead</a></li>
<li><a href="http://groups.yahoo.com/group/rss-public/message/310">James Holderness</a></li>
<li><a href="http://www.2020hindsight.org/2006/03/09/learning-feeds/">Susan A. Kitchens</a></li>
<li><a href="http://blogs.opml.org/amyloo/2006/04/15#justRealizedSomethingAboutMyVerticalTopicFeedCouldUseSomeHelp">Amy Bellinger</a></li>
</ul>
</div>
<h2>Solution</h2>
<div class="docbody">
<ul>
<li>Select whether you want your feed to contains summaries (sometimes called excerpts) or full content (a.k.a. body).</li>
<li>Encode your selection as HTML.</li>
<li>Place the result in the item <code>description</code> element.</li>
<li>Remove other elements that provide the same function.</li>
</ul>
</div>
<h2>Not clear? Disagree?</h2>
<div class="docbody">
<p>Let us know on the <a href="http://lists.sourceforge.net/lists/listinfo/feedvalidator-users">feedvalidator-users</a> discussion list!</p>
</div>
</div><!--main-->
<div class="centered">
<a name="startnavigation" id="startnavigation"></a>
<div class="navbarWrapper">
<div class="navbarContent">
<img class="borderTL" src="../../images/borderTL.gif" alt="" width="14" height="14" />
<img class="borderTR" src="../../images/borderTR.gif" alt="" width="14" height="14" />
<p>
<a href="../../">Home</a> &middot;
<a href="../../about.html">About</a> &middot;
<a href="../../news/">News</a> &middot;
<a href="../../docs/">Docs</a> &middot;
<a href="../../terms.html">Terms</a>
</p>
<div class="roundedCornerSpacer">&nbsp;</div>
</div><!-- .content -->
<div class="bottomCorners">
<img class="borderBL" src="../../images/borderBL.gif" alt="" width="14" height="14" />
<img class="borderBR" src="../../images/borderBR.gif" alt="" width="14" height="14" />
</div><!-- .bottomCorners -->
</div><!-- .contentWrapper -->
</div><!-- .centered -->
<div class="centered">
<address>Copyright &copy; 2002-4 <a href="http://diveintomark.org/">Mark Pilgrim</a> and <a href="http://www.intertwingly.net/blog/">Sam Ruby</a></address>
</div>
</body>
</html>