The RSS feed markup
Data for Turbo pages is exported in the XML-based RSS 2.0 format. See also Using HTML and CSS.
The RSS feed structure
<?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>
<!-- Information about the source site -->
<title>Feed title</title>
<link>http://www.example.com/</link>
<description>Short feed description</description>
<language>ru</language>
<turbo:analytics></turbo:analytics>
<turbo:adNetwork></turbo:adNetwork>
<item turbo="true">
<!-- Page information -->
<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
<author>Ivan Ivanov</author>
<metrics>
<yandex schema_identifier="ID">
<breadcrumblist>
<breadcrumb url="http://example.com/" text="Home"/>
<breadcrumb url="http://example.com/category/" text="Category"/>
<breadcrumb url="http://example.com/category/sub-category/" text="Subcategory"/>
<breadcrumb url="http://example.com/category/sub-category/page1.html" text="Page example"/>
</breadcrumblist>
</yandex>
</metrics>
<yandex:related></yandex:related>
<turbo:content>
<![CDATA[
<!-- 1 page content -->
]]>
</turbo:content>
</item>
<item turbo="true">
...
<turbo:content>
<![CDATA[
<!-- Page 2 content -->
]]>
</turbo:content>
</item>
...
</channel>
</rss>
channel
*title
If you export the entire site contents, specify the site name. If you export a site section, enter just the section title.
link
description
Channel description in one sentence. Do not use HTML markup.
language
The article language according to the ISO 639-1 standard.
turbo:analytics
Web analytics tag for tracking Turbo pages traffic.
turbo:adNetwork
Use it to specify the Yandex Advertising Network blocks and third-party ads connected through Adfox.
For more information about ad blocks on Turbo pages, see Advertising.
item
*Page information.
To display Turbo pages, add the turbo="true" attribute. To disable the display of a Turbo page, set the value to false. For details, see Managing Turbo pages display.
One item element describes one page.
turbo:extendedHtml
*Activation of processing custom HTML and CSS.
Required parameter for using full set of tags. If you don't pass this parameter, some tags will be ignored.
link
*The URL of the site page to generate the Turbo page for.
- The link must contain the HTTP or HTTPS scheme prefix.
- The link domain must be the same as the source site domain.
- The maximum length of the URL is 243 ASCII characters.
- Each URL must contain one article.
When the link is clicked, the header and the beginning of the text should fit the first screen at 1024 × 768 resolution.
turbo:source
turbo:topic
The page heading that can be sent to Yandex.Metrica.
pubDate
Publication time in the RFC-822 format.
A required element for forming the automatic home page.
author
The author of the article published on the page.
metrics
Additional information about the page. Used for linking content information on the main and Turbo pages of the site.
yandex
- schema_identifier — The ID specified on the main page.
breadcrumblist
Block with headings specified on the main page of the site.
breadcrumb
- url — URL of the category/page.
- text — Name of the category/page.
yandex:related
You can post links to other resources or customize the display of the infinite scroll.
These links will be placed at the bottom of the Turbo page. To add links anywhere on the page, use Block of links to additional materials.
- In the item element of the page, add the yandex:related element with the type="infinity" attribute.
- Inside the yandex:related element add links to the pages the feed is generated from. Links must be specified using the link element with the url attribute. The tag can contain up to 240 characters of text.Example:
... <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> ...
Copied to clipboard - In the Adfox interface, go to the Parameters tab.
- In the Code type list choose <non-duplicated banners>.
turbo:content
** Required
Sending the page content
... <turbo:content> <![CDATA[ <!-- Page content --> ]]> </turbo:content> ...
Copied to clipboard
- The header is set in the header element. It can contain the title, menu and a preview image.
- The content part can contain all available Turbo page elements: text, images and videos, tables and so on. However, it must completely repeat the structure and content of the main page. For more information, see Content requirements.
... <!-- Header --> <header> <h1>Page title</h1> <figure> <img src="http://example.com/img.jpg" /> </figure> <h2>Level 2 heading</h2> <menu> <a href="http://example.com/page1.html">Link text</a> <a href="http://example.com/page2.html">Link text</a> </menu> </header> <!-- Content part --> ...
Copied to clipboard
header
*h1
*Page heading.
figure
img
h2
Level two heading.
menu
a
Menu item. The href attribute must contain the site page link.
* Required
Characters and encodings
In the export file, specify the encoding used by your server. The most commonly used encodings are: UTF-8, Windows-1251, KOI8-R.
Character | Name | Replacement code |
---|---|---|
& | Ampersand | & |
> | Right pointed bracket | > |
< | Left pointed bracket | < |
" | Inverted commas | " |
' | Apostrophe | ' |
Character | Name | Replacement code |
---|---|---|
& | Ampersand | & |
> | Right pointed bracket | > |
< | Left pointed bracket | < |
" | Inverted commas | " |
' | Apostrophe | ' |
For example, the link http://example.com/?id=1&page=10 should look like http://example.com/?id=1&page=10.
If the RSS file is passed in KOI8-R, replace the Windows-1251 characters in the text with their KOI8-R analogs:
Character | Name | Replacement code |
---|---|---|
... | Ellipsis | 133 |
– | En-dash | 150 |
— | Em-dash | 151 |
' ' | British single inverted commas | 145 and 146 |
" " | British double inverted commas (“quotation marks”) | 147 and 148 |
« » | Angle quotes (“guillemets”) | 171 and 187 |
№ | Number | 185 |
Character | Name | Replacement code |
---|---|---|
... | Ellipsis | 133 |
– | En-dash | 150 |
— | Em-dash | 151 |
' ' | British single inverted commas | 145 and 146 |
" " | British double inverted commas (“quotation marks”) | 147 and 148 |
« » | Angle quotes (“guillemets”) | 171 and 187 |
№ | Number | 185 |
RSS feed example
<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>Name of the RSS feed</title> <link>http://www.example.com/</link> <description>Short description of the RSS feed</description> <turbo:analytics type="Yandex" id="123456"></turbo:analytics> <turbo:adNetwork type="Yandex" id="block ID" turbo-ad-id="first_ad_place"></turbo:adNetwork> <turbo:adNetwork type="Adfox" turbo-ad-id="second_ad_place"> <![CDATA[ <div id="container ID"></div> <script> window.Ya.adfoxCode.create({ ownerId: 123456, containerId: 'container ID', params: { pp: 'g', ps: 'cmic', p2: 'fqem' } }); </script> ]]> </turbo:adNetwork> <item turbo="true"> <turbo:extendedHtml>true</turbo:extendedHtml> <link>http://www.example.com/page1.html</link> <author>Ivan Ivanov</author> <category>Technology</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 text</link> <link url="http://www.example.com/other-page2.html">Link text</link> </yandex:related> <turbo:content> <![CDATA[ <header> <h1>The Healthy Breakfast restaurant <h2>Healthy and delicious</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">Menu item 1</a> <a href="http://example.com/page2.html">Menu item 2</a> </menu> </header> <p>What's a good way to start the day? <del>With a Cup of invigorating coffee!</del> <ins>Delicious and healthy Breakfast! <p><b>Join</b> us for breakfast. Check out photos of our dishes <a href="#">on our website</a>.</p> <h2>Menu</h2> <figure> <img src="https://avatars.mds.yandex.net/get-sbs-sd/369181/49e3683c-ef58-4067-91f9-786222aa0e65/orig"> <figcaption>Omelette with herbs</figcaption> </figure> <p>Our menu always contains fresh, delicious and healthy options.</p> <p>Find out for yourself.</p> <button formaction="tel:+7(123)456-78-90" data-background-color="#5B97B0" data-color="white" data-primary="true">Reserve a table</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>Our address: <a href="#">Nullam dolor massa, porta a nulla in, ultricies vehicula arcu.</a></p> <section> <p><small>Photos — http://unsplash.com</small></p> ]]> </turbo:content> </item> </channel> </rss>
Copied to clipboard