Jak na Atom 0.3 feed - konkrétní návod

Atom 0.3 feed do budoucna zcela jistě nahradí RSS. RSS, které máme dnes ve verzích 0.90, 0.91, 0.92, 0.93, 0.94, 0.95 draft, 1.0 a 2.0, 2.01, a snad i nějakých dalších verzích. RSS 0.9x řeší přidávání nových funkcí desetinkovým verzováním. To je šílenost. RSS 1.0 je vlastně RDF API. RSS 2.0 je pro změnu podobné návrhu RSS 0.93 a vyšší. Prostě zmatek.

Tento zmatek se snaží řešit a zlepšit Atom 0.3 feed. Ten, na rozdíl od RSS, umožňuje definovat vlastní namespaces, a podporuje nejenom API pro čtení, ale i zápis a měl by být skutečně zpětně kompatibilní (novější verze se staršími).

Jak připravit Atom 0.3 feed pro Váš web? Zde je návod.

Hlavička Atom 0.3 feedu:

<?xml version="1.0" encoding="iso-8859-2"?>
<?xml-stylesheet type="text/css" href="atom.css"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#">

Titulek feedu, link na web, a údaje o redakčním systému (je možno vynechat):

<title>název Vašeho webu</title>
<link rel="alternate" 
      type="text/html" 
      href="URL Vašeho webu" />
<generator url="http://hulan.cz/">BLOG:CMS</generator>

Informace o feedu (tuto sekci je možno použít pro její zobrazení čtenářům, kteří na link kliknout v browseru; nikoliv v Atom čtečce):

<info mode="xml" type="text/html">
<div xmlns="http://www.w3.org/1999/xhtml">
  This is an Atom formatted XML site feed. 
  It is intended to be viewed in a Newsreader 
  or syndicated to another site. 
</div>
</info>

Informace o tom, kdy byl tento feed naposledy modifikován:

<modified>2004-06-07T12:13:27Z</modified>    

Následují vlastní články. Článek má titulek <title>, odkaz na něj <link>, <name> jméno autora článku <author>, datum kdy byl modifikován <modified> a vytvořen <issued>, a samozřejmě vlastní obsah <content>. Obsah je zde vkládán jako aplikace typu xhtml+xml, nicméně je možné uvést například i /htmltype="text" a mode="escaped" a vložit escapovaný string, popřípadě včleněný do sekce <![CDATA[ … ]]>.

<entry>
 <title type="text/html" 
        mode="escaped">Vincent dodávka Gogh</title>
 <link rel="alternate" 
       type="text/html" 
        href="https://myego.cz/?itemid=123" />
 <author>
  <name>rADo</name>
 </author>
 <modified>2004-06-03T11:20:24Z</modified>
 <issued>2004-06-03T11:20:24+02:00</issued>
 <content type="application/xhtml+xml" 
          xml:base="https://myego.cz/" 
          xml:lang="cs-CZ" 
          xml:space="preserve">
 <div xmlns="http://www.w3.org/1999/xhtml">
 <p>O toto se nelze nepodělit, proháněl jsem jedním 
    nejmenovaným translátorem jeden dost obsáhlý 
    anglický text, abych si mírně usnadnil práci, 
    ale moc to nepomohlo. Je to nepoužitelné, nicméně 
    občas alespoň úsměvné.</p>
 <p>Co by jste říkali na přejmenování slavného holandského 
    malíře <a href='http://www.vangoghgallery.com/'>
    Vincenta van Gogha</a> na Vincenta dodávku 
    Gogha?</p>
 <hr />
 <p>Znáte jazykové přeladače, které si s tím poradí 
    lépe? Které jsou použitelné?</p>
 </div>
 </content>
 <id>https://myego.cz/:1:382</id>
 </entry>

Patička celého feedu je potom následující:

</feed>

Příklad šablony Atom 0.3 feedu pro Nucleus XE:

<entry>
 <title type="text/html" mode="escaped">
   <![CDATA[<%title%>]]>
 </title>
 <link rel="alternate" 
       type="text/html" 
       href="<%FancierURL%>" />
 <author>
 <name><%author%></name>
 </author>
 <modified><%date(utc)%></modified>
 <issued><%date(iso8601)%></issued>
 <content type="application/xhtml+xml" 
          xml:base="https://myego.cz/" 
          xml:lang="cs-CZ" 
          xml:space="preserve">
 <div xmlns="http://www.w3.org/1999/xhtml">
 <%body%>
 <%more%>
 </div>
 </content>
 <id><%blogurl%>:<%blogid%>:<%itemid%></id>
 </entry>

Příklad Atom 0.3 feedu: atom.php.