documentation/manual/zh/module_specs/Zend_Feed-ConsumingAtom.xml

   1 <sect1 id="zend.feed.consuming-atom">
   2 <title>Atom Feed的使用</title>
   3
   4     <para>
   5         <code>Zend_Feed_Atom</code>在使用上有许多方法与<code>Zend_Feed_Rss</code>是大相径庭的。它提供了相同的方法访问Feed中的属性和遍历所有Feed中的所有条目。不同之处在于Atom协议结构自身。Atom作为RSS的继承者，它是一个更广泛的协议，在处理Feed中提供的所有内容方面它被设计的更加容易，RSS中的<code>description</code>标记在Atom中被分割成两个元素<code>summary</code> 和
   6          <code>content</code>就是为了这个目的。
   7     </para>
   8
   9     <example id="zend.feed.consuming-atom.example.usage">
  10         <title>Atom Feed的基本用法</title>
  11         <para>
  12             读取一个Atom Feed并打印出每个条目的<code>title</code> 和 <code>summary</code>：
  13         </para>
  14         <programlisting role="php"><![CDATA[<?php
  15
  16 $feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
  17 echo 'The feed contains ' . $feed->count() . ' entries.' . "\n\n";
  18 foreach ($feed as $entry) {
  19     echo '标题: ' . $entry->title() . "\n";
  20     echo '摘要: ' . $entry->summary() . "\n\n";
  21 }]]></programlisting>
  22     </example>
  23
  24     <para>
  25         在Atom Feed中你能找到以下Feed属性：
  26     </para>
  27
  28     <para>
  29         <itemizedlist>
  30             <listitem>
  31                 <para><code>title</code> - Feed的标题, 和RSS中的channel标题一样</para>
  32             </listitem>
  33             <listitem>
  34                 <para><code>id</code> - 在Atom中的每个Feed和条目都有一个唯一的标识符(id)</para>
  35             </listitem>
  36             <listitem>
  37                 <para><code>link</code> - Feed可以有多个链接，它们之间用<code>type</code>属性区别</para>
  38                 <para>
  39                     当<code>type="text/html"</code>时与RSS的channel中的link是一样的。如果这个链接是一个在Feed中相同内容的候选版本，那么它将有一个<code>rel="alternate"</code>属性。
  40                 </para>
  41             </listitem>
  42             <listitem>
  43                 <para><code>subtitle</code> - Feed的描述，等同于RSS中的频道描述
  44                 </para>
  45                 <para><code>author->name()</code> - Feed作者名</para>
  46                 <para><code>author->email()</code> - Feed作者的email地址</para>
  47             </listitem>
  48         </itemizedlist>
  49     </para>
  50
  51     <para>
  52         Atom 条目通常具有以下属性：
  53     </para>
  54
  55     <para>
  56         <itemizedlist>
  57             <listitem>
  58                 <para><code>id</code> - 条目唯一标识符</para>
  59             </listitem>
  60             <listitem>
  61                 <para><code>title</code> - 条目标题，和RSS的item标题相同</para>
  62             </listitem>
  63             <listitem>
  64                 <para><code>link</code> - 一个到另外一种格式的链接或者当前条目的一个候选观点</para>
  65             </listitem>
  66             <listitem>
  67                 <para><code>summary</code> - 条目内容摘要</para>
  68             </listitem>
  69             <listitem>
  70                 <para><code>content</code> - 条目的全部内容；如果feed就包含摘要可以被挑过</para>
  71             </listitem>
  72             <listitem>
  73                 <para><code>author</code> - 有 <code>name</code> 和 <code>email</code> 子标记就像feed的author一样</para>
  74             </listitem>
  75             <listitem>
  76                 <para><code>published</code> - 条目的发布日期(RFC 3339格式)</para>
  77             </listitem>
  78             <listitem>
  79                 <para><code>updated</code> - 条目的最后更新日期(RFC 3339格式)</para>
  80             </listitem>
  81         </itemizedlist>
  82     </para>
  83
  84     <para>
  85         更多关于Atom的信息和丰富的资源，请参看<ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>.
  86     </para>
  87 </sect1>
  88 <!--
  89 vim:se ts=4 sw=4 et:
  90 -->