закрыть Установить
Login Sign up

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

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

1. Описание элементов 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'].

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

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

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

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

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

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

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

<?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>
                    
Surf
Up

Add

You can create thematic collections and keep, for instance, all recipes in one place so you will never lose them.

No images found
Previous Next 0 / 0
500
  • Advertisement
  • Animals
  • Architecture
  • Art
  • Auto
  • Aviation
  • Books
  • Cartoons
  • Celebrities
  • Children
  • Culture
  • Design
  • Economics
  • Education
  • Entertainment
  • Fashion
  • Fitness
  • Food
  • Gadgets
  • Games
  • Health
  • History
  • Hobby
  • Humour
  • Interior
  • Moto
  • Movies
  • Music
  • Nature
  • News
  • Photo
  • Pictures
  • Politics
  • Psychology
  • Science
  • Society
  • Sport
  • Technology
  • Travel
  • Video
  • Weapons
  • Web
  • Work
    Submit
    Valid formats are JPG, PNG, GIF.
    Not more than 5 Мb, please.
    30
    surfingbird.ru/site/
    RSS format guidelines
    500
    • Advertisement
    • Animals
    • Architecture
    • Art
    • Auto
    • Aviation
    • Books
    • Cartoons
    • Celebrities
    • Children
    • Culture
    • Design
    • Economics
    • Education
    • Entertainment
    • Fashion
    • Fitness
    • Food
    • Gadgets
    • Games
    • Health
    • History
    • Hobby
    • Humour
    • Interior
    • Moto
    • Movies
    • Music
    • Nature
    • News
    • Photo
    • Pictures
    • Politics
    • Psychology
    • Science
    • Society
    • Sport
    • Technology
    • Travel
    • Video
    • Weapons
    • Web
    • Work

      Submit

      Thank you! Wait for moderation.

      Invite friends

      *Surfingbird does not store your mailbox password

        processing...

        Write to us

        • Ошибка
        • У меня гениальная идея!
        • Хочу сказать спасибо

        Or press Ctrl+Enter

        Like minded

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

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

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

          Close

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

            Тебе это не нравится?

            You can block the domain, tag, user or channel, and we'll stop recommend it to you. You can always unblock them in your settings.

            Get a link

            Спасибо, твоя жалоба принята.

            Log on to Surfingbird

            Recover
            Sign up

            or

            Welcome to Surfingbird.com!

            You'll find thousands of interesting pages, photos, and videos inside.
            Join!

            • Personal
              recommendations

            • Stash
              interesting and useful stuff

            • Anywhere,
              anytime

            Do we already know you? Login or restore the password.

            Close

            Add to collection