Редактирование: Jabber RSS Transport

'''Jabber RSS Transport''' - одна из возможностей читать новости в Jabber'e через [[ru_wikipedia:RSS|RSS]], что позволяет не использовать отдельную программу, а получать их напрямую в вашем любимом [[Клиенты Jabber|Jabber-клиенте]].

Помимо описанного в данной статье [[Транспорт|транспорта]], существуют также [[JID полезных Jabber-ботов|специальные боты]] с подобной функцией. Такой бот является отдельным контактом в [[Ростер|ростере]] и все уведомления от подписанных лент идут через него одного. Это может быть нормальным в случае подписки на ленты с редким обновлением (например, информация о выпусках программ), однако может быть неудобным для использования с активными лентами, где за сутки приходят десятки, а то и сотни сообщений - в таком случае можно просто "потеряться" среди всех этих уведомлений и пропускать важные сообщения от отдельных лент.

Использование транспорта в данном случае выгодно отличается от такого бота: каждой ленте в ростере соответствует отдельный контакт, у него может быть свой интервал обновления и свои "правила" - например, для менее важных лент в Jabber-клиенте можно отключить уведомления, чтобы почитать их потом на досуге, зато при этом не будут пропущены уведомления от более важных лент. Фактически, транспорт выступает "конструктором ботов".

== Возможности и особенности ==

* Работа с любым типом лент, которые поддерживает [https://pypi.org/project/feedparser/ Feedparser]
* Настраиваемый интервал обновления при регистрации ленты.
* Лентам при регистрации можно присвоить метки-теги; в дальнейшем в [[Браузер сервисов|браузере сервисов]] можно вывести список зарегистрированных лент для данного тега.
* При регистрации ленту можно сделать "Приватной" - в таком случае она будет видна в поиске и в браузере сервисов только ее владельцу.
* Название ленты, описание и теги могут использовать кириллицу.
* В адаптивном режиме период обновления ленты подстраивается под частоту идущих от нее сообщений: нет необходимости ставить частое обновление (1-2 минуты) для ленты, где только изредка начинается какая-то активность.
* В [[Пользовательские статусы|статусе]] и в [[vCard]] ленты выводится статистика по числу сообщений в час и в сутки, а также время следующего обновления и текущий интервал в адаптивном режиме.
* Статус ленты устанавливается в зависимости от приходящих сообщений: "Готов поболтать" для тех, где было хотя бы одно сообщение за последний час, "Онлайн" - где было сообщение за сутки, "Отошел" - если сообщений не было и "Недоступен" - если есть проблемы с получением содержимого ленты.
* Управление некоторыми функциями с помощью команд любой ленте или напрямую транспорту (для получения списка команд введите '''help''').
* Возможность фильтрации сообщений по белым и черным спискам.
* Возможность ограничивать размер сообщения для каждой ленты в отдельности.
* Архив новостей с возможностью поиска - можно повторно получить последнее содержимое ленты, послав ей желаемое число новостей (от 1 до 9).

== Использование ==

Использование рассмотрим на примере одного из [[Список публичных транспортов RSS|публичных RSS-транспортов]]. Есть несколько вариантов подписаться на ленту через транспорт:
* Воспользоваться функцией поиска в транспорте. Поиск можно делать по названию ленты, ее описанию либо тегам.
* Открыть список зарегистрированных лент в [[Браузер сервисов|браузере сервисов]] и выбрать нужную.
* Зарегистрировать свою ленту.

Рассмотрим эти варианты подробнее.

=== Поиск ===

Для поиска RSS-ленты откройте "'''Браузер сервисов'''" в вашем Jabber-клиенте, найдите RSS-транспорт и в контекстном меню транспорта выберите пункт "'''Найти'''". В строке для поиска задайте ключевое слово и нажмите "'''Поиск'''". В таблице результатов транспорт выдаст список лент, подходящих под данное ключевое слово. Выберите подходящую, нажмите кнопку "'''Добавить контакт'''", после чего примите запрос [[Подписка|подписки]]. Через время добавленный бот пришлет вам первые новости!

<center>
<gallery>
Файл:Rss search 01.png|Выбираем поиск
Файл:Rss search 02.png|Ищем и добавляем ленту
Файл:Rss news from feed 01.png|Читаем новости!
</gallery>
</center>

=== Просмотр через браузер сервисов ===

В случае, если вы не знаете, что конкретно хотели бы найти и просто хотите посмотреть, что читают другие - воспользуйтесь '''[[Браузер сервисов|браузером сервисов]]''' для просмотра всех зарегистрированных лент. Доступно несколько разделов:
* Все ленты
* Те, которые регистрировал пользователь
* Приватные ленты пользователя
* Ленты по категориям (те, для которых указывались теги при регистрации ленты)

Как и в случае с поиском, для найденной ленты нажимаем кнопку "'''Добавить в ростер'''", после чего обмениваемся подпиской. Предварительно можно ознакомиться с визитной карточкой ленты, нажав кнопку '''vCard'''.

<center>
<gallery>
Файл:Rss disco 01.png|Исследуем теги лент
Файл:Rss disco add.png|Добавляем ленту
Файл:Rss vcard 01.png|Визитка ленты, общая информация
Файл:Rss vcard 02.png|Визитка ленты, описание
</gallery>
</center>

=== Регистрация своей ленты ===

Если ни один из перечисленных выше способов не подошел - всегда можно зарегистрировать свою ленту (если, конечно, это разрешено администратором сервера). Для примера - зарегистрируем новостную ленту с сайта '''https://lifehacker.ru'''. Скопируем адрес ленты из веб-браузера - приличные сайты публикуют адреса лент где-нибудь в разделе подписок, а приличные браузеры отображают специальную иконку возле адресной строки.

Открываем браузер сервисов, выбираем пункт "'''Зарегистрироваться'''". Появляется диалоговое окно, где необходимо ввести название ленты (она станет именем пользователя в [[JID]]'е создаваемого бота, поэтому не допускаются пробелы и символы @</\>:"'&); адрес ленты - в нашем случае это будет '''https://lifehacker.ru/feed/''', а также описание. При желании можно добавить теги, выбрать нужный интервал обновления или сделать ленту приватной. Также можно отключить немедленную подписку на ленту, если по каким-то причинам вы хотите сделать это позже. Если вы не пытаетесь зарегистрировать существующую ленту, а ее содержимое сейчас доступно транспорту - вы получите сообщение об успешной регистрации. Обменяйтесь с созданным ботом подпиской и уже скоро вы получите первые новости!

<center>
<gallery perrow=6>
Файл:Rss register 01.png|Находим ленту
Файл:Rss register 02.png|Открываем регистрацию в транспорте
Файл:Rss register 03.png|Вводим данные
Файл:Rss register 04.png|Лента добавлена
Файл:Rss register 05.png|Авторизуем
Файл:Rss register 06.png|Читаем новости!
</gallery>
</center>

== Ссылки ==

* [[Список публичных транспортов RSS]]
* [[JRD:Rss.jrudevels.org|Описание первой версии транспорта на JaWiki]]
* [[JRD:RSS service|Описание RSS-транспортов на JaWiki]]
* [https://github.com/jabberworld/jrd_rss Страница проекта на github]

[[Category:Транспорт]]