Surfingbird / RSS

Экспорт Данных для размещения в Surfingbird.ru осуществляется в XML-based (http://www.w3.org/TR/REC-xml) формате RSS 2.0 (http://blogs.law.harvard.edu/tech/rss). Ниже содержится описание используемых для экспорта Данных элементов RSS 2.0, необходимые комментарии и пример экспортного файла.

Корневым элементом RSS-файла является <rss>, атрибут version которого должен иметь значение 2.0: <rss xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">

Внутри элемента <rss> содержится элемент <channel>, который включает информацию об источнике и его содержание. Элементами <channel> считаются следующие элементы:

<title> - название RSS-потока.В случае, если экспортируется содержание целого сайта, то здесь должно быть его название, например: <title>Российские новости</title>; если же часть сайта, то в названии должно быть отражено, какая именно часть, например: <title>Российские новости: технологии</title>. На Surfingbird.ru название RSS-потока не показывается.

<link> - URL сайта, данные которого транслируются в потоке. Пример: <link>http://www.rossiyskie-novosti.ru</link>

<description> - описание потока. Одно предложение. Пример: <description> Ежедневная московская общественно-политическая газета.</description>

<item> - Обязательный элемент! Каждый <item> описывает только одну(!) страницу и должен содержать необходимый элемент <title> - заголовок страницы. В <channel> может содержаться любое количество элементов <item>.

<title> - заголовок страницы. Обязательный элемент! Пример: <title>Surfingbird не будет делиться трафиком</title> Внимание: Написание заголовка <title> целиком ПРОПИСНЫМИ буквами не допускается. Не допускается также наличие точки в конце заголовка. В заголовке не должны содержаться название источника и дата/время страницы, а также служебные примечания ("обновлено", "дополнено", "фоторепортаж", "видео" и др.) и неинформативные обороты, не представляющие собой неотъемлемой части заголовка ("Срочно!", "Сенсация:" и т.п.).

<link> - URL страницы. Обязательный элемент! Пример: <link>http://www.siliconrus.com/20 13/12/surfingbird/</link> Внимание: на открывающейся по указанному адресу страницу заголовок и начало текста должны быть доступны в первом экране при разрешении 1024х768. При переходе с заголовка, размещенного на Surfingbird.ru, должна открываться только одна страница, содержащая содержимое, соответствующее заголовку.

<pubDate> - время публикации страницы на сайте источника. Обязательный элемент! (в формате RFC-822 - см. http://asg.web.cmu.edu/rfc/rfc822.html#sec-5) Регистр в названии <pubDate> имеет значение - буква D должна быть прописной.Пример: <pubDate>Tue, 12 Aug 20 11 14:15:00 +0400 </pubDate> Эта запись означает, что новость датирована 12 августа 20 11, 14:15 московского времени. Внимание: +0 40 0 является указанием на часовой пояс (в приведенном примере это московское время). Указанное в экспортном файле время должно обязательно совпадать с фактическим временем публикации на сайте!

<description> - аннотация страницы. Пример: <description>Внимательные читатели заметили, что популярный российский сервис контентных рекомендаций Surfingbird изменил формат отображения постов. Теперь оригинальный контент пропускается через парсер-аналог Readability и показывается пользователю в удобном для него виде.</description>

<content:encoded> - для экспорта полного текста статьи. Обязательный элемент! В этом элементе должен размещаться HTML-код статьи. Служебные символы &<>'" должны быть экранированы или весь HTML должен быть помещен в раздел CDATA <![CDATA[ ... ]]>. HTML не должен содержать элементов <html>, <head>, <body>, <meta>. Элементы <script> и <style> будут удалены из HTML на этапе Экспорта Данных. Так же будут удалены все незначащие атрибуты и стили у элементов. Разрешены только следующие стили:
'font-style' : ['normal','italic','oblique'],
'font-weight' : ['normal','bold'],
'text-align' : ['left','right','center','justify'],
'text-decoration' : ['underline','overline','line-through'],
'text-transform' : ['capitalize','capitalize','lowercase','none'].

По умолчанию (если это не указано явно в заголовке) кодировкой файла считается utf-8. В противном случае выставление кодировки xml файла обязательно. Наиболее часто употребляемые кодировки: windows-1251, utf-8.

Внимание: фактическая кодировка, отдаваемая веб-сервером, ВСЕГДА должна совпадать с кодировкой, указанной в заголовке XML!

Встречающиеся в тексте символы < > & ' " необходимо заменять на соответствующие элементы:
& на &amp
< на <
> на >
' на '
" на "
(здесь точка с запятой - это не разделитель данного списка, а обязательная часть элемента!)
Замены должны производиться во всех элементах <item> и <channel> - в <description>, <link>, <title> и др. Пример, ссылка "http://some.host.ru/?id=1&page=10" приводится к виду "http://some.host.ru/?id=1&page=10"

Для экспорта Данных необходимо положить RSS-файл на сервер издания и обновлять его с определенной периодичностью (например, файл может пополняться в течение дня и перезаписываться утром). Файл должен быть доступен по http, его индексирование (скачивание) происходит каждый час. Экспортный файл, который не удалось полностью загрузить за 15 секунд, считается недоступным.

<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
<channel>
<title>Keddr.com</title>
<link>http://keddr.com</link>
<description>Креативно про IT</description>
<item>
<title>GoogleGlass + iPhone = реальность</title>
<link>http://keddr.com/2013/12/googleglass-iphone-realnost/</link>
<pubDate>Wed, 18 Dec 2013 12:13:17 +0000</pubDate>
<guid isPermaLink="false">http://keddr.com/?p=92877</guid>
<description><![CDATA[Компания Google продолжает давать нам информационные поводы для новостей. На этот раз в AppStore было […]]]></description>
<content:encoded><![CDATA[<p style="text-align: justify;">Компания Google продолжает давать нам информационные поводы для новостей. На этот раз в AppStore было временно замечено приложение MyGlass, которое позволит использовать умные очки Google Glass с вашим iPhone.</p>
<p style="text-align: justify;"></p>
<p style="text-align: justify;">В отличие от Apple, Google — в первую очередь софтверная компания, поэтому ограничивать свои сервисы исключительно экосистемой вокруг Android она не собирается. К нативным приложениям для гуглосервисов под iOS совсем скоро добавится еще одно: MyGlass для управления Google Glass.</p>
<p style="text-align: justify;"><img alt="glass560" src="http://keddr.com/wp-content/uploads/2013/12/glass560.jpg" width="560" height="359" /></p>
<p style="text-align: justify;">Версия для яблочных девайсов будет уметь почти все, что и собрат на андроиде. Будут доступны следующие функции: управление Play Music, блокировка экрана, общение через Hangouts, шаринг видео в YouTube, фотографирование подмигиванием и, конечно, поиск.</p><p style="text-align: justify;">Теперь мы знаем, что для покупки Google Glass, когда они, наконец, поступят в продажу, не обязательно будет иметь андроид- устройство. Достаточно будет и iPhone. А что вы думаете о связке яблочного девайса с умными очками от гугла?</p>
<p style="text-align: justify;">Источник: <a href="https://support.google.com/glass/answer/4353446?hl=en&ref_topic=3284652" target="_blank">Google</a></p>
]]></content:encoded>
</item>
</channel>
</rss>

Технические требования

1. Описание элементов RSS 2.0, используемых для экспорта Данных

2. Символы и кодировки

3. Механизм экспорта Данных

4. Пример экспортного файла (Обязательные элементы выделены)

Технические требования

1. Описание элементов RSS 2.0, используемых для экспорта Данных

2. Символы и кодировки

3. Механизм экспорта Данных

4. Пример экспортного файла (Обязательные элементы выделены)

Invite friends

Write to us

Like minded

Скачай наше приложение для iPad

Скачай наше приложение для iPhone

Скачай наше приложение для Android

Подпишись на каналы