Специфікація RSS 2

1. Що таке RSS?

На вищому рівні документ RSS є елементом з обов'язковим атрибутом version, що вказує версію RSS. Якщо документ відповідає цій специфікації, значення цього атрибуту має бути "2.0". Дочірній елемент — один елемент , який включає інформацію про канал (метадані) та його вміст.

2. Приклади файлів

З сайту RSS Board доступні приклади файлів для RSS 0.91, 0.92 та 2.0.

Зазначимо, що приклади файлів можуть вказувати на документи та послуги, які більше не існують.

3. Про цей документ

Цей документ надає статус RSS на кінець 2002 року - версію 2.0.1.

Для початку ми опишемо обов'язкові та необов'язкові дочірні елементи, далі дочірні елементи. Завершальні розділи відповідають на поширені питання, розповідають про плани на наступні версії та дають рекомендації щодо розширення RSS.

4. Елементи каналу

Обов'язкові елементи каналу

Необов'язкові елементи каналу

— дочірній елемент, що містить три обов'язкові та три додаткові елементи.

URL зображення GIF, JPEG або PNG, що представляє канал. Опис зображення, яке буде використано в атрибуті alt елементу HTML img, коли канал буде показаний у гіпертексті.

  • URL сайту; зображення каналу слугуватиме посиланням на цей сайт. (Як правило, і
  • зображення повинні збігатися з і
  • каналу.

    • Необов'язкові елементи — і , що задають ширину та висоту зображення у пікселях. містить текст, що включається до атрибуту title посилання, сформованого навколо зображення в HTML-відображенні.

    Максимальна ширина – 144, за замовчуванням – 88.

    Максимальна висота – 400, за замовчуванням – 31.

    вказує веб-сервіс,підтримуючий інтерфейс rssCloud, який може бути реалізований через HTTP-POST, XML-RPC або SOAP 1.1 і реалізує підписку на оновлення каналу.

    У цьому прикладі для запиту сповіщення потрібно надіслати повідомлення XML-RPC на rpc.sys.com, порт 80, шлях /RPC2. Ця процедура — myCloud.rssPleaseNotify.

    Повне пояснення цього елемента та інтерфейсу rssCloud: http://www.rssboard.org/rsscloud-interface.

    ttl вказує кількість хвилин, на які канал може кешуватись до наступного оновлення з джерела. Це дозволяє ресурсам RSS керуватися мережами файлообміну типу Gnutella.

    Елемент каналу може містити необов'язковий елемент

    , своєю чергою складається з чотирьох обов'язкових елементів.

    Заголовок кнопки надсилання тексту з поля введення. Опис поля введення. Назва текстового об'єкта у полі введення. URL CGI-скрипт, який обробляє запити текстового введення.

    загадково; його можна використовувати, щоб вставити рядок пошуку або читацьких відгуків, але більшість збирачів його ігнорують.

    5. Елементи

    містить назву каналу-джерела повідомлення, отримане з його . Має обов'язковий атрибут URL, посилання на джерело.

    Цей елемент повинен передавати джерела посилань та новин. Може використовуватися в команді відправки повідомлень у канал і повинен автоматично генеруватися, коли повідомлення пересилається від збирача до засобу редагування блогу.

    Має три обов'язкові атрибути

    url Адреса програми, обов'язково HTTP URL length розмір програми в байтах type тип програми MIME

    Необов'язковий атрибут domain вказує на ресурс із класифікацією.

    Допускається довільна кількість елементів для різних доменів і перехресні посилання в різних частинах одногодомену.

    guid – унікальний на рівні каналу рядковий ідентифікатор статті. Складальник може використовувати ідентифікатори для виявлення нових статей.

    Синтаксис guid не визначено.

    За замовчуванням значення isPermaLink дорівнює true; якщо вказано false, guid не може розглядатися як URL.

    6. Примітки

    В RSS 0.91 різні елементи обмежувалися до 500 чи 100 символів. Крім того, не могло бути більше 15 повідомлень . Обмеження на довжини рядків відсутні, починаючи з RSS 0.92. Процесори можуть накладати свої обмеження, а генератори можуть мати опції, що обмежують кількість каналу, або довжини рядків.

    В RSS 2.0 передбачено зв'язування каналу зі своїм ідентифікатором у системі каталогізації за допомогою елемента категорії, описаного вище. Наприклад, щоб зв'язати канал з його ідентифікатором Syndic8, увімкніть елемент category з властивістю domain="Syndic8", і значення ідентифікатора каналу в базі даних Syndic8:

    Часто виникає питання щодо елементів: це не те саме, що і

  • ? У деяких системах, що надають контент, це так, в інших немає. У ряді систем
  • є постійним посиланням на запис блогу; в інших - посиланням на повний текст (якщо міститься короткий виклад), а на запис у блозі веде . У будь-якому випадку, рекомендується, щоб ви вказували guid, і, якщо можливо, він був постійним посиланням. Це дозволяє збирачам не повторювати записи, навіть якщо вони редагувалися.

    • 7. Розширення RSS

    RSS, що з'явився в 1999 р., прагнув стати простим та легким для розуміння форматом із відносно простими цілями. Після того, як він набув популярності, розробники побажали розширити його модулями, визначеними у просторах імен XML.

    Канал RSS 2.0 може міститиелементи та атрибути, не згадані на цій сторінці, лише якщо вони визначені у просторах імен.

    Елементи цього документа не є членами просторів імен, так що RSS 2.0 зберігає сумісність з колишніми версіями: файл версії 0.91 або 0.92 є валідним файлом версії 2.0. Якби елементи RSS 2.0 включалися в простір імен, це обмеження не було б, файл RSS 0.9x не був би вірним файлом RSS 2.0.

    RSS не є ідеальним форматом, але він дуже поширений та широко підтримується. Довгий час RSS потребував усталеної специфікації. Ця робота покликана допомогти формату стати постійним, щоб стимулювати зростання ринку пов'язаних розробок і розчистити шлях для нововведень в більш сучасних форматах передачі контенту. Ми очікуємо виходу подальших версій специфікації лише для внесення ясності до тексту, але не додавання до формату нових можливостей. Наступна робота пов'язана з модулями, що використовують простори імен та зовсім іншими форматами з іншими назвами.