<?xml version="1.0" encoding="utf-8"?>
<webpage id="feedshelp">
  <config param="rcsdate" value="$Date: 2009-03-18 16:35:07 -0400 (Wed, 18 Mar 2009) $"/>

  <head>
    <title>Need Help with Feeds?</title>
    <summary>Howto and help with XML feeds</summary>
    <keywords>XML, Feeds, RSS, Atom</keywords>
  </head>

  <section id="whatisXMLFeed">
    <title>What is an XML Feed such as RSS or Atom?</title>
    <para>
      Web sites publish new content on a regular basis and provide a list of 
      news headline links to their latest content. Wouldn't it be better to 
      have the latest content and features delivered directly to you, rather 
      than clicking from site to site? Well now you can, thanks to XML Feeds 
      such as RSS and Atom.
    </para>
    
    <section id="whatisRSS">
      <title>RSS?</title>
      <para>
	<acronym>RSS</acronym> is a family of XML file formats for web 
	syndication used by news websites and weblogs. The acronym 
	stands for one of the following standards:
      </para>
      <itemizedlist xml:id="rssVersions">
	<listitem>
	  <para>Rich Site Summary (RSS 0.91)</para>
	</listitem>
	<listitem>
	  <para>RDF Site Summary (RSS 0.9, 1.0 and 1.1)</para>
	</listitem>
	<listitem>
	  <para>Really Simple Syndication (RSS 2.0)</para>
	</listitem>
      </itemizedlist>
      <para>
	RSS provides short descriptions of web content together with 
	links to the full versions of the content. This information is 
	delivered as an XML file called RSS feed, webfeed, RSS stream, 
	or RSS channel. In addition to facilitating syndication, RSS 
	allows a website's frequent readers to track updates on the site 
	using a news aggregator.
      </para>
    </section>
    
    <section id="whatisAtom">
      <title>Atom?</title>
      <para>
	Atom is a simple way to read and write information on the web, 
	allowing you to easily keep track of more sites in less time, 
	and to seamlessly share your words and ideas by publishing to the 
	web.
      </para>
    </section>
  </section>
  
  <section id="howto">
    <title>How do I use an XML feed such as RSS or Atom?</title>
    <para>
      <acronym>XML</acronym> news feeds can be read by a variety of desktop 
      newsreaders. Follow the following steps: 
      
      <orderedlist>
	<listitem>
	  <para>
	    Get a desktop newsreader that will read RSS or Atom feeds.
	  </para>
	</listitem>
	<listitem>
	  <para>
	    Look for the RSS or Atom logo, clicking on it will take you 
	    to the news feed for that particular page.
	  </para>
	</listitem>
	<listitem>
	  <para>
	    Then you can add the <acronym>URL</acronym> into your RSS or Atom 
	    newsreader.
	  </para>
	</listitem>
      </orderedlist>
    </para>
  </section>

  <sidebar id="resources">
    <title>Resources</title>
    <variablelist>
<!--
      <varlistentry>
        <term>RSS on Wikipedia</term>
        <listitem>
          <para>
            <ulink url="http://en.wikipedia.org/wiki/RSS_%28file_format%29">
              RSS File Format
            </ulink>
          </para>
        </listitem>
      </varlistentry>
-->
      <varlistentry>
        <term>RSS 1.0 Specification</term>
        <listitem>
          <para>
            <ulink url="http://web.resource.org/rss/1.0/">
	      RDF Site Summary (RSS) 1.0
	    </ulink>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Dev Center</term>
        <listitem>
          <para>
            <ulink url="http://www.oreillynet.com/rss/">
              O'Reilly RSS Dev Center
            </ulink>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>News Readers</term>
        <listitem>
          <para>
            <ulink url="http://dmoz.org/Reference/Libraries/Library_and_Information_Science/Technical_Services/Cataloguing/Metadata/RDF/Applications/RSS/News_Readers">RSS Newsreaders
            </ulink>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Atom Enabled</term>
        <listitem>
          <para>
            <ulink url="http://www.atomenabled.org">
	      Atom Website
	    </ulink>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sidebar>
</webpage>

