[MANUAL] English:
[zend.git] / documentation / manual / ru / module_specs / Zend_Feed-ConsumingAtom.xml
blob4f56b096990027f754aeafea6a36e7324509fcb9
1 <sect1 id="zend.feed.consuming-atom">
2 <title>Работа с лентой Atom</title>
4     <para>
5         <code>Zend_Feed_Atom</code> используется в основном так же, как и
6         <code>Zend_Feed_Rss</code>. Он предоставляет те же доступ к свойствам
7         ленты и обход сообщений в ленте.  Основное отличие заключается в самой
8         структуре ленты по протоколу Atom. Atom является преемником RSS, это более
9         обобщенный протокол. Он разработан для более легкой работы с лентами, и
10         предоставяет полное информационное содержимое внутри самой ленты, разделив
11         для этой цели тег <code>&lt;description&gt;</code> в RSS на два элемента —
12         <code>&lt;summary&gt;</code> (анонс) и <code>&lt;content&gt;</code> (содержимое).
13     </para>
15     <example id="zend.feed.consuming-atom.example.usage">
16         <title>Основы использования ленты Atom</title>
17         <para>
18             Чтение ленты Atom, вывод <code>title</code> и <code>summary</code>
19             для каждого сообщения:
20         </para>
21         <programlisting language="php"><![CDATA[
22 $feed = new Zend_Feed_Atom('http://atom.example.com/feed/');
23 echo 'The feed contains ' . $feed->count() . ' entries.' . "\n\n";
24 foreach ($feed as $entry) {
25     echo 'Title: ' . $entry->title() . "\n";
26     echo 'Summary: ' . $entry->summary() . "\n\n";
27 }]]>
28         </programlisting>
29     </example>
31     <para>
32         В ленте Atom (элемент <code>&lt;feed&gt;</code>) должны
33         присутствовать следующие свойства:
34     </para>
36     <para>
37         <itemizedlist>
38             <listitem>
39                 <para>
40                     <code>title</code> — заголовок ленты, аналогичен заголовку RSS-канала
41                 </para>
42             </listitem>
43             <listitem>
44                 <para>
45                     <code>id</code> — каждая лента и каждое сообщение в Atom имеют свои
46                     уникальные идентификаторы
47                 </para>
48             </listitem>
49             <listitem>
50                 <para>
51                     <code>link</code> — лента может иметь одну или несколько ссылок, которые
52                     имеют атрибут <code>type</code>
53                 </para>
54                 <para>
55                     Эквивалентом ссылке в RSS-канале будет <code>type="text/html"</code>. Если
56                     ссылка ведет на альтернативную версию того же контента, что представлен
57                     в ленте, она должна иметь атрибут <code>rel="alternate"</code>.
58                 </para>
59             </listitem>
60             <listitem>
61                 <para>
62                     <code>subtitle</code> — описание ленты, эквивалентен описанию RSS-канала
63                 </para>
64                 <para>
65                     <code>author->name()</code> — имя автора ленты
66                 </para>
67                 <para>
68                     <code>author->email()</code> — e-mail автора ленты
69                 </para>
70             </listitem>
71         </itemizedlist>
72     </para>
74     <para>
75         Сообщения Atom (элемент <code>&lt;entry&gt;</code>) обычно имеют
76         следующие свойства:
77     </para>
79     <para>
80         <itemizedlist>
81             <listitem>
82                 <para>
83                     <code>id</code> — уникальный идентификатор сообщения
84                 </para>
85             </listitem>
86             <listitem>
87                 <para>
88                     <code>title</code> — заголовок сообщение
89                 </para>
90             </listitem>
91             <listitem>
92                 <para>
93                     <code>link</code> — ссылка на альтернативное представление
94                     сообщения в другом формате
95                 </para>
96             </listitem>
97             <listitem>
98                 <para>
99                     <code>summary</code> — аннотация к содержимому сообщения
100                 </para>
101             </listitem>
102             <listitem>
103                 <para>
104                     <code>content</code> — полное содержимое сообщения,
105                     может быть пропущен, если лента содержит только аннотации
106                 </para>
107             </listitem>
108             <listitem>
109                 <para>
110                     <code>author</code> — с субтегами <code>name</code> и <code>email</code>,
111                     как у элемента <code>feed</code>
112                 </para>
113             </listitem>
114             <listitem>
115                 <para>
116                     <code>published</code> — дата публикации в формате RFC 3339
117                 </para>
118             </listitem>
119             <listitem>
120                 <para>
121                     <code>updated</code> — дата последнего изменения сообщения
122                     в формате RFC 3339
123                 </para>
124             </listitem>
125         </itemizedlist>
126     </para>
128     <para>
129         Другие ресурсы и дополнительную информацию по Atom ищите на сайте:
130         <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>.
131     </para>
132 </sect1>
133 <!--
134 vim:se ts=4 sw=4 et: