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

Данные для Турбо‑страниц экспортируются в XML-based формате RSS 2.0. См. также Использование HTML и CSS.

Структура 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">
            <!-- Информация о странице -->
            <turbo:extendedHtml>true</turbo:extendedHtml>
            <link>http://www.example.com/category/sub-category/page1.html</link>
            <turbo:source></turbo:source>
            <turbo:topic></turbo:topic>
            <pubDate>Tue, 21 Apr 2015 14:15:00 +0300</pubDate>
            <author>Иван Иванов</author>
            <metrics>
                <yandex schema_identifier="Идентификатор">
                    <breadcrumblist>
                        <breadcrumb url="http://example.com/" text="Домашняя"/>
                        <breadcrumb url="http://example.com/category/" text="Категория"/>
                        <breadcrumb url="http://example.com/category/sub-category/" text="Подкатегория"/>
                        <breadcrumb url="http://example.com/category/sub-category/page1.html" text="Пример страницы"/>
                    </breadcrumblist>
                </yandex>
            </metrics>
            <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 описывает одну страницу.

turbo:extendedHtml*

Активация обработки пользовательского HTML и CSS.

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

link*

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

Требования:

  • ссылка должна содержать схему HTTP или HTTPS;

  • домен, указанный в ссылке, должен соответствовать домену сайта-источника;

  • максимальная длина URL — 243 ASCII-символа;

  • по одному URL должна быть доступна одна статья.

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

turbo:source

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

turbo:topic

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

pubDate

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

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

author

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

metrics

Внимание

Вложенные элементы metrics необходимо передавать, если вы используете Отчеты по контенту на основных страницах сайта.

Дополнительная информация о странице. Используется для связывания контентной информации на основной и Турбо‑странице сайта.

yandex

Информация для Яндекс.Метрики. Допустимые атрибуты:

breadcrumblist

Внимание

Элементы breadcrumblist не используются для построения «хлебных крошек». Они используются только для идентификации рубрики.

Блок с рубриками, который указан на основной странице сайта.

breadcrumb

Информация о странице. Допустимые атрибуты:

  • url — URL рубрики/страницы.
  • text — название рубрики/страницы.

yandex:related

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

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

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

Содержит элемент link. Максимальное количество ссылок — 30.

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

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

...
    <yandex:related>
        <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>
...
Бесконечная лента рекомендаций

Внимание

Бесконечную ленту можно сформировать только из статей, для которых уже сформированы Турбо‑страницы.

Чтобы задать набор страниц вручную:

  1. В элементе item нужной страницы добавьте элемент yandex:related с атрибутом type="infinity".

  2. Внутри элемента yandex:related добавьте ссылки на страницы, из которых будет формироваться лента. Ссылки необходимо задавать с помощью элемента link с атрибутом url. Внутри тега может быть текст до 240 символов.

Пример:

...
    <yandex:related type="infinity">
        <link url="http://www.example.com/page.html">example</link>
        <link url="http://www.example.com/page2.html">example</link>
        ...
    </yandex:related>
...

Чтобы реклама Adfox отображалась на Турбо‑страницах с бесконечной лентой:

  1. В интерфейсе Adfox перейдите на вкладку Параметры.

  2. В списке Тип кода выберите пункт <неповторяющиеся баннеры>.

Подробнее о настройке в Помощи Adfox.

turbo:content*

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

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

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

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

...
    <turbo:content>
        <![CDATA[
            <!-- Содержимое страницы -->
        ]]> 
    </turbo:content>
...

Содержимое страницы обязательно должно содержать шапку страницы и контентную часть:

Для того, чтобы сделать Турбо‑страницу более похожей на оригинал, используйте HTML и CSS. Стили устанавливаются через настройки CSS в Вебмастере.

...
    <!-- Шапка -->
    <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-файл передается в кодировке KOI8-R, замените встречающиеся в тексте символы кодировки Windows-1251 на аналоги  KOI8-R:

Символ Название Код замены
... Многоточие 133
Короткое тире (en-dash) 150
Длинное тире (em-dash) 151
' ' Английские одиночные кавычки 145 и 146
" " Английские двойные кавычки («лапки») 147 и 148
« » Французские кавычки («елочки») 171 и 187
Номер 185

Пример 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>
        <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>
            <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>
            <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>Как хорошо начать день? <del>С чашки бодрящего кофе!</del> <ins>Вкусно и полезно позавтракать!</ins></p>
                    <p><b>Приходите</b> к нам на завтрак. Фотографии наших блюд ищите <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>
                    <section id="contacts">
                        <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>
                    <section>
                    <p><small>Фотографии — http://unsplash.com</small></p>
                ]]>
            </turbo:content>
        </item>
    </channel>
</rss>
Написать в службу поддержки