DokuWiki Syndication

Система может генерировать ленту новостей - машинно-читаемый список изменений страниц в формате RSS/Atom. Как раз такой формат использует неограниченное число агрегаторов («читалок») новостей, среди которых - Google Reader, плагины Firefox Sage и WizzRSS, встроенная читалка в Opera и другие.

Читалке нужно «скормить» некий адрес, по которому она будет получать новости. У нас наиболее интересная часть вики закрыта, поэтому для доступа требуется также указать имя и пароль. Для этого существует два метода:

1. Если агрегатор поддерживает HTTP Basic Authentication, в настройках источника новостей у него будут поля «имя» и «пароль». Именно туда и нужно вписать ваши учётные данные для входа в вики. В этом случае базовый адрес источника новостей будет http://wiki.otaku.ru/feed.php; этот способ рекомендуется, если работает.
2. Если агрегатор этого не поддерживает, то имя и пароль придётся указать в строке адреса, который примет вид: http://wiki.otaku.ru/feed.php?u=ваше-имя&p=ваш-пароль. Это менее безопасно.

В частности, пользователям Google Reader придётся использовать второй способ, поскольку первый не работает. Пользователям браузерных плагинов, напротив, лучше использовать первый способ, потому, что он безопаснее (пароль нигде не отображается).

Самое интересное, что каждый может настроить под себя, что и как будет отображаться в этой ленте. Для этого в адрес источника новостей добавляются специальные параметры.

Начинать нужно всегда с базового адреса (см. выше), который у вас заработал. Все параметры - просто дополнения к нему.

Параметры можно комбинировать, соединяя при помощи знака &: например, если мы хотим видеть в тексте список отличий, а по ссылке - самую новую версию страницы, то адрес источника новостей будет http://wiki.otaku.ru/feed.php?linkto=current&content=diff или http://wiki.otaku.ru/feed.php?u=ваше-имя&p=ваш-пароль&linkto=current&content=diff

Полный список параметров можно найти здесь, а я опишу наиболее полезные:

Каждая новость имеет заголовок, который работает как ссылка на подробности и обычно совпадает с заголовком изменившейся страницы. Вариант ссылки выбирается при помощи параметра linkto. Эта ссылка может указывать на:

• Самую новую версию страницы - linkto=current
• Ту самую версию страницы, которая получилась после конкретно указанных изменений. (Если в страницу вносились правки, то это может быть не самая новая версия) - linkto=rev
• Список изменений, которые претерпела страница, т.е. две панели, в одной будут показана старая версия, во второй - новая, и все изменившиеся строки будут подсвечены - linkto=diff

Например, если вы хотите по ссылке переходить всегда на самую свежую версию страницы, то адрес источника новостей будет выглядеть так: http://wiki.otaku.ru/feed.php?linkto=current или http://wiki.otaku.ru/feed.php?u=ваше-имя&p=ваш-пароль&linkto=current

Можно выбрать, что будет отображаться в тексте новости. Это регулируется параметром content:

• Полный текст новой версии страницы, как она выглядит в DokuWiki: content=html
• Список изменений, как он выглядит в DokuWiki: content=htmldiff
• Список изменений, в упрощённом виде (без форматирования): content=diff
• Первый абзац (или его часть) новой версии страницы (без форматирования): content=abstract

Можно следить за изменениями не всех страниц системы, а только некоторых. Например, можно указать, чтобы в ленте новостей отображались только изменения страниц, относящихся в 2012 году (из пространства 2012).

Для этого используем параметр ns: http://wiki.otaku.ru/feed.php?ns=org:2012 как раз и отобразит список пространств изменившихся страниц с адресами, начинающимися на http://wiki.otaku.ru/org:2012: