Разметка 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
Если экспортируется содержимое всего сайта, укажите название сайта. Если экспортируется раздел сайта, укажите только название раздела.
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
turbo:topic
Заголовок страницы, который можно передать в Яндекс.Метрику.
pubDate
Время публикации в формате RFC-822.
Обязательный элемент для формирования автоматической главной страницы.
author
Автор статьи, размещенной на странице.
metrics
Дополнительная информация о странице. Используется для связывания контентной информации на основной и Турбо‑странице сайта.
yandex
- schema_identifier — идентификатор, который указан на основной странице.
breadcrumblist
Блок с рубриками, который указан на основной странице сайта.
breadcrumb
- url — URL рубрики/страницы.
- text — название рубрики/страницы.
yandex:related
Вы можете разместить ссылки на другие ресурсы или настроить отображение бесконечной ленты статей.
Такие ссылки будут располагаться внизу Турбо‑страницы. Чтобы добавить ссылки в любом месте страницы, используйте Блок ссылок на дополнительные материалы.
- В элементе item нужной страницы добавьте элемент yandex:related с атрибутом type="infinity".
- Внутри элемента 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 перейдите на вкладку Параметры.
- В списке Тип кода выберите пункт <неповторяющиеся баннеры>.
turbo:content
** Обязательный параметр
Передача содержимого страницы
... <turbo:content> <![CDATA[ <!-- Содержимое страницы --> ]]> </turbo:content> ...
Скопировано
- Шапка задается с помощью элемента header и может содержать заголовок, меню и картинку для превью.
- Контентная часть может содержать все доступные элементы Турбо‑страниц: текст, картинки и видео, таблицы и т. д. При этом она должна полностью повторять структуру и содержимое основной страницы. Подробнее в разделе Требования к содержимому.
... <!-- Шапка --> <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
h2
Заголовок второго уровня.
menu
a
Пункт меню. Атрибут href должен содержать ссылку на страницу сайта.
* Обязательный параметр
Символы и кодировки
В экспортном файле укажите кодировку, отдаваемую вашим сервером. Наиболее часто используются: UTF-8, Windows-1251, KOI8-R.
Символ | Название | Код замены |
---|---|---|
& | Амперсанд | & |
> | Правая угловая скобка | > |
< | Левая угловая скобка | < |
" | Кавычки | " |
' | Апостроф | ' |
Символ | Название | Код замены |
---|---|---|
& | Амперсанд | & |
> | Правая угловая скобка | > |
< | Левая угловая скобка | < |
" | Кавычки | " |
' | Апостроф | ' |
Например, ссылка http://example.com/?id=1&page=10 должна быть приведена к виду http://example.com/?id=1&page=10.
Если RSS-файл передается в кодировке KOI8-R, замените встречающиеся в тексте символы кодировки Windows-1251 на аналоги KOI8-R:
Символ | Название | Код замены |
---|---|---|
... | Многоточие | 133 |
– | Короткое тире (en-dash) | 150 |
— | Длинное тире (em-dash) | 151 |
' ' | Английские одиночные кавычки | 145 и 146 |
" " | Английские двойные кавычки («лапки») | 147 и 148 |
« » | Французские кавычки («елочки») | 171 и 187 |
№ | Номер | 185 |
Символ | Название | Код замены |
---|---|---|
... | Многоточие | 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>
Скопировано