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

Для импорта в Рамблер/новости вам нужно создать новостной поток — в терминологии системы — фид. Новости, статьи и заметки в фиде для успешного импорта в Рамблер/новости должны иметь вид XML-документа, оформленного в соответствии с правилами формата RSS 2.0.

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

Фид должен начинаться с объявления формата XML с обязательным указанием кодировки текста: <?xml version="1.0" encoding="utf-8"?> В ответе в заголовках сервера для параметра "Content-Type" должно быть указано значение "application/rss+xml; charset=utf-8".

В фиде не должно быть ошибок XML-кода — проверьте его, открыв в обоих браузерах Google Chrome и Mozilla FireFox. Каждая новость на сайте источника должна иметь постоянный уникальный адрес, чтобы переходе на публикацию по ссылке из фида всегда открывалась именно эта новость.

Описание тегов для оформления RSS-фида

Посмотрите на пример оформления XML-кода в файле фида, чтобы понять, какие теги и атрибуты обязательно нужно добавить и какую информацию они должны содержать.

<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:rambler="http://news.rambler.ru" version="2.0">
  <channel>
    <title>Название канала</title>
    <link>https://example.com</link>
    <description>Краткое описание канала</description>
    <item>
      <title>Заголовок новости</title>
      <pubDate>Tue, 19 Jan 2038 03:14:07 +0000</pubDate>
      <guid>a124381d-65ef-4ef9-b8ab-e2b384095497</guid>
      <link>https://example.com/tech/1234561</link>
      <enclosure url="https://news.store.rambler.ru/img/940b519c35a4aae222ed15a92525de37" type="image/jpeg"/>
      <author>Петр Стругацкий</author>
      <category>Гороскопы</category>
      <description>Гороскоп на неделю 18-24 января 2038 года для каждого знака</description>
      <content><![CDATA[<p>Текст публикации</p>]]></content>
    </item>
  </channel>
</rss>
Тег 1 уровняТег 2 уровняТег 3 уровняОписание
channel*Тег открывает группу с информацией о сайте-источнике
 title*Название RSS-канала или название сайта
 link*Адрес вашего сайта, откуда транслируются новости (не ссылка на новость)
 descriptionОписание вашего новостного канала, которое увидят читатели
 item*Новостная публикация
  title*Заголовок новости
  link*Ссылка на новость на сайте
  guidУникальный идентификатор публикации в фиде.
  content*Содержимое новости
  pubDateВремя публикации новости, указывается строго в формате RFC-2822
  authorАвтор статьи
  categoryКатегория или рубрика новости
  descriptionАннотация или краткое описание новости
  enclosureЭлемент для передачи мультимедийных элементов.

* - обязательный элемент/атрибут

Необходимо экранировать символы во всех элементах фида, кроме содержимого <![CDATA[]]>.

СимволЭкранированиеНазвание
&&amp;Амперсанд
>&gt;Правая угловая скобка
<&lt;Левая угловая скобка
"&quot;Двойная кавычка
'&apos;Апостроф (или одинарная кавычка)

Мультимедийные элементы

В фиде могут присутствовать элементы, описывающие мультимедиа контент для всей публикации. К такому контенту относится изображения для публикации(заглавное изображение новости).

<enclosure url="https://news.store.rambler.ru/img/9c4d95419ed9dbed3677537d064f88e1" type="image/jpeg"/>

При обнаружении тегов enclosure с установленным type=“image/…” ссылка, находящаяся внутри параметра url считается прямой ссылкой на изображение. Элемент регистрируется, как мультимедийный, ссылка на изображение берется из атрибута url.

Поддерживаются следующие форматы - PNG, JPG, WEBP, AVIF, PJPEG, максимальный размер изображения - 5Мбайт.

Содержимое новости

Текст публикации находится в элементе content или full-text. Дополнительно текст новости нужно поместить в блок <![CDATA[]]>, как на примере ниже. Если же один из этих элементов находится в именованной группе, нужно указать соответствующую запись в пространстве имен.

<content>
    <![CDATA[<!-- News item body -->]]>
<content>

При оформлении новости можно использовать следующие теги.

ЭлементОписание
<p>Оформление выбранного текста в параграф
<a>Ссылки в тексте новости
<h1>Заголовок страницы
<h2>Заголовок второго уровня (для оформления разделов в длинной публикации)
<blockquote>Тег для оформления цитаты
<figure>Тег для вставки фото или видео

Новостные роботы всех проектов Рамблера при сканировании содержимого новости выше. Любые другие теги в содержимом новости будут проигнорированы.

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

Чтобы разделить длинный текст на удобные для чтения параграфы, поместите текст параграфа внутрь парного тега <p></p>. Например:

<p>
    Первый параграф.
</p>
<p>
    Второй параграф.
    Это тоже второй параграф.
</p>
<p>
    Третий параграф.
</p>

Для оформления прямой речи можно перейти на новую строку. При этом новая строфа.

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

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

Ссылки в тексте

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

<a href="https://news.rambler.ru">Rambler/News</a>

где атрибут href - абсолютный URL. Другие атрибуты в парсинге не участвуют.

Цитаты в тексте

Для оформления цитаты поместите её текст в тег blockquote.

<blockquote>
    <p>For a surfer, it's never-ending. There's always some wave you want to surf.<p>
</blockquote>

Картинки

Чтобы разместить картинку, используйте элементы figure и img, где

ТегАтрибутОписание
figure*Тег содержащий картинку
img*src*Абсолютный URL до изображения
 altОписание изображения
figcaptionТекст подписи

* - обязательный элемент/атрибут

<figure>
    <img src="https://news.store.rambler.ru/img/c603a51a6ee23b197ae619217838ab0b" alt="Technodrome"/>
</figure>

Чтобы разместить изображение с подписью под ним, в теге figcaption напишите текст подписи.

<figure>
    <img src="https://news.store.rambler.ru/img/2d2aaf3861a806c3fc52591dd9fe7248"/>
    <figcaption>Nikolaus Kopernikus</figcaption>
</figure>

Поддерживаются изображения формата - PNG, JPG, WEBP, AVIF, PJPEG.

Видео

Чтобы разместить видео, используйте элементы figure, video, source img и figcaption, где

ТегАтрибутОписание
video*widthШирина видео
 heightВысота видео
source*src*Абсолютный URL до видео
 typeФормат видео
imgsrc*Ссылка на изображение-превью
figcaptionТекст подписи

* - обязательный элемент/атрибут

<figure>
    <video width="192" height="108">
        <source
            src="https://vp.rambler.ru/player/embed.html?widget=Player&id=2022751"
            type="video/mp4"/>
    </video>
    <img src="https://news.store.rambler.ru/img/ed6743019ffa3c22e3427f3d842ba185"/>
    <figcaption>Лихач на электросамокате обогнал автомобили на проезжей части и попал на видео</figcaption>
</figure>

Пример оформления фида 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>30c2a02c-592b-4c0e-a852-871d8891921c</guid>
            <title>Саммит технологического развития</title>
            <link>http://www.site.ru/news/123456/</link>
            <pubDate>Tue, 09 Jan 2007 09:41:00 -0700</pubDate>
            <description>В Москве на улице Пятницкой прошел саммит технологического развития</description>
            <category>Экономика</category>
            <content><![CDATA[
                <p>На форуме Алексеем Мозолевым была презентована новая версия программы «Фракции» для работы на рынке ценных бумаг.
                Новая версия программы для работы с ценными бумагами «Фракция» стала доступна для скачивания на сайте компании.</p>
                <figure>
                    <img src="https://news.store.rambler.ru/img/edac4335cc49ea0f6257abba63d5a17b"/>
                </figure>
                <p>В ней был обновлен дизайн и добавлены новые функции. Кроме того, теперь программа доступна на мобильных устройствах.
                Также на форуме были представлены новые продукты компании: «Фракцион-инвестинг» и «Фракционный портфель».</p>
                <blockquote>
                    <p>Мы с Алексеем знакомы уже давно. Это очень хороший специалист, который занимается развитием новых технологий в России.
                    И я рад, что он приехал на наш форум. Думаю, мы будем сотрудничать с ним в дальнейшем.</p>
                </blockquote>
                <p>отметил один из соучередителей компании «Hitbox».</p>
            ]]></content>
            <author>Андрей Марков</author>
        </item>
        <item>
            <guid>e86cceb2-6c48-4a31-8c46-c6ce9717b484</guid>
            <title>Как укаживать за фикусами?</title>
            <link>http://www.site.ru/news/123457/</link>
            <pubDate>Mon, 09 Feb 2009 12:00:21 +0300</pubDate>
            <description>Один из агрономов дала свой комментарий по поводу ухода за фикусами</description>
            <category>Садоводство</category>
            <content><![CDATA[
                <p>Фикус как комнатное растение используется в цветоводстве с незапамятных времен. В настоящее время в наших квартирах 
                можно встретить сотни разновидностей этого растения. На самом деле фикусы неприхотливы и просты в уходе, 
                главное - это знать особенности его содержания. 
                Как говорит Ольга Бетельгейзова, <a href="https://en.wikipedia.org/wiki/Ficus_benjamina">фикус Бенджамина</a> - этот вид фикуса является 
                самым распространенным. Его можно увидеть в каждом доме и на каждом подоконнике. Он прекрасно себя чувствует в домашней среде, 
                но его нужно ежедневно поливать, иначе он может погибнуть. Это растение очень любит тепло, поэтому летом его рекомендуется 
                ставить на южном окне. Главное не открывать окно - в противном случае любое дуновение холодного воздуха навредит и все 
                фикусы могут заболеть. Чтобы фикус был здоровым и красивым, нужно правильно за ним ухаживать.</p>
            ]]></content>
            <author>Орина Абрикосова</author>
            <enclosure url="https://news.store.rambler.ru/img/86f898372b5f8d87892e71a36fc13fdf" type="image/jpeg"/>
            <enclosure url="https://news.store.rambler.ru/img/d8d305c904ef4e85568c1a8e58d8bd10" type="image/jpeg"/>
        </item>
        <item>
            <guid>184720b6-ea4e-4f5b-939b-bdb67228cb83</guid>
            <title>Ученый-исследователь из Владимира сделал открытие</title>
            <link>http://www.site.ru/news/123458/</link>
            <pubDate>Fri, 27 Feb 2009 12:03:25 +0300</pubDate>
            <description>Ученый-исследователь из Владимира сделал открытие</description>
            <category>Наука</category>
            <full-text><![CDATA[
                <p>Ученый-исследователь кафедры органической химии Владимирского государственного университета (ВлГУ) Максим Вайтмусташев 
                совместно с коллегами из Московского авиационного института открыл новое взаимодействие, которое может стать основой для создания 
                новых лекарственных препаратов. Открытие относится к области химии высокомолекулярных соединений, а именно к взаимодействию 
                между мономерными звеньями и разветвленными функциональными группами. Это взаимодействие происходит при получении нанокристаллических 
                порошков, которые могут быть использованы в качестве нанопорошков в различных областях науки и техники. 
                В результате взаимодействия происходит образование новых химических связей, что приводит к изменению физических свойств вещества.</p>
                <blockquote>
                    <p>В качестве исходного вещества используется сложный эфир, который в присутствии катализатора реагирует со спиртом. 
                    В результате получается новое соединение, обладающее рядом полезных свойств. Например, этот эфир может выступать 
                    в роли блокатора рецепторов, ответственных за боль. В настоящее время в России нет лекарств, которые бы обладали 
                    избирательным воздействием на миелопероксидазу - фермент, участвующий в процессах перекисного окисления липидов и 
                    отвечающий за возникновение так называемой оксидативной (окислительной) модификации белков.</p>
                </blockquote>
                <p>сообщил ученый.</p>
            ]]></full-text>
        </item>
    </channel>
</rss>