Правила оформления новостного потока (устарели 22.08.2023)

Эти правила устарели.

Перейти на актуальные правила оформления новостного потока.

Для импорта в новостную систему Рамблер/новости источнику новостей необходимо обзавестись собственным новостным потоком – в терминологии системы – фидом. Наиболее универсальным для импорта является формат RSS (http://ru.wikipedia.org/wiki/RSS – его понимают роботы всех перечисленных проектов), для Рамблер/новостей также подходят RDF (http://ru.wikipedia.org/wiki/RDF) и ATOM.

Общие требования

  1. Фид должен начинаться с объявления формата XML с обязательным и точным указанием кодировки содержимого:<?xml version="1.0" encoding="utf-8"?>
  2. В ответе в заголовках сервера для параметра "Content-Type" должно быть указано значение "application/rss+xml; charset=utf-8".
  3. Фид должен быть валидным XML, то есть как минимум открываться в Internet Explorer и Mozilla FireFox без ошибок
  4. Каждая новость на сайте источника должна иметь уникальный адрес, переход на статью или новость по ссылке с RSS, RDF или Atom для каждого элемента фида должен показывать одну и именно ту статью или новость в обвязке сайта, на которую указывает ссылка.
  5. Все теги, которые могут встретиться в теле элементов фида, должны быть либо «заэскейплены» (&lt;p&gt; вместо <p> и &lt;/p&gt; вместо </p>), либо обернуты в конструкцию <![CDATA[Текст <pre>статьи</pre> или <p>заголовка</p> c HTML-кодами]]>

Пример оформления RSS

<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:rambler="http://news.rambler.ru" version="2.0">
<channel>
<title>Название вашего сайта</title>
<link>http://www.site.ru/</link>
<description>Краткое описание вашего сайта</description>
<!-- Обычный элемент -->
<item><guid isPermaLink="false">2334456</guid>
<title>Заголовок новости</title>
<link>http://www.site.ru/news/2334456/</link>
<pubDate>Mon, 09 Feb 2009 03:03:21 +0400</pubDate>
<description>Краткое описание новости</description>
<category>Категория</category>
<rambler:fulltext><![CDATA[Полный текст новости.]]></rambler:fulltext>
<author>Автор новости</author>
<enclosure url="http://images.site.ru/12341234.1234234.jpg" type="image/jpeg" length="123" />
</item>
<!-- Мультимедийный элемент -->
<item><guid isPermaLink="false">23344567</guid>
<title>Заголовок новости</title>
<link>http://www.site.ru/news/23344567/</link>
<pubDate>Mon, 09 Feb 2009 03:03:21 +0400</pubDate>
<description>Краткое описание новости</description>
<category>Категория</category>
<rambler:fulltext><![CDATA[Полный текст новости.]]></rambler:fulltext>
<author>Автор новости</author>
<enclosure url="http://images.site.ru/video.frame.mandatory.jpg" type="image/jpeg" length="123" />
<enclosure url="http://images.site.ru/link.to.video.stream.flv" type="video/x-flv" length="123" />
<enclosure url="http://images.site.ru/link.to.audio.stream.mp3" type="audio/mpeg" length="123" />
</item>
</channel>
</rss>

Теперь рассмотрим подробнее. Обязательными тегами для любого RSS-элемента (<item>...</item>) являются:

  • title - заголовок новости;
  • link - ссылка на новость на сайте;
  • pubDate - дата публикации в формате [Mon, 09 Feb 2009 03:03:21 +0400] с правильным смещением от GMT;
  • description - аннотация новости.

Пример оформления Atom

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:rambler="http://news.rambler.ru">
<title>Название вашего сайта</title>
<subtitle>Insert witty or insightful remark here</subtitle>
<link href="http://example.org/"/>
<updated>2003-12-13T18:30:02Z</updated>
<!-- Обычный элемент -->
<entry>
<title>Заголовок новости</title>
<link href="http://example.org/2003/12/13/atom03/" type="text/html"/>
<id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
<updated>2003-12-13T18:30:02Z</updated>
<published>2003-12-13T18:30:02Z</published>
<summary>Краткое описание новости</summary>
<content>Текст статьи</content>
<author>
<name>John Doe</name>
<email>johndoe@example.com</email>
</author>
</entry>
<!-- Мультимедийный элемент -->
<entry>
<title>Заголовок новости</title>
<link rel="alternate" href="http://example.org/2003/12/13/atom03/" type="text/html"/>
<id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
<updated>2003-12-13T18:30:02Z</updated>
<published>2003-12-13T18:30:02Z</published>
<summary>Краткое описание новости</summary>
<content>Текст статьи</content>
<author>
<name>John Doe</name>
<email>johndoe@example.com</email>
</author>
<link rel="enclosure" href="http://images.site.ru/video.frame.mandatory.jpg" type="image/jpeg" length="123" />
</entry>
</feed>

 

Обязательными тегами для любого Atom-элемента (<entry>...</entry>) являются:

  • title - заголовок новости;
  • link - ссылка на новость на сайте. Оформляется, в отличие от RSS потоков, в виде однострочного элемента с обязательными параметрами href, rel и type="text/html".
  • published - дата публикации в формате [2003-12-13T18:30:02Z];
  • summary - аннотация новости.

Мультимедийный контент в RSS и Atom

В фиде могут присутствовать элементы, ведущие как на обычные (текст + набор изображений), так и на мультимедийные новости, содержащие, помимо текста, видео- или аудиоконтент. Роботы новостных проектов НЕ вытягивают и не сохраняют мультимедийный контент, не соответствующий условиям раздела Импорт видеопотоков. Однако, обнаружив в описании элемента фида признаки наличия мультимедии, роботы распознают новость, как содержащую видео или аудио, и обрабатывают его следующим образом:

  • При обнаружении тегов enclosure с установленным type="video/..." или type="audio/..." ссылка, находящаяся внутри параметра url считается прямой ссылкой на видео/аудиопоток. Элемент регистрируется, как мультимедийный, ссылка на страницу с роликом берется из тега link.

При указании наличия видеоконтента в элементе фида обязательно указание кадра из публикуемого ролика. В общем случае кадром из видеоролика считается первое обнаруженное в элементе изображение. Также по предварительной договоренности возможно указание всего фида, как мультимедийного. В этом случае необходимо и достаточно для каждого элемента фида указать ссылку на кадр в виде <enclosure url="http://images.site.ru/video.frame.mandatory.jpg" type="image/jpeg"/>, остальное робот сделает сам.

Импорт видеопотоков

В Рамблер/новости можно импортировать сами видеоролики в формате FLV. Все другие форматы игнорируются. Для импорта видеоролика необходимо в элемент фида включить его описание в виде тега enclosure.

<enclosure url="http://images.site.ru/video.file.flv" type="video/x-flv" width="n_width" height="n_height" /> где:
  • url – полный путь к видеоролику. Расширение видеоролика обязательно должно быть .flv
  • type – MIME-type контента. Обязательно должен быть установлен в значение video/x-flv
  • width – ширина видеоролика в пикселях
  • height – высота видеоролика в пикселях

В случае обнаружения правильно оформленного видеоролика, элемент фида будет отмечен, как мультимедийный, ссылка в теге <link> будет проинтерпретирована, как ссылка на страницу с видеороликом, а сам видеоролик в дальнейшем сможет раздаваться с серверов Рамблера.

Партнерам: дополнительные возможности для публикации

При наличии определенных договоренностей компания-партнер Рамблер/новостей может:

  • Транслировать в RSS полнотексты для последующего показа на проекте Рамблер/новости.
  • Привязывать к определенным новостям контекстные ссылки, ведущие на сайт партнера.
  • Для решения данных задач в поставляемом в Рамблер RSS или Atom должны присутствовать:
  • Описание пространства имен Рамблера в заголовке фида:
    • Для RSS: <rss xmlns:rambler="http://news.rambler.ru" version="2.0">
    • Для Atom: <feed xmlns="http://www.w3.org/2005/Atom" xmlns:rambler="http://news.rambler.ru">
    • Дополнительные теги из пространства имен Рамблера.

Робот Рамблер/новостей распознает и интерпретирует следующие теги:

<rambler:fulltext><![CDATA[полный текст новости]]></rambler:fulltext>

Указание данного тега в теле элемента является разрешением для публикации полного текста новости. Тег <rambler:fulltext> может присутствовать в фидах в качестве как основного тега для полнотекста, так и дополнительного, дублируя, к примеру, содержание <yandex:fulltext> или <fulltext>.

<rambler:related>

Данный тег используется для привязки к публикуемой новости дополнительных ссылок. Общий вид тега такой:

<rambler:related url="" title="" rel="" type="" pubdate="" author="" /> или такой: <rambler:related>
<url></url>
<title></title>
<rel></rel>
<type></type>
<pubdate></pubdate>
<author></author>
<description></description>
</rambler:related>

Первый вариант чаще используется для контекстных ссылок на связанные.

Описание контекстных ссылок

В описании новости добавляются от одного до трех элементов:

<rambler:related url="http://ссылка.на.связанную.новость" title="Заголовок новости" rel="news" type="text/html" pubdate="2009-01-01T18:30:02Z" author="Автор" />

Следует обратить внимание: rel="news" - описывает элемент, как контекстную ссылку на новость. type="text/html" - константа. Параметр author может отсутствовать.

Разметка на параграфы

Способов разметки текста на параграфы может быть два:

  1. С помощью парного тега параграфа <p></p>: <p>
    Первый параграф.
    </p>
    <p>
    Второй параграф.
    Это тоже второй параграф.
    </p>
    <p>
    Третий параграф.
    </p>
  2. С помощью двух символов перевода строки: Первый параграф.

    Второй параграф.
    Это тоже второй параграф.

    Третий параграф.

Внимание: Эти два способа – взаимоисключающие. Если текст содержит разметку параграфов тегами <p></p>, то разметка в нем с помощью переводов строки игнорируется, а параграфы, разбитые переводами строки – склеиваются.

Разметка текста внутри параграфов

Внутри параграфов одинарным символом перевода строки размечаются новые строки, например для оформления прямой речи:

<p>
Тут ударила мне кровь в голову.
— Ложи, — говорю, — взад!
А она испужалась. Открыла рот, а во рте зуб блестит.
</p>

Лишние переводы строки (а также пробелы) в начале параграфа, в конце параграфа и между параграфами игнорируются.

Примеры неправильного оформления

  1. Два параграфа, разбитые двойным переносом (что само по себе правильно), дополнительно завернуты в общий блок <p></p>, что ставит робота перед дилеммой — что из этих противоречивых указаний считать правдой (он это всегда решает в пользу <p></p> и, в итоге, текст слипнется в один общий параграф).
    <fulltext><p>
    Паводок в столичном регионе в этом году начнется раньше обычного. Уже в
    конце марта начнется массовое таяние снегов. "Особенность паводка этого
    года в том, что он ожидается в конце марта и продлится в первой декаде
    апреля, что раньше обычного. Многолетние наблюдения подтверждают,
    что если Пасха ранняя, то и половодье происходит раньше", - сообщил
    "Интерфаксу" гендиректор ГУП "Мосводоканал" Станислав Храменков.
    По словам Храменкова, предварительные оценки запасов воды в снеге,
    скопившемся на водозаборных территориях, обеспечивающих столицу водой,
    составляет около 110 процентов от нормы - следствие обильных
    снегопадов, которые шли в регионе всю зиму. Тем не менее, по словам
    главы "Мосводоканала", если в предстоящую неделю не выпадет большое
    количество осадков, то половодье по своему уровню будет на уровне
    прошлого года. "Наполненность москворецких водохранилищ сейчас
    составляет 66-70 процентов от их общего объема. При этом объем воды,
    которая получится из растаявшего снега, составит 300-330 миллионов
    кубометров. Такого количества воды хватит на обеспечение Москвы чистой
    свежей водой в течение 80 дней", - сказал Храменков.
    </p></fulltext>
  2. Текст внутри параграфов разбит переводами строки посредине предложений. Этот текст при выводе на экран более широкий (или более узкий), чем у того, кто так его ужимал, не будет заполнять всю доступную ширину, а сохранит это фиксированное форматирование и будет выглядеть некрасиво.
    <fulltext>
    Из ряда регионов могут быть выведены подразделения милиции особого
    назначения, заявили
    в МВД. В ведомстве считают, что их нахождение там уже нецелесообразно
    исходя из
    изменившейся социальной обстановки.МВД России может пересмотреть
    целесообразность
    дислокации спецподразделений милиции, в частности, ОМОН и ОМСН, в ряде
    регионов,
    сообщил первый замминистра внутренних дел генерал-полковник милиции
    Михаил
    Суходольский.
    «Мы, возможно, пересмотрим количество сотрудников спецподразделений в
    тех
    или иных регионах с учетом изменений социально-экономической
    обстановки.
    Где-то, может быть, присутствие этих отрядов уже перестало быть
    необходимостью», -- приводит его слова РИА
    «Новости».
    </fulltext>