Разметка и подключение ленты RSS

Чтобы материалы с вашего сайта корректно отображались в ленте рекомендаций, вам нужно разметить ленту RSS и добавить туда специальные теги.

Требования и рекомендации

Примечание. RSS-лента, подготовленная для сервисов Турбо и Новости на Дзене, для Дзена не подойдет. В Дзене другой набор обязательных атрибутов и другие требования к размеру иллюстраций.

Требования к контенту

Все публикации в RSS-ленте должны соответствовать требованиям Дзена. Мы также просим издателей размечать материалы специальными элементами. Технические подробности — в разделе Описание материала.

Технические требования

Для разметки содержимого статей используйте только HTML, который указан в настоящих рекомендациях к RSS — это гарантирует корректное отображение материалов на платформе.
При первой разметке лента должна содержать минимум 10 материалов. При этом на сайте должно быть размещено не менее 3 публикаций за последний месяц.
Если ваша публикация содержит картинки, для их добавления используйте элементы img и figure. Минимальная ширина картинки — 700 пикселей. Для наилучшего отображения в ленте присылайте изображения большого размера. В формате статей для обложки публикации используйте элемент enclosure.
URL материалов должен быть ЧПУ (человеко-понятным), без UTM-меток и других параметров.
Откройте роботу доступ к материалам, чтобы они показывались в RSS-ленте. Убедитесь, что в текстовом файле robots.txt адрес RSS не запрещен директивой Disallow, или явно разрешите его директивой Allow RSS_URL.
Пример:
```
# Если в robots.txt
прописана директива Disallow /feed # то робот не проиндексирует страницу
your-site.ru/feed/some_url/rss.xml # Чтобы разрешить индексацию, добавьте директиву Allow
/feed/some_url/rss.xml 
```

Ограничения

Все параметры, предназначенные для дополнительного оформления и сложной вёрстки, не обрабатываются. Для корректного отображения вашего контента на платформе советуем придерживаться набора элементов, указанного в таблицах ниже.
Обрабатываются только изображения: видео и другой медиаконтент обработаны не будут и не попадут на платформу. Вы можете загрузить материал на платформу как черновик и добавить видео и другой контент вручную. Подробнее о том, как это сделать при помощи элемента category — в таблице ниже.

Пример разметки видео, который мы не обрабатываем

<figure> <video width="1200" height="900"> <source
src="http://example.com/42420" type="video/mp4"> </video> <figcaption>
Андроид-фермер вспахивает землю при помощи собственного изобретения <span
class="copyright">Михаил Родченков</span> </figcaption>
</figure>

Пример формата изображений и видео, который мы не принимаем

<media:content type="image/jpeg" medium="image" width="900" height="300"
url="http://example.com/2023/07/04/pic1.jpg"> <media:description type="plain">
Андроид-фермер смотрит на свои угодья </media:description>
<media:copyright>Михаил Родченков</media:copyright>
</media:content>

Описание материала

Набор элементов, описывающих материал, располагается внутри элемента item. Обязательные элементы отмечены значком .


Элемент	Описание
`title`	Заголовок. Это тег обязателен, но игнорируется при конвертации материала в пост. Если вы хотите, чтобы заголовок отображался в посте, продублируйте его внутри элемента `content:encoded`.
`category`	Способ публикации Выберите способ размещения материала на платформе. Если этого не сделать, материал будет автоматически опубликован и сразу появится на канале. `native-draft` — материал сохранится на платформе в качестве черновика. Вы можете отредактировать черновик по своему усмотрению и опубликовать. Для материалов, отправленных в `native-draft`, не действует время публикации из `pubDate`, т. к. материал находится в черновике. Тип публикации Выберите тип публикации: `format-article` — статья или `format-post` — пост. Если вы выберете `format-post`, но в нём будет больше 4000 символов и больше 10 картинок, публикация будет преобразована в статью. Если не выбрать формат, конвертация произойдет автоматически. Особенности конвертации: Меньше 800 символов и нет картинок — конвертация в пост. Меньше 600 символов и до 10 картинок — конвертация в пост. Материал содержит код вставки или эмбед — конвертация в статью. Во всех остальных случаях материал будет автоматически опубликован как статья. Индексация материала, созданного на платформе `index` — материал индексируется в поисковых системах. `noindex` — материал не индексируется в поисковых системах. Способ комментирования `comment-all` — комментировать могут все пользователи. `comment-subscribers` — комментировать могут только подписчики. `comment-none` — комментарии закрыты для всех. Отключение рекламы `advertisement-off` — реклама в публикации показываться не будет. Нативная реклама `native_ads` — пометка о том, что в публикации есть нативная реклама.
`guid`	Уникальный идентификатор статьи. Если вы хотите отредактировать уже отправленную статью или повторно отправить статью в ленту RSS, укажите её изначальный `guid` или URL, чтобы не создавать дубликаты.
`pubDate`	Дата и время публикации в формате RFC822: Wed, 02 Oct 2002 15:00:00 +0300. Вы можете запланировать время публикации материала: для этого укажите нужную дату и время. Минимальное время для отложенной публикации — 1 час. Дата публикации не будет работать для материалов, отправленных в черновики.
`enclosure`	Описание изображения, которое будет на обложке статьи. Может быть как единственным упоминанием медиаконтента, так и дублировать элементы `figure` или `img`, размещаемые внутри `content:encoded`. Если вы опубликовали контент в формате поста, и картинок в элементах `figure` или `img` нет, но картинки есть в элементе `enclosure`, они опубликуются в посте как обычные изображения (до 10 штук). Для лучшего отображения на карточке в ленте рекомендации рекомендуем присылать URL изображения наибольшего размера. Минимальная ширина изображения — 700 пикселей.
`content:encoded`	Полный текст (рекомендуемый объём — не менее 300 знаков с пробелами). Содержит элементы для размещения медиаконтента. Внимание. Материалы из RSS-ленты, не размеченные по этим критериям, могут не попадать в Дзен, либо отображаться на платформе некорректно. Параметры, которые поддерживаются внутри этого элемента `p` — абзац; `a` — ссылки; `b` — жирный; `i` — курсив; `u` — подчеркивание; `s` — зачеркивание; `h1, h2, h3, h4` — заголовки; `blockquote` — цитата; `<ul><li>`— маркированный список (внутри списка не поддерживается другое форматирование); `<ol><li>` — нумерованный список (внутри списка не поддерживается другое форматирование); `h1`, `h2` — заголовки первого уровня; `h3`, `h4` — заголовки второго уровня; В текст можно добавить оглавление: для этого заголовку `h2`, `h3` или `h4` присвойте идентификатор `id`. Пример оглавления с якорем `<h2 id="neravnoznachne_po_smsly">Неравнозначные по смыслу</h2>` Пример ссылки на якорь `<a href="#neravnoznachne_po_smsly">Неравнозначные по смыслу</a>` Элемент `content:encoded` поддерживает коды вставки разных платформ и соцсетей. Примеры таких вставок: YouTube `<iframe width="560" height="315" src="https://www.youtube.com/embed/CD9BIkXwR1U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>` Яндекс Музыка `<iframe frameborder="0" style="border:none;width:100%;height:450px;" width="100%" height="450" src="https://music.yandex.ru/iframe/#album/13233340">Слушайте <a href='https://music.yandex.ru/album/13233340'>Страдающее Средневековье</a> на Яндекс.Музыке</iframe>` Ссылка на сервисы, не оформленная как код вставки, также превратится в виджет. Чтобы добавить публикацию в виде виджета, необязательно копировать и добавлять код вставки — RSS-лента автоматически превращает в виджет следующие ссылки: Видео Дзена Яндекс Музыка Youtube Внимание. В формате постов поддерживается форматирование только гиперссылок и списков. Другое форматирование в постах не поддерживается.
`link`	URL статьи, данные которой транслируются в ленте RSS.
`pdalink`	Ссылка на версию, адаптированную для мобильных устройств.
`description`	Описание статьи, которое будет отображаться в карточке материала в ленте.


Элемент	Описание
`title`	Заголовок. Это тег обязателен, но игнорируется при конвертации материала в пост. Если вы хотите, чтобы заголовок отображался в посте, продублируйте его внутри элемента `content:encoded`.
`category`	Способ публикации Выберите способ размещения материала на платформе. Если этого не сделать, материал будет автоматически опубликован и сразу появится на канале. `native-draft` — материал сохранится на платформе в качестве черновика. Вы можете отредактировать черновик по своему усмотрению и опубликовать. Для материалов, отправленных в `native-draft`, не действует время публикации из `pubDate`, т. к. материал находится в черновике. Тип публикации Выберите тип публикации: `format-article` — статья или `format-post` — пост. Если вы выберете `format-post`, но в нём будет больше 4000 символов и больше 10 картинок, публикация будет преобразована в статью. Если не выбрать формат, конвертация произойдет автоматически. Особенности конвертации: Меньше 800 символов и нет картинок — конвертация в пост. Меньше 600 символов и до 10 картинок — конвертация в пост. Материал содержит код вставки или эмбед — конвертация в статью. Во всех остальных случаях материал будет автоматически опубликован как статья. Индексация материала, созданного на платформе `index` — материал индексируется в поисковых системах. `noindex` — материал не индексируется в поисковых системах. Способ комментирования `comment-all` — комментировать могут все пользователи. `comment-subscribers` — комментировать могут только подписчики. `comment-none` — комментарии закрыты для всех. Отключение рекламы `advertisement-off` — реклама в публикации показываться не будет. Нативная реклама `native_ads` — пометка о том, что в публикации есть нативная реклама.
`guid`	Уникальный идентификатор статьи. Если вы хотите отредактировать уже отправленную статью или повторно отправить статью в ленту RSS, укажите её изначальный `guid` или URL, чтобы не создавать дубликаты.
`pubDate`	Дата и время публикации в формате RFC822: Wed, 02 Oct 2002 15:00:00 +0300. Вы можете запланировать время публикации материала: для этого укажите нужную дату и время. Минимальное время для отложенной публикации — 1 час. Дата публикации не будет работать для материалов, отправленных в черновики.
`enclosure`	Описание изображения, которое будет на обложке статьи. Может быть как единственным упоминанием медиаконтента, так и дублировать элементы `figure` или `img`, размещаемые внутри `content:encoded`. Если вы опубликовали контент в формате поста, и картинок в элементах `figure` или `img` нет, но картинки есть в элементе `enclosure`, они опубликуются в посте как обычные изображения (до 10 штук). Для лучшего отображения на карточке в ленте рекомендации рекомендуем присылать URL изображения наибольшего размера. Минимальная ширина изображения — 700 пикселей.
`content:encoded`	Полный текст (рекомендуемый объём — не менее 300 знаков с пробелами). Содержит элементы для размещения медиаконтента. Внимание. Материалы из RSS-ленты, не размеченные по этим критериям, могут не попадать в Дзен, либо отображаться на платформе некорректно. Параметры, которые поддерживаются внутри этого элемента `p` — абзац; `a` — ссылки; `b` — жирный; `i` — курсив; `u` — подчеркивание; `s` — зачеркивание; `h1, h2, h3, h4` — заголовки; `blockquote` — цитата; `<ul><li>`— маркированный список (внутри списка не поддерживается другое форматирование); `<ol><li>` — нумерованный список (внутри списка не поддерживается другое форматирование); `h1`, `h2` — заголовки первого уровня; `h3`, `h4` — заголовки второго уровня; В текст можно добавить оглавление: для этого заголовку `h2`, `h3` или `h4` присвойте идентификатор `id`. Пример оглавления с якорем `<h2 id="neravnoznachne_po_smsly">Неравнозначные по смыслу</h2>` Пример ссылки на якорь `<a href="#neravnoznachne_po_smsly">Неравнозначные по смыслу</a>` Элемент `content:encoded` поддерживает коды вставки разных платформ и соцсетей. Примеры таких вставок: YouTube `<iframe width="560" height="315" src="https://www.youtube.com/embed/CD9BIkXwR1U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>` Яндекс Музыка `<iframe frameborder="0" style="border:none;width:100%;height:450px;" width="100%" height="450" src="https://music.yandex.ru/iframe/#album/13233340">Слушайте <a href='https://music.yandex.ru/album/13233340'>Страдающее Средневековье</a> на Яндекс.Музыке</iframe>` Ссылка на сервисы, не оформленная как код вставки, также превратится в виджет. Чтобы добавить публикацию в виде виджета, необязательно копировать и добавлять код вставки — RSS-лента автоматически превращает в виджет следующие ссылки: Видео Дзена Яндекс Музыка Youtube Внимание. В формате постов поддерживается форматирование только гиперссылок и списков. Другое форматирование в постах не поддерживается.
`link`	URL статьи, данные которой транслируются в ленте RSS.
`pdalink`	Ссылка на версию, адаптированную для мобильных устройств.
`description`	Описание статьи, которое будет отображаться в карточке материала в ленте.

Описание изображений

Элементы, описывающие медиаконтент, располагаются внутри элемента content:encoded. Обязательные элементы отмечены значком

Внимание. Для изображений выбирайте файлы в формате JPEG, GIF или PNG. Первое изображение, размеченное этим элементом, появится на карточке в ленте Дзена. Для лучшего отображения на карточке в ленте рекомендаций желательно присылать URL изображения наибольшего размера. Минимальная ширина изображения — 700 пикселей. Если изображение пришло в некорректном формате, публикация отправится в черновики — там вы сможете вручную вставить подходящую картинку.


Элемент	Описание
`figure`	Используйте этот элемент, особенно если добавляете несколько изображений подряд — это гарантирует корректное отображение картинок в материале. `<figure> <img src="http://example.com/pic1.jpg"> <figcaption> Первый андроид-фермер смотрит на свои угодья </figcaption> </figure>`
`img`	`<img src="http://example.com/pic1.jpg">`


Элемент	Описание
`figure`	Используйте этот элемент, особенно если добавляете несколько изображений подряд — это гарантирует корректное отображение картинок в материале. `<figure> <img src="http://example.com/pic1.jpg"> <figcaption> Первый андроид-фермер смотрит на свои угодья </figcaption> </figure>`
`img`	`<img src="http://example.com/pic1.jpg">`

Пример размеченной ленты

<?xml version="1.0" encoding="UTF-8"?> <rss
version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"
xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/"
xmlns:atom="http://www.w3.org/2005/Atom" xmlns:georss="http://www.georss.org/georss">
<channel> <title>Пастернак</title>
<link>http://example.com/</link> <language>ru</language>
<item> <title>Андроид восстановит ферму в Японии</title>
<link>http://example.com/2023/07/04/android-happy-farmer</link>
<pdalink>http://m.example.com/2023/07/04/android-happy-farmer</pdalink>
<guid>2fd4e1c67a2d28fced849ee1bb76e7391b93eb12</guid> <pubDate>Tue, 4
Jul 2023 04:20:00 +0300</pubDate> <media:rating
scheme="urn:simple">nonadult</media:rating>
<category>native-yes</category> <enclosure
url="http://example.com/2023/07/04/big_pic1.jpg" type="image/jpeg"/>
<content:encoded> <![CDATA[<p>Здесь находится полный текст статьи. Его
могут прерывать картинки.</p> <figure> <img
src="http://example.com/2023/07/04/big_pic1.jpg"> <figcaption> Первый
андроид-фермер смотрит на свои угодья <span class="copyright">Михаил
Родченков</span> </figcaption> </figure> <p>Продолжение статьи
после вставленной картинки. В статье рассказывается о&nbsp;<a
href="https://ru.wikipedia.org/wiki/Вспашка">технологии вспахивания земли</a>,
которую использует японский андроид-фермер.</p> <p>Что фермеры используют для
работы:<br/> <ul> <li><i>тяпки</i>;</li>
<li><b>грабли</b>;</li>
<li><u>велосипеды</u>;</li>
<li><s>плуги</s>;</li> </p> <p>Статья продолжается.
Андроид копает картошку. Фермы развиваются. Япония продолжает удивлять.</p>]]>
</content:encoded> </item> </channel> </rss>