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

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 20774 -->
<sect1 id="zend.feed.consuming-atom">
    <title>Atom フィードの使用</title>

    <para>
        <classname>Zend_Feed_Atom</classname> の使用法は <classname>Zend_Feed_Rss</classname>
        と似ていで、フィードのプロパティへのアクセス、
        フィード内のエントリの順次処理などができるようになります。大きな違いは
        Atom プロトコルの構造自体によるものです。Atom は <acronym>RSS</acronym> の後継として作成されたもので、
        より一般的なプロトコルです。
        フィード内に全コンテンツを含めるような形式をより簡単に扱うように設計されており、
        <acronym>RSS</acronym> の <code>description</code> タグに該当するものが
        <code>summary</code> と <code>content</code> の 2 つの要素に分割されています。
    </para>

    <example id="zend.feed.consuming-atom.example.usage">
        <title>Atom フィードの基本的な使用法</title>

        <para>
            Atom フィードを読み込み、各エントリの <code>title</code> と
            <code>summary</code> を表示します。
        </para>

        <programlisting language="php"><![CDATA[
$feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
echo 'このフィードには ' . $feed->count() . ' 件のエントリが含まれます。' . "\n\n";
foreach ($feed as $entry) {
    echo 'タイトル: ' . $entry->title() . "\n";
    echo '概要: ' . $entry->summary() . "\n\n";
}
]]></programlisting>
    </example>

    <para>
        Atom フィードでは、フィードのプロパティとして以下のようなものが使用できます。
    </para>

    <para>
        <itemizedlist>
            <listitem>
                <para>
                    <code>title</code> - フィードのタイトル。<acronym>RSS</acronym> チャネルの title と同じです
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>id</code> - Atom では、すべてのフィードやエントリが ID を持っています
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>link</code> - フィードには複数のリンクを含めることができ、
                    それらは <code>type</code> 属性によって識別されます
                </para>

                <para>
                    <code>type="text/html"</code> とすると、<acronym>RSS</acronym> チャネルの link
                    と同等になります。リンク先がこのフィードのコンテンツの別バージョンである場合は、
                    <code>rel="alternate"</code> 属性を使用します。
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>subtitle</code> - フィードの説明。
                    <acronym>RSS</acronym> チャネルの description と同じです
                </para>

                <para><code>author->name()</code> - フィードの著者の名前</para>
                <para><code>author->email()</code> - フィードの著者のメールアドレス</para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Atom エントリでよく使用されるプロパティは以下のようになります。
    </para>

    <para>
        <itemizedlist>
            <listitem>
                <para><code>id</code> - エントリの ID</para>
            </listitem>

            <listitem>
                <para>
                    <code>title</code> - エントリのタイトル。
                    <acronym>RSS</acronym> アイテムの title と同じです
                </para>
            </listitem>

            <listitem>
                <para><code>link</code> - このエントリの別フォーマットの文書へのリンク</para>
            </listitem>

            <listitem>
                <para><code>summary</code> - エントリの概要</para>
            </listitem>

            <listitem>
                <para>
                    <code>content</code> - エントリの完全なテキスト。
                    概要のみを提供するフィードの場合は省略可能です
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>author</code> - フィードと同様に <code>name</code> および <code>email</code>
                    を配下に保持します
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>published</code> - エントリの公開日 (<acronym>RFC</acronym> 3339 形式)
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>updated</code> - エントリの最終更新日 (<acronym>RFC</acronym> 3339 形式)
                </para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Atom についての詳細な情報やリソースについては
        <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>
        を参照ください。
    </para>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->