Агрегация лент новостей RSS/ATOM
«Докувики» может включать в себя данные из внешних новостных XML-лент. См. также статью «Ленты новостей» о том, как «Докувики» экспортирует данные в XML-рассылках.
Синтаксис
Включение лент новостей RSS или ATOM — это просто. Вот пример включения последних заголовков со Slashdot:
{{rss>http://rss.slashdot.org/Slashdot/slashdotMain}}
Для разбора лент новостей XML используется SimplePie. Все форматы, понятные SimplePie, также могут использоваться и в «Докувики». Вы можете влиять на отображение, добавляя дополнительные параметры, разделённые пробелами:
| Параметр | Описание |
|---|---|
| любое число | будет использоваться как максимальное число элементов в списке; по умолчанию 8 |
| reverse | отображать последний элемент в ленте первым |
| author | отображать имя автора элемента |
| date | отображать дату элемента |
| description | отображать описание элемента. Если использование HTML отключено, то все html-тэги будут вырезаны |
| n[dhm] | период обновления, где d — дни, h — часы, m — минуты, (т. е. 12h — 12 часов) |
Период обновления по умолчанию — 4 часа. Любое значение меньше 10 минут будет трактоваться как 10 минут. «Докувики» в основном старается предоставить кэшированные версии статей, очевидно, это не подходит, если страница содержит динамический внешний контент. Этот параметр говорит «Докувики» «пересобрать» статью, если со времени последней «сборки» прошло больше времени, чем период обновления.
Пример:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}