Правила разметки контента в рекомендательной системе «Пульс»

Общие требования и правила

RSS с материалами для публикации в рекомендательной системе Пульс должны удовлетворять общим требованиям к RSS, доступным по адресу https://help.mail.ru/feed/rss.

Публикации должны соответствовать редакционным правилам, доступным по адресу https://help.mail.ru/feed/policy.

Для отображения полного контента публикации в системе Пульс используется содержимое элемента content:encoded, в котором содержится текст и ссылки на медиаматериалы. 

Элементы, не перечисленные в списке допустимых элементов, а также незакрытые и пустые теги могут быть удалены вместе с содержимым. Убедитесь, что публикация не содержит таких элементов, иначе целостность и читаемость публикации может быть нарушена.

Все стили и другие атрибуты внутри допустимых элементов удаляются и заменяются на стили и атрибуты страницы. Все медиаматериалы контента публикации внутри content:encoded должны быть продублированы в элементе enclosure. Медиаматериалы, не продублированные в enclosure, не будут отображены на странице публикации. 

Содержание материала в теге 

content:encoded Полный текст (минимальный объем — 1500 символов) или видеоролик. Содержит элементы для размещения медиаконтента.

Сам медиаконтент передается в теге enclosure. В content:encoded - нужно снова передать ссылки на медиаконтент, перечисленный в теге enclosure, чтобы они отобразились внутри статьи.

enclosure                         

Описание изображений, аудио- и видеофайлов в материале. Может быть единственным упоминанием медиаконтента или дублировать элементы figuremedia:content , размещаемые внутри content:encoded.

Каждому элементу figure или media:content должен соответствовать элемент enclosure в описании. Например, если в материале два изображения и один видеоролик, в описании источника разместите три элемента enclosure.

Если в материале несколько вариантов одной иллюстрации, которые отличаются только размером, укажите элемент enclosure один раз и пропишите в нем URL изображения наибольшего размера. Размер изображения должен быть не менее 310×169 пикселей. Убедитесь, что на изображении нет надписей и цифр: они могут обрезаться при загрузке.

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

Допустимые элементы разметки

Тип

Элемент

Описание

Заголовки

h1, h2, h3, h4, h5, h6

Внутри элемента может размещаться только текст и элементы <a>. При этом элемент <a> и его атрибуты будут удалены, остается только текст ссылки. 

Параграф, цитата

p, blockquote

Внутри может размещаться только текст и элементы <a>, остальные элементы будут удалены вместе с содержимым.

Список

ul, ol, li

Внутри <ul> или <ol> могут располагаться только элементы <li>, все остальные будут удалены вместе с содержимым.

Все атрибуты элементов <ul>, <ol> и <li> удаляются.

Внутри <li> допускается только текст, теги <p> и <blockquote>, заголовки и элементы <a>, остальные элементы будут удалены вместе с содержимым.

Таблица

table

Все атрибуты элемента <table> будут удалены.

Внутри элемента <table> могут размещаться только элементы <tbody>, остальные элементы будут удалены вместе с содержимым.

Внутри элемента <tbody> могут размещаться только элементы <tr>, остальные элементы будут удалены вместе с содержимым.

Все атрибуты и текст вне тегов в <tbody> и <tr> будут удалены.

Внутри <tr> могут располагаться только элементы <th> и <td>, остальные будут удалены вместе с содержимым.

Все атрибуты элементов <th> и <td> будут удалены.

Внутри <th> и <td> допускается только текст, теги <p> и <blockquote>, заголовки и элементы <a>, остальные элементы будут удалены вместе с содержимым.

Ссылка

a

Может размещаться внутри элементов: <p>, <blockquote>, <figcaption>, <li>, <th> и <td>.
Все вложенные элементы будут удалены.

Атрибут [href] валидируется при загрузке. Если URL не прошел валидацию, то ссылка будет удалена, при этом текст ссылки сохраняется.

 

Допустимые элементы для описания медиаконтента

Тип медиаконтента

Элемент

Описание

Враппер для медиа

figure

Непосредственными дочерними элементами у <figure> должны быть: один обязательный элемент, описывающий изображение или видео (<img>, <iframe> или <video>), и один опциональный элемент <figcaption> в указанном порядке. Остальные элементы будут удалены вместе с содержимым.

Изображение

img

Должен располагаться внутри <figure>.
Атрибут [src] обязателен и валидируется при загрузке. В случае, если URL не валидный, он будет удален вместе с <figure> и его содержимым.
Атрибут [alt] опционален, но если он не указан, то будет добавлен с пустым содержанием <img src="..." alt="">

Если изображение не удалось скачать (произошла ошибка, возвращает 4хх, 5хх и т.п.), то публикация не будет показана в ленте рекомендаций и не будет доступна по прямой ссылке.

Видео с Youtube или Vimeo

iframe

Должен располагаться внутри <figure>.

Пример кода для вставки:
<iframe width="560" height="315" src="https://www.youtube.com/embed/123456789" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Iframe должен быть пустым, как указано в примере.

Допустимые src: только youtube (как указано в примере) или vimeo.

Видео

video

Допустимые варианты: MPEG-4 (H.264), YouTube, Vimeo.

Подпись к медиа

figcaption

Может быть только непосредственным дочерним элементом у <figure>.

Обязательно должен следовать после элемента <img>, <video> или <iframe>.

Может содержать текст, элементы <a> и элементы <span> с атрибутом copyright (все атрибуты, кроме class="copyright" будут удалены).


Пример использования 

<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>

    <amplink>http://amp.example.com/2023/07/04/android-happy-farmer</amplink>

    <media:rating scheme="urn:simple">nonadult</media:rating>

    <pubDate>Tue, 4 Jul 2023 04:20:00 +0300</pubDate>

    <author>Петр Стругацкий</author>

    <category>Технологии</category>

    <category>Наука</category>

    <category>Дизайн</category>

    <enclosure url="http://example.com/2023/07/04/pic1.jpg" type="image/jpeg"/>

    <enclosure url="http://example.com/2023/07/04/pic2.jpg" type="image/jpeg"/>

    <enclosure url="http://example.com/2023/07/04/video/42420" type="video/x-ms-asf"/>

    <description>

        <![CDATA[

        Заброшенную землю рядом с токийским университетом передали андроиду

        с внешностью известного японского хозяйственника.

        ]]>

    </description>

    <content:encoded>

        <![CDATA[

        <p>Здесь находится полный текст статьи.</p>

        ]]>

    </content:encoded>

</item>

Was this information helpful?
https://help.mail.ru/feed/fulltext
help.mail.ru
crawl=CC-MAIN-2022-49
135783
application/http; msgtype=response
sha1:TPA4GJMXNJI45QBQEAYQUCIDQPFE5F5S
<urn:uuid:124c4456-b3d3-428d-9c39-4c79d8950d49>
2022-12-01T10:08:33Z
217.69.129.214
text/html
sha1:VPYZ36ZE6RILRKVN6IL3VRSK742K3J5J
<urn:uuid:dcaa1dd4-a25b-41f7-b5c6-ce92233a4855>
https://help.mail.ru/feed/fulltext
response
<urn:uuid:b4e40dc7-3ae0-4358-91e3-ec60222c024c>
isPartOf: CC-MAIN-2022-49
publisher: Common Crawl
description: Wide crawl of the web for November/December 2022
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-146
software: Apache Nutch 1.19 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.4-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/