Разметка 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>
        <!-- Информация о сайте-источнике -->
        <title>Название канала</title>
        <link>http://www.example.com</link>
        <description>Краткое описание канала</description>
        <language>ru</language>
        <turbo:analytics></turbo:analytics>
        <turbo:adNetwork></turbo:adNetwork>
        <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>
            <yandex:related></yandex:related>
            <turbo:content>
                <![CDATA[
                    <!-- Содержимое 1 страницы -->
                ]]>
            </turbo:content>
        </item>
        <item turbo="true">
            ...
            <turbo:content>
                <![CDATA[
                    <!-- Содержимое 2 страницы --> 
                ]]>
            </turbo:content>
        </item>
        ...
    </channel>
</rss>
channel *
Информация о сайте-источнике.
title
Название RSS-канала.

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

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

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

language

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

turbo:analytics

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

Подробнее.

turbo:adNetwork

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

Подробнее.

item *

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

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

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

link *

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

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

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

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

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

pubDate

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

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

author

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

yandex:related

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

Такие ссылки будут располагаться внизу Турбо-страницы. Чтобы добавить ссылки в любом месте страницы, используйте Блок ссылок на дополнительные материалы.

Бесконечная лента рекомендаций

Посмотрите пример отображения бесконечной ленты.

Внимание. Бесконечную ленту можно сформировать только из статей, для которых уже сформированы Турбо-страницы.
Чтобы задать набор страниц вручную:
  1. В элементе item нужной страницы добавьте элемент yandex:related с атрибутом type="infinity".
  2. Внутри элемента yandex:related добавьте ссылки на страницы, из которых будет формироваться лента. Ссылки необходимо задавать с помощью элемента link с атрибутом url.
    Пример:
    ...
        <yandex:related type="infinity">
            <link url="http://www.example.com/page.html"></link>
            <link url="http://www.example.com/page2.html"></link>
            ...
        </yandex:related>
    ...
Чтобы реклама ADFOX отображалась на Турбо-страницах с бесконечной лентой:
  1. В интерфейсе ADFOX перейдите на вкладку Параметры.
  2. В списке Тип кода выберите пункт <неповторяющиеся баннеры>.
Подробнее о настройке в Помощи 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>
    <!-- Контентная часть -->
...
header *
h1 *

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

figure
Элемент, который используется для формирования превью в шапке. Может использоваться для формирования картинки с подписью.
img
Атрибут src должен содержать URL изображения. Поддерживаются форматы JPEG, PNG, GIF.
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.

Пример RSS-канала

<rss xmlns:yandex="http://news.yandex.ru" xmlns:media="http://search.yahoo.com/mrss/" xmlns:turbo="http://turbo.yandex.ru" version="2.0">
    <channel>
        <title>Название RSS-канала</title>
        <link>http://www.example.com/</link>
        <description>Краткое описание RSS-канала</description>
        <turbo:analytics type="Yandex" id="123456"></turbo:analytics>
        <turbo:adNetwork type="Yandex" id="идентификатор блока" turbo-ad-id="first_ad_place"></turbo:adNetwork>
        <turbo:adNetwork type="AdFox" turbo-ad-id="second_ad_place">
            <![CDATA[
                <div id="идентификатор контейнера"></div>
                <script>
                    window.Ya.adfoxCode.create({
                        ownerId: 123456,
                        containerId: 'идентификатор контейнера',
                        params: {
                            pp: 'g',
                            ps: 'cmic',
                            p2: 'fqem'
                        }
                    });
                </script>
            ]]>
        </turbo:adNetwork>
        <yandex:related type="infinity">
            <link url="http://www.example.com/other-page1.html">Текст ссылки</link>
            <link url="http://www.example.com/other-page2.html">Текст ссылки</link>
        </yandex:related>
        <item turbo="true">
            <link>http://www.example.com/page1.html</link>
            <author>Иван Иванов</author>
            <category>Технологии</category>
            <pubDate>Sun, 29 Sep 2002 19:59:01 +0300</pubDate>
            <turbo:content>
                <![CDATA[
                    <header>
                        <h1>Ресторан «Полезный завтрак»</h1>
                        <h2>Вкусно и полезно</h2>
                        <figure>
                            <img src="https://avatars.mds.yandex.net/get-sbs-sd/403988/e6f459c3-8ada-44bf-a6c9-dbceb60f3757/orig">
                        </figure>
                        <menu>
                            <a href="http://example.com/page1.html">Пункт меню 1</a>
                            <a href="http://example.com/page2.html">Пункт меню 2</a>
                        </menu>
                    </header>
                    <p>Как хорошо начать день? Вкусно и полезно позавтракать!</p>
                    <p>Приходите к нам на завтрак. Фотографии наших блюд ищите <a href="#">на нашем сайте</a>.</p>
                    <h2>Меню</h2>
                    <figure>
                        <img src="https://avatars.mds.yandex.net/get-sbs-sd/369181/49e3683c-ef58-4067-91f9-786222aa0e65/orig">
                        <figcaption>Омлет с травами</figcaption>
                    </figure> 
                    <p>В нашем меню всегда есть свежие, вкусные и полезные блюда.</p>
                    <p>Убедитесь в этом сами.</p>
                    <button formaction="tel:+7(123)456-78-90" data-background-color="#5B97B0" data-color="white" data-primary="true">Заказать столик</button>
                    <div data-block="widget-feedback" data-stick="false">
                        <div data-block="chat" data-type="whatsapp" data-url="https://whatsapp.com"></div>
                        <div data-block="chat" data-type="telegram" data-url="http://telegram.com/"></div>
                        <div data-block="chat" data-type="vkontakte" data-url="https://vk.com/"></div>
                        <div data-block="chat" data-type="facebook" data-url="https://facebook.com"></div>
                        <div data-block="chat" data-type="viber" data-url="https://viber.com"></div>
                    </div>
                    <p>Наш адрес: <a href="#">Nullam dolor massa, porta a nulla in, ultricies vehicula arcu.</a></p>
                    <p>Фотографии — http://unsplash.com</p>
                ]]>
            </turbo:content>
        </item>
    </channel>
</rss>