Описание элементов RSS 2.0

Корневым элементом RSS-файла является rss, атрибут version которого должен иметь значение 2.0.

<rss
    xmlns:yandex="http://news.yandex.ru"
    xmlns:media="http://search.yahoo.com/mrss/"
    xmlns:turbo="http://turbo.yandex.ru"
    version="2.0">
    ...
</rss>

Для формирования Турбо-страницы передайте следующие данные:

...
    <channel><!--Информация о сайте-источнике (RSS-канале)-->
        ...
        <item turbo="true"><!--Информация о странице-->
            ...
            <turbo:content>...</turbo:content><!--Содержимое страницы-->
            ...
        </item>
    </channel>
</rss>
  1. Передача информации о сайте-источнике
    1. Подключение систем веб-аналитики
    2. Подключение рекламы
  2. Передача информации о странице
  3. Передача содержимого страницы
  4. Символы и кодировки

Передача информации о сайте-источнике

Сведения передаются в элементе channel.

Элемент Описание
title

Название RSS-канала.

Если экспортируется содержимое всего сайта, укажите название сайта. Если экспортируется раздел сайта, укажите только название раздела.

<title>Название канала</title>
link

Домен сайта, данные которого транслируются.

<link>http://www.example.com</link>
description

Описание канала одним предложением. Не используйте HTML-разметку.

<description>Краткое описание потока</description>
language
Язык статьи по стандарту ISO 639-1.
<language>ru</language>
yandex:analytics

Счетчик системы веб-аналитики для учета посещаемости Турбо-страниц. Подробнее

yandex:adNetwork

Используйте для отображения блоков Рекламной сети Яндекса и сторонней рекламы, подключенной через ADFOX на Турбо-страницах. А также для учета доходов от рекламы при использовании Турбо-страниц. Подробнее

item*

Информация о странице и ее содержимом.

Чтобы использовать формат Турбо-страниц, добавьте атрибут turbo со значением true. Чтобы отключить отображение Турбо-страницы, используйте значение false. Подробнее см. в разделе Управление отображением Турбо-страниц.

...
    <item turbo="true">
        ... 
    </item>

Один элемент item описывает одну страницу.

* Обязательный элемент.

Подключение систем веб-аналитики

  1. Подключение поддерживаемых систем веб-аналитики
  2. Подключение произвольной системы веб-аналитики
  3. Передача в систему веб-аналтики адреса страницы-источника и заголовка Турбо-страницы

Подключение поддерживаемых систем веб-аналитики

Вы можете подключить некоторые системы веб-аналитики с помощью специальных значений атрибута type элемента yandex:analytics.

Чтобы трафик на Турбо-страницах учитывался в разных системах статистики, в элемент channel добавьте сразу несколько элементов yandex:analytics:
Яндекс.Метрика
Можно указать несколько счетчиков Яндекс.Метрики
Атрибут Описание
type* Принимает значение Yandex.
id* Номер счетчика Яндекс.Метрики.
params Используйте для передачи параметров визитов.
<yandex:analytics
 id="номер счетчика"
 type="Yandex"
 params="{ 'param' : 'val' }">
</yandex:analytics>
LiveInternet
Укажите атрибут type со значением LiveInternet.
<yandex:analytics
 type="LiveInternet">
</yandex:analytics>

Если счетчик используется для нескольких хостов, добавьте атрибут params с названием счетчика.

<yandex:analytics
 type="LiveInternet"
 params="Название счетчика">
</yandex:analytics>
Google Analytics

Укажите атрибут type со значением Google и атрибут id с идентификатором счетчика.

<yandex:analytics
 id="идентификатор отслеживания"
 type="Google">
</yandex:analytics>
Рейтинг Mail.RU

Укажите атрибут type со значением MailRu и атрибут id с идентификатором счетчика.

<yandex:analytics
 id="идентификатор счетчика"
 type="MailRu">
</yandex:analytics>
Rambler Топ-100

Укажите атрибут type со значением Rambler и атрибут id с идентификатором счетчика.

<yandex:analytics
 id="идентификатор счетчика"
 type="Rambler">
</yandex:analytics>
Mediascope (TNS)
Укажите атрибут type со значением Mediascope и атрибут id с номером счетчика.
<yandex:analytics
 id="идентификатор tmsec от Mediascope"
 type="Mediascope">
</yandex:analytics>

Где найти идентификатор или номер счетчика.

Подключение произвольной системы веб-аналитики

Если ваша система веб-аналитики поддерживает установку в виде изображения (пикселя), вы можете подключить ее к Турбо-странице:
  1. Добавьте в элемент yandex:analytics атрибуты:
    • type* — со значением custom;
    • url* — с адресом пикселя системы статистики.
  2. Укажите в URL параметры, которые необходимо передавать в систему веб-аналитики:
    • {referrer} — реферер;
    • {referrerStarsEscaped} — реферер для Mediascope (с экранированным символом *), если вы хотите подключить эту систему, не указывая идентификатор;
    • {pageTitle} — заголовок страницы;
    • {originalURL} — URL местоположения оригинальной страницы;
    • {screenWidth} — ширина экрана;
    • {screenHeight} — высота экрана;
    • {random} — псевдослучайное число (на каждое вхождение в строке генерируется новое значение);
    • {requestId} — идентификатор запроса (одинаковый в рамках страницы);
    • {clientId} — идентификатор клиента (одинаковый для браузера пользователя).
<yandex:analytics
 type="custom"
 url="http://some.doma.in/{screenWidth}*{clientId}/{random}/{pageURL}?title={pageTitle}" >
</yandex:analytics>

Передача в систему веб-аналтики адреса страницы-источника и заголовка Турбо-страницы

Передайте в элементе item элементы turbo:source и turbo:topic.

Подключение рекламы

Чтобы добавить несколько рекламных блоков, для каждого блока укажите отдельный элемент yandex:adNetwork.

Чтобы указать место размещения рекламы на странице:
  1. Задайте для рекламного блока произвольный идентификатор в качестве значения атрибута turbo-ad-id. Например, first_ad_place, second_ad_place.
  2. Укажите этот идентификатор в качестве значения атрибута data_turbo_ad_id в элементе figure внутри элемента turbo:content.

Если атрибут turbo-ad-id не указан, реклама не будет отображаться на Турбо-странице.

В партнерском интерфейсе создайте рекламный блок для Турбо-страниц. В RSS-файл добавьте атрибут type со значением Yandex и атрибут id с буквенно-числовым идентификатором рекламного блока.

Если вы размещаете несколько блоков рекламы, каждый элемент yandex:adNetwork должен содержать уникальное значение атрибута id. Если вы укажете одинаковое значение, отобразится только первый блок.

...
<yandex:adNetwork
 type="Yandex"
 id="идентификатор блока 1"
 turbo-ad-id="first_ad_place">
</yandex:adNetwork>
...
<yandex:adNetwork
 type="Yandex"
 id="идентификатор блока 2"
 turbo-ad-id="second_ad_place">
</yandex:adNetwork>
...

Где найти идентификатор рекламного блока или код вставки.

Передача информации о странице

Данные передаются в элементе item.

Элемент Описание
link*

URL страницы-источника.

<link>http://www.example.com/page1.html</link>
Требования:
  • ссылка должна содержать схему HTTP или HTTPS;
  • домен, указанный в ссылке, должен соответствовать домену сайта-источника;
  • максимальная длина URL — 243 ASCII-символа;
  • по одному URL должна быть доступна одна статья.

При переходе по ссылке заголовок и начало текста должны быть видны на первом экране при разрешении 1024 × 768.

turbo:source URL страницы-источника, который можно передать в систему веб-аналитики.
turbo:topic Заголовок страницы, который можно передать в систему веб-аналитики.
pubDate

Время публикации контента на сайте источника.

Передается в формате RFC-822.

<pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
author Автор статьи, размещенной на странице.
<author>Иван Иванов</author>
turbo:content*

Содержимое страницы.

yandex:related

Вы можете разместить ссылки на другие ресурсы или настроить отображение непрерывной ленты статей, реализованной, например с помощью AJAX.

Блок со ссылками на другие страницы сайта

Содержит элемент link. Количество вложенных элементов не ограничено.

Чтобы добавить к статье изображение, используйте атрибут img с URL, по которому доступна иллюстрация.

Оборачиваемый в элемент link текст не должен содержать HTML-элементы.
<yandex:related>
    <link
     url="http://www.example.com/page.html"
     img="http://www.example.com/image.png">Текст ссылки
    </link>
</yandex:related>
Непрерывная лента статей

Добавьте в элемент yandex:related атрибут type со значением infinity. Внутри элемента yandex:related укажите элемент link со ссылкой на статью.

Чтобы добавить к статье изображение, используйте атрибут img с URL, по которому доступна иллюстрация.

Оборачиваемый в элемент link текст не должен содержать HTML-элементы.

<yandex:related type="infinity">
    <link
     url="http://www.example.com/page.html"
     img="http://www.example.com/image.png">Текст ссылки
    </link>
</yandex:related>

Если вы подключили к Турбо-старницам рекламу с помощью ADFOX, на вкладке Сайты, выберите в параметре Тип баннеров значение <неповторяющиеся баннеры>.

* Обязательный элемент.

Передача содержимого страницы

Контент для Турбо-страницы передается с помощью элемента turbo:content. Содержимое необходимо обернуть в тег <![CDATA[]]>.

Шапка страницы (верхняя часть страницы)

Используйте элемент header, который может включать в себя:

Элемент Описание
figure Содержит элемент img с адресом изображения, которое используется в качестве обложки. Изображение может быть в любом формате.
<header>
    <figure>
        <img src="http://example.com/img.jpg" />
    </figure>
    ...
h1* Заголовок первого уровня.
<h1>Текст заголовка</h1>

* Обязательный элемент.

Оформление текста
Элемент Описание
h1
Заголовок первого уровня.
<h1>Заголовок страницы</h1>

Поддерживаются шесть уровней заголовков.

p
Параграф.
<p>Параграф текста</p>
br
Перенос строки без отступа.
<br>Текст</br>
ul
Маркированный список.
<ul>
    <li>первый пункт списка</li>
</ul>
ol
Нумерованный список.
<ol>
    <li>первый пункт списка</li>
</ol>
b
Выделение текста жирным.
<b>Текст</b>
strong Выделение текста. Обычно браузеры отображают его жирным.
<strong>Текст</strong>
i Выделение текста курсивом.
<i>Текст</i>
em Выделение текста. Обычно браузеры отображают его курсивом.
<em>Текст</em>
sup Верхний индекс.
2<sup>3</sup>
sub Нижний индекс.
H<sub>2</sub>O
ins

Выделение текста, который был добавлен в новую версию статьи. Большинство браузеров отображают его подчеркнутым.

Основной текст, <ins>новый текст</ins>
del

Выделение текста, который был удален в новой версии статьи. Большинство браузеров отображают его зачеркнутым.

Основной текст, <del>удаленный текст</del>
small
Уменьшение размера шрифта на одну условную единицу.
<small>Текст</small>
big Увеличение размера шрифта на одну условную единицу.
<big>Текст</big>
pre
Выделение предварительно форматированного текста.
<pre>Текст</pre>
abbr Выделение аббревиатуры в тексте.
<abbr title="Пояснение">HTML</abbr>
u
Подчеркивание текста.
<u>Текст</u>
Картинка в тексте

Поддерживаются форматы JPEG и PNG. Вы можете разместить картинку внутри абзаца (элемент p) или между абзацами. Для этого используйте элемент img, в атрибуте src укажите URL изображения.

...
    <img src="http://example.com/img.jpg" />
...

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

Элемент Описание
figcaption Видимая подпись картинки.
 ...
    <figure>
        <img src="http://example.com/img.jpg" />
        <figcaption>Подпись</figcaption>
    </figure>
...
Видео в тексте
Вы можете добавить на Турбо-страницу видео, размещенные на вашем сайте или на сторонних ресурсах.

Поддерживается формат MP4. Используйте элемент figure, который может содержать:

Элемент Описание
video Включает в себя элемент source с атрибутами:
  • src — ссылка на видео. Видео должно быть доступно по протоколу HTTPS.
  • type — тип медиаматериала и его формат.
...
<figure>
    <video>
        <source
         src="https://example.com/video.mp4"
         type="video/mp4" />
    </video>
    ...
img Превью видео (изображение) в любом формате.
...
<figure>
    <video>
        <source
         src="https://example.com/video.mp4"
         type="video/mp4" />
    </video>
    <img src="http://example.com/img.jpg" />
    ...
figcaption Подпись к видео.
...
<figure>
    <video>
        <source
         src="https://example.com/video.mp4"
         type="video/mp4" />
    </video>
    <img src="http://example.com/img.jpg" />
    <figcaption>Подпись к видео</figcaption>
</figure>
Кнопка «Поделиться»

Чтобы разместить на Турбо-странице кнопку «Поделиться», используйте элемент div, который может содержать:

Атрибут Описание
data-block*

Принимает значение share.

data-network Вы можете указать одно или несколько значений через запятую:
  • facebook;
  • google;
  • odnoklassniki;
  • telegram;
  • twitter;
  • vkontakte.

Если атрибут data-network не указан, будут подключены все перечисленные выше сервисы.

<div data-block="share" data-network="twitter, facebook"></div> 
Цитаты в тексте
Для оформления цитаты в тексте используйте элемент blockquote. Он может содержать поддерживаемые HTML-элементы. Чтобы разместить в цитате картинку, используйте элемент figure.
...
    <blockquote>
        <p>Текст</p>
        <figure>
            <img src="http://example.com/img.jpg" />
            <figcaption>Подпись</figcaption>
        </figure>
        ...
    </blockquote>
...
Таблицы в тексте
Таблица может содержать:
...
    <table>
        <th><!--Заголовок таблицы-->
            <td>Первый столбец</td>
            <td>Второй столцец</td>
        </th>
        <tr><!--Строка таблицы-->
            <td>Первый столбец</td>
            <td>Второй столцец</td>
        </tr>
    </table>
...
Элементы меню
Чтобы разместить на Турбо-странице меню, используйте элемент menu. Он может содержать элемент a, в атрибуте href которого укажите в качестве значения ссылку на страницу сайта.

На Турбо-странице появится значок . Когда пользователь нажмет на него, элементы навигации отобразятся на Турбо-странице в виде блока ссылок с заголовком Меню.

...
    <menu>
      <a href="http://example.com/page1.html">Текст ссылки</a>
      <a href="http://example.com/page2.html">Текст ссылки</a>
    </menu>
...
Встраиваемый контент Instagram и Twitter
Чтобы разместить на Турбо-странице контент сторонних ресурсов:
  1. Скопируйте код для встраивания ресурса.
  2. Добавьте скопированный код в тег <![CDATA[]]> в элементе turbo:content.

Пример:

...
<turbo:content>
    <![CDATA[
        <!--Код для встраивания-->
    ]]>
</turbo:content>
...
Комментарии

Используйте древовидную структуру элемента div. Количество уровней вложенности не ограничено.

Атрибут Описание
data-block*
Принимает значения:
data-author* Принимает значение author — имя автора комментария.
data-avatar-url Ссылка на аватар автора комментария. Картинка должна быть в формате JPG или PNG, не меньше 64 × 64 пикселей.
data-subtitle Дополнительная строка информации, например дата комментария. Располагается под именем автора.
data-url Используется только в элементе div верхнего уровня. Ссылка на страницу добавления комментариев.

Содержимое комментария:

Элемент Описание
header

Заголовок комментария. Располагается над текстом комментария.

HTML-элементы Поддерживаемые HTML-элементы.
<div data-block="comments" data-url="http://example.com/comments">
  <div
   data-block="comment"
   data-author="author" 
   data-avatar-url="http://example.com/img.png" 
   data-subtitle="2017-12-10"
  >
    <div data-block="content">
      <header>Заголовок первого комментария</header>
      <p>
        <b>Текст</b> комментария
        <a href="https://example.com">Текст ссылки</a>
      </p>
    </div>
    <div data-block="comments"> 
      <div data-block="comment" data-author="author2">
        Ответ на первый комментарий
      </div>
        ... 
    </div>  
  </div>
  <div
   data-block="comment"
   data-author="author"> 
     <div data-block="content">
       Содержимое второго комментария
     </div>
  </div> 
  ... 
</div>
Место размещения рекламы
Внимание. Не добавляйте рекламные блоки чаще, чем через каждые 250 слов страницы. Часто расположенная реклама ухудшает читаемость сообщений на Турбо-страницах. Из-за этого со временем пользователи могут перестать переходить на ваши страницы.
Чтобы указать место на странице, где должен размещаться рекламный блок, используйте элемент figure. Он должен содержать атрибут data-turbo-ad-id со значением, указанным в элементе yandex:adNetwork.
<figure data-turbo-ad-id="first_ad_place"></figure>

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

В экспортном файле укажите кодировку, отдаваемую вашим сервером. Наиболее часто используются: UTF-8, Windows-1251, KOI8-R.

Во всех вложенных элементах channel и item необходимо кодировать следующие символы:

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

Например, ссылка http://example.com/?id=1&page=10 должна быть приведена к виду http://example.com/?id=1&amp;page=10.