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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20774 -->
   4 <sect1 id="zend.feed.consuming-atom">
   5     <title>Atom フィードの使用</title>
   6
   7     <para>
   8         <classname>Zend_Feed_Atom</classname> の使用法は <classname>Zend_Feed_Rss</classname>
   9         と似ていで、フィードのプロパティへのアクセス、
  10         フィード内のエントリの順次処理などができるようになります。大きな違いは
  11         Atom プロトコルの構造自体によるものです。Atom は <acronym>RSS</acronym> の後継として作成されたもので、
  12         より一般的なプロトコルです。
  13         フィード内に全コンテンツを含めるような形式をより簡単に扱うように設計されており、
  14         <acronym>RSS</acronym> の <code>description</code> タグに該当するものが
  15         <code>summary</code> と <code>content</code> の 2 つの要素に分割されています。
  16     </para>
  17
  18     <example id="zend.feed.consuming-atom.example.usage">
  19         <title>Atom フィードの基本的な使用法</title>
  20
  21         <para>
  22             Atom フィードを読み込み、各エントリの <code>title</code> と
  23             <code>summary</code> を表示します。
  24         </para>
  25
  26         <programlisting language="php"><![CDATA[
  27 $feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
  28 echo 'このフィードには ' . $feed->count() . ' 件のエントリが含まれます。' . "\n\n";
  29 foreach ($feed as $entry) {
  30     echo 'タイトル: ' . $entry->title() . "\n";
  31     echo '概要: ' . $entry->summary() . "\n\n";
  32 }
  33 ]]></programlisting>
  34     </example>
  35
  36     <para>
  37         Atom フィードでは、フィードのプロパティとして以下のようなものが使用できます。
  38     </para>
  39
  40     <para>
  41         <itemizedlist>
  42             <listitem>
  43                 <para>
  44                     <code>title</code> - フィードのタイトル。<acronym>RSS</acronym> チャネルの title と同じです
  45                 </para>
  46             </listitem>
  47
  48             <listitem>
  49                 <para>
  50                     <code>id</code> - Atom では、すべてのフィードやエントリが ID を持っています
  51                 </para>
  52             </listitem>
  53
  54             <listitem>
  55                 <para>
  56                     <code>link</code> - フィードには複数のリンクを含めることができ、
  57                     それらは <code>type</code> 属性によって識別されます
  58                 </para>
  59
  60                 <para>
  61                     <code>type="text/html"</code> とすると、<acronym>RSS</acronym> チャネルの link
  62                     と同等になります。リンク先がこのフィードのコンテンツの別バージョンである場合は、
  63                     <code>rel="alternate"</code> 属性を使用します。
  64                 </para>
  65             </listitem>
  66
  67             <listitem>
  68                 <para>
  69                     <code>subtitle</code> - フィードの説明。
  70                     <acronym>RSS</acronym> チャネルの description と同じです
  71                 </para>
  72
  73                 <para><code>author->name()</code> - フィードの著者の名前</para>
  74                 <para><code>author->email()</code> - フィードの著者のメールアドレス</para>
  75             </listitem>
  76         </itemizedlist>
  77     </para>
  78
  79     <para>
  80         Atom エントリでよく使用されるプロパティは以下のようになります。
  81     </para>
  82
  83     <para>
  84         <itemizedlist>
  85             <listitem>
  86                 <para><code>id</code> - エントリの ID</para>
  87             </listitem>
  88
  89             <listitem>
  90                 <para>
  91                     <code>title</code> - エントリのタイトル。
  92                     <acronym>RSS</acronym> アイテムの title と同じです
  93                 </para>
  94             </listitem>
  95
  96             <listitem>
  97                 <para><code>link</code> - このエントリの別フォーマットの文書へのリンク</para>
  98             </listitem>
  99
 100             <listitem>
 101                 <para><code>summary</code> - エントリの概要</para>
 102             </listitem>
 103
 104             <listitem>
 105                 <para>
 106                     <code>content</code> - エントリの完全なテキスト。
 107                     概要のみを提供するフィードの場合は省略可能です
 108                 </para>
 109             </listitem>
 110
 111             <listitem>
 112                 <para>
 113                     <code>author</code> - フィードと同様に <code>name</code> および <code>email</code>
 114                     を配下に保持します
 115                 </para>
 116             </listitem>
 117
 118             <listitem>
 119                 <para>
 120                     <code>published</code> - エントリの公開日 (<acronym>RFC</acronym> 3339 形式)
 121                 </para>
 122             </listitem>
 123
 124             <listitem>
 125                 <para>
 126                     <code>updated</code> - エントリの最終更新日 (<acronym>RFC</acronym> 3339 形式)
 127                 </para>
 128             </listitem>
 129         </itemizedlist>
 130     </para>
 131
 132     <para>
 133         Atom についての詳細な情報やリソースについては
 134         <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>
 135         を参照ください。
 136     </para>
 137 </sect1>
 138 <!--
 139 vim:se ts=4 sw=4 et:
 140 -->