Разметка RSS-канала

Структура RSS-канала

<?xml version="1.0" encoding="UTF-8"?>
<rss
  xmlns:yandex="http://news.yandex.ru"
  xmlns:media="http://search.yahoo.com/mrss/"
  xmlns:turbo="http://turbo.yandex.ru"
  version="2.0">
    <channel>
        ...
        <item turbo="true">
            ...
            <turbo:content>
                <![CDATA[
                    <!-- Содержимое страницы --> 
                ]]>
            </turbo:content>
        </item>
        <item turbo="true">
            ...
            <turbo:content>
                ...
            </turbo:content>
        </item>
        ...
    </channel>
</rss>

Обязательный параметр

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

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

...
    <channel>
        <title>Название канала</title>
        <link>http://www.example.com</link>
        <description>Краткое описание канала</description>
        <language>ru</language>
        <turbo:analytics></turbo:analytics>
        <turbo:adNetwork></turbo:adNetwork>
        <item turbo="true">
            <!-- Информация о странице -->
        </item>
        ...
    </channel>
...
title
Название RSS-канала.

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

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

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

language

Язык статьи по стандарту ISO 639-1.

turbo:analytics

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

Подробнее.

turbo:adNetwork

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

Подробнее.

item *

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

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

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

Обязательный параметр

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

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

...
    <item turbo="true">
        <link>http://www.example.com/page1.html</link>
        <turbo:source></turbo:source>
        <turbo:topic></turbo:topic>
        <pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
        <author>Иван Иванов</author>
        <turbo:content></turbo:content>
        <yandex:related></yandex:related>
    </item>
...
link *

URL страницы сайта, для которой нужно сформировать Турбо-страницу.

Требования:
  • ссылка должна содержать схему HTTP или HTTPS;
  • домен, указанный в ссылке, должен соответствовать домену сайта-источника;
  • максимальная длина URL — 243 ASCII-символа;
  • по одному URL должна быть доступна одна статья.

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

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

Заголовок страницы, который можно передать в Яндекс.Метрику.

pubDate

Время публикации в формате RFC-822.

Обязательный элемент для формирования автоматической главной страницы.

author

Автор статьи, размещенной на странице.

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>
       <link
        url="http://www.example.com/page2.html"
        img="http://www.example.com/image2.png">Текст ссылки
       </link>
    </yandex:related>
...

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

Обязательный параметр

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

Содержимое для Турбо-страницы передается с помощью элемента turbo:content. Его необходимо обернуть в раздел <![CDATA[]]>.
...
    <turbo:content>
        <![CDATA[
            <!-- Содержимое страницы -->
        ]]> 
    </turbo:content>
...
Содержимое страницы обязательно должно содержать шапку страницы и контентную часть:
...
    <header>
        <h1>Заголовок страницы</h1>
        <figure>
            <img src="http://example.com/img.jpg"/>
        </figure>
        <h2>Заголовок второго уровня</h2>
        <menu>
            <a href="http://example.com/page1.html">Текст ссылки</a>
            <a href="http://example.com/page2.html">Текст ссылки</a>
        </menu>
    </header>
    <!-- Контентная часть -->
...
h1 *

Заголовок страницы.

figure
Элемент, который используется для формирования превью в шапке. Может использоваться для формирования картинки с подписью.
img
Атрибут src должен содержать URL изображения.
Внимание. Поддерживаются форматы JPEG, PNG, GIF. Формат SVG в Турбо-страницах не поддерживается.
h2

Заголовок второго уровня.

menu
Навигационное меню.
a

Пункт меню. Атрибут href должен содержать ссылку на страницу сайта.

Обязательный параметр

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

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

Во всех элементах RSS-файла, кроме содержимого раздела <![CDATA[]]>, необходимо кодировать следующие символы:
Символ Название Код замены
& Амперсанд &amp;
> Правая угловая скобка &gt;
< Левая угловая скобка &lt;
" Кавычки &quot;
' Апостроф &apos;

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