Для импорта в Рамблер/новости вам нужно создать новостной поток — в терминологии системы — фид. Новости, статьи и заметки в фиде для успешного импорта в Рамблер/новости должны иметь вид XML-документа, оформленного в соответствии с правилами формата RSS 2.0.
Общие требования
Фид должен начинаться с объявления формата XML с обязательным
указанием кодировки текста:
<?xml version="1.0" encoding="utf-8"?> В ответе в
заголовках сервера для параметра "Content-Type" должно быть
указано значение "application/rss+xml; charset=utf-8".
В фиде не должно быть ошибок XML-кода — проверьте его, открыв в обоих браузерах Google Chrome и Mozilla FireFox. Каждая новость на сайте источника должна иметь постоянный уникальный адрес, чтобы переходе на публикацию по ссылке из фида всегда открывалась именно эта новость.
Описание тегов для оформления RSS-фида
Посмотрите на пример оформления XML-кода в файле фида, чтобы понять, какие теги и атрибуты обязательно нужно добавить и какую информацию они должны содержать.
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:rambler="http://news.rambler.ru" version="2.0">
<channel>
<title>Название канала</title>
<link>https://example.com</link>
<description>Краткое описание канала</description>
<item>
<title>Заголовок новости</title>
<pubDate>Tue, 19 Jan 2038 03:14:07 +0000</pubDate>
<guid>a124381d-65ef-4ef9-b8ab-e2b384095497</guid>
<link>https://example.com/tech/1234561</link>
<enclosure url="https://news.store.rambler.ru/img/940b519c35a4aae222ed15a92525de37" type="image/jpeg"/>
<author>Петр Стругацкий</author>
<category>Гороскопы</category>
<description>Гороскоп на неделю 18-24 января 2038 года для каждого знака</description>
<content><![CDATA[<p>Текст публикации</p>]]></content>
</item>
</channel>
</rss>| Тег 1 уровня | Тег 2 уровня | Тег 3 уровня | Описание |
|---|---|---|---|
channel* | Тег открывает группу с информацией о сайте-источнике | ||
title* | Название RSS-канала или название сайта | ||
link* | Адрес вашего сайта, откуда транслируются новости (не ссылка на новость) | ||
description | Описание вашего новостного канала, которое увидят читатели | ||
item* | Новостная публикация | ||
title* | Заголовок новости | ||
link* | Ссылка на новость на сайте | ||
guid | Уникальный идентификатор публикации в фиде. | ||
content* | Содержимое новости | ||
pubDate | Время публикации новости, указывается строго в формате RFC-2822 | ||
author | Автор статьи | ||
category | Категория или рубрика новости | ||
description | Аннотация или краткое описание новости | ||
enclosure | Элемент для передачи мультимедийных элементов. |
* - обязательный элемент/атрибут
Необходимо экранировать символы во
всех элементах фида, кроме содержимого <![CDATA[]]>.
| Символ | Экранирование | Название |
|---|---|---|
& | & | Амперсанд |
> | > | Правая угловая скобка |
< | < | Левая угловая скобка |
" | " | Двойная кавычка |
' | ' | Апостроф (или одинарная кавычка) |
Мультимедийные элементы
В фиде могут присутствовать элементы, описывающие мультимедиа контент для всей публикации. К такому контенту относится изображения для публикации(заглавное изображение новости).
<enclosure url="https://news.store.rambler.ru/img/9c4d95419ed9dbed3677537d064f88e1" type="image/jpeg"/>При обнаружении тегов enclosure с установленным type=“image/…”
ссылка, находящаяся внутри параметра url считается прямой ссылкой на
изображение. Элемент регистрируется, как мультимедийный, ссылка на
изображение берется из атрибута url.
Поддерживаются следующие форматы - PNG, JPG, WEBP, AVIF, PJPEG, максимальный размер изображения - 5Мбайт.
Содержимое новости
Текст публикации находится в элементе content или
full-text. Дополнительно текст новости нужно поместить в
блок <![CDATA[]]>,
как на примере ниже. Если же один из этих элементов находится в
именованной группе, нужно указать соответствующую запись в пространстве имен.
<content>
<![CDATA[<!-- News item body -->]]>
<content>При оформлении новости можно использовать следующие теги.
| Элемент | Описание |
|---|---|
<p> | Оформление выбранного текста в параграф |
<a> | Ссылки в тексте новости |
<h1> | Заголовок страницы |
<h2> | Заголовок второго уровня (для оформления разделов в длинной публикации) |
<blockquote> | Тег для оформления цитаты |
<figure> | Тег для вставки фото или видео |
Новостные роботы всех проектов Рамблера при сканировании содержимого новости выше. Любые другие теги в содержимом новости будут проигнорированы.
Разметка на параграфы
Чтобы разделить длинный текст на удобные для чтения параграфы,
поместите текст параграфа внутрь парного тега
<p></p>. Например:
<p>
Первый параграф.
</p>
<p>
Второй параграф.
Это тоже второй параграф.
</p>
<p>
Третий параграф.
</p>Для оформления прямой речи можно перейти на новую строку. При этом новая строфа.
<p>
Тут ударила мне кровь в голову.
— Ложи, — говорю, — взад!
А она испужалась. Открыла рот, а во рте зуб блестит.
</p>Два и более перевода строки подряд, а также пробелы в начале и конце параграфа игнорируются.
Ссылки в тексте
Для добавления ссылок в текст новости используйте тег a.
Например:
<a href="https://news.rambler.ru">Rambler/News</a>где атрибут href - абсолютный URL. Другие атрибуты в
парсинге не участвуют.
Цитаты в тексте
Для оформления цитаты поместите её текст в тег
blockquote.
<blockquote>
<p>For a surfer, it's never-ending. There's always some wave you want to surf.<p>
</blockquote>Картинки
Чтобы разместить картинку, используйте элементы figure и
img, где
| Тег | Атрибут | Описание |
|---|---|---|
figure* | Тег содержащий картинку | |
img* | src* | Абсолютный URL до изображения |
alt | Описание изображения | |
figcaption | Текст подписи |
* - обязательный элемент/атрибут
<figure>
<img src="https://news.store.rambler.ru/img/c603a51a6ee23b197ae619217838ab0b" alt="Technodrome"/>
</figure>Чтобы разместить изображение с подписью под ним, в теге
figcaption напишите текст подписи.
<figure>
<img src="https://news.store.rambler.ru/img/2d2aaf3861a806c3fc52591dd9fe7248"/>
<figcaption>Nikolaus Kopernikus</figcaption>
</figure>Поддерживаются изображения формата - PNG, JPG, WEBP, AVIF, PJPEG.
Видео
Чтобы разместить видео, используйте элементы figure,
video, source img и
figcaption, где
| Тег | Атрибут | Описание |
|---|---|---|
video* | width | Ширина видео |
height | Высота видео | |
source* | src* | Абсолютный URL до видео |
type | Формат видео | |
img | src* | Ссылка на изображение-превью |
figcaption | Текст подписи |
* - обязательный элемент/атрибут
<figure>
<video width="192" height="108">
<source
src="https://vp.rambler.ru/player/embed.html?widget=Player&id=2022751"
type="video/mp4"/>
</video>
<img src="https://news.store.rambler.ru/img/ed6743019ffa3c22e3427f3d842ba185"/>
<figcaption>Лихач на электросамокате обогнал автомобили на проезжей части и попал на видео</figcaption>
</figure>Пример оформления фида RSS
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:rambler="http://news.rambler.ru" version="2.0">
<channel>
<title>Название вашего сайта</title>
<link>http://www.site.ru/</link>
<description>Краткое описание вашего сайта</description>
<item>
<guid>30c2a02c-592b-4c0e-a852-871d8891921c</guid>
<title>Саммит технологического развития</title>
<link>http://www.site.ru/news/123456/</link>
<pubDate>Tue, 09 Jan 2007 09:41:00 -0700</pubDate>
<description>В Москве на улице Пятницкой прошел саммит технологического развития</description>
<category>Экономика</category>
<content><![CDATA[
<p>На форуме Алексеем Мозолевым была презентована новая версия программы «Фракции» для работы на рынке ценных бумаг.
Новая версия программы для работы с ценными бумагами «Фракция» стала доступна для скачивания на сайте компании.</p>
<figure>
<img src="https://news.store.rambler.ru/img/edac4335cc49ea0f6257abba63d5a17b"/>
</figure>
<p>В ней был обновлен дизайн и добавлены новые функции. Кроме того, теперь программа доступна на мобильных устройствах.
Также на форуме были представлены новые продукты компании: «Фракцион-инвестинг» и «Фракционный портфель».</p>
<blockquote>
<p>Мы с Алексеем знакомы уже давно. Это очень хороший специалист, который занимается развитием новых технологий в России.
И я рад, что он приехал на наш форум. Думаю, мы будем сотрудничать с ним в дальнейшем.</p>
</blockquote>
<p>отметил один из соучередителей компании «Hitbox».</p>
]]></content>
<author>Андрей Марков</author>
</item>
<item>
<guid>e86cceb2-6c48-4a31-8c46-c6ce9717b484</guid>
<title>Как укаживать за фикусами?</title>
<link>http://www.site.ru/news/123457/</link>
<pubDate>Mon, 09 Feb 2009 12:00:21 +0300</pubDate>
<description>Один из агрономов дала свой комментарий по поводу ухода за фикусами</description>
<category>Садоводство</category>
<content><![CDATA[
<p>Фикус как комнатное растение используется в цветоводстве с незапамятных времен. В настоящее время в наших квартирах
можно встретить сотни разновидностей этого растения. На самом деле фикусы неприхотливы и просты в уходе,
главное - это знать особенности его содержания.
Как говорит Ольга Бетельгейзова, <a href="https://en.wikipedia.org/wiki/Ficus_benjamina">фикус Бенджамина</a> - этот вид фикуса является
самым распространенным. Его можно увидеть в каждом доме и на каждом подоконнике. Он прекрасно себя чувствует в домашней среде,
но его нужно ежедневно поливать, иначе он может погибнуть. Это растение очень любит тепло, поэтому летом его рекомендуется
ставить на южном окне. Главное не открывать окно - в противном случае любое дуновение холодного воздуха навредит и все
фикусы могут заболеть. Чтобы фикус был здоровым и красивым, нужно правильно за ним ухаживать.</p>
]]></content>
<author>Орина Абрикосова</author>
<enclosure url="https://news.store.rambler.ru/img/86f898372b5f8d87892e71a36fc13fdf" type="image/jpeg"/>
<enclosure url="https://news.store.rambler.ru/img/d8d305c904ef4e85568c1a8e58d8bd10" type="image/jpeg"/>
</item>
<item>
<guid>184720b6-ea4e-4f5b-939b-bdb67228cb83</guid>
<title>Ученый-исследователь из Владимира сделал открытие</title>
<link>http://www.site.ru/news/123458/</link>
<pubDate>Fri, 27 Feb 2009 12:03:25 +0300</pubDate>
<description>Ученый-исследователь из Владимира сделал открытие</description>
<category>Наука</category>
<full-text><![CDATA[
<p>Ученый-исследователь кафедры органической химии Владимирского государственного университета (ВлГУ) Максим Вайтмусташев
совместно с коллегами из Московского авиационного института открыл новое взаимодействие, которое может стать основой для создания
новых лекарственных препаратов. Открытие относится к области химии высокомолекулярных соединений, а именно к взаимодействию
между мономерными звеньями и разветвленными функциональными группами. Это взаимодействие происходит при получении нанокристаллических
порошков, которые могут быть использованы в качестве нанопорошков в различных областях науки и техники.
В результате взаимодействия происходит образование новых химических связей, что приводит к изменению физических свойств вещества.</p>
<blockquote>
<p>В качестве исходного вещества используется сложный эфир, который в присутствии катализатора реагирует со спиртом.
В результате получается новое соединение, обладающее рядом полезных свойств. Например, этот эфир может выступать
в роли блокатора рецепторов, ответственных за боль. В настоящее время в России нет лекарств, которые бы обладали
избирательным воздействием на миелопероксидазу - фермент, участвующий в процессах перекисного окисления липидов и
отвечающий за возникновение так называемой оксидативной (окислительной) модификации белков.</p>
</blockquote>
<p>сообщил ученый.</p>
]]></full-text>
</item>
</channel>
</rss>