ru:syndication
Различия
Показаны различия между двумя версиями страницы.
Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия | ||
ru:syndication [2009-09-30 17:58] – 95.72.98.12 | ru:syndication [2022-11-13 05:41] (текущий) – [Примеры] Aleksandr | ||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Новостные ленты XML ====== | ====== Новостные ленты XML ====== | ||
- | [[DokuWiki]] предоставляет некоторые свои данные | + | «[[dokuwiki|Докувики]]» предоставляет некоторые свои данные |
- | Функциональность XML-рассылки((XML Syndication)) реализована в замечательном классе [[http:// | + | Функциональность XML-рассылки((XML Syndication)) реализована в замечательном классе [[http:// |
- | ===== Опции заданные в конфигурации или переданные в URL ===== | + | ===== Опции, заданные в конфигурации или переданные в URL ===== |
- | То, каким образом происходит рассылка, | + | То, каким образом происходит рассылка, |
==== Ссылки ==== | ==== Ссылки ==== | ||
Строка 13: | Строка 13: | ||
Каждый элемент в созданной ленте имеет ссылку; | Каждый элемент в созданной ленте имеет ссылку; | ||
- | | + | * Опция конфигурации: |
- | | + | * Параметр URL: linkto |
- | | + | * По умолчанию: |
- | | + | * Возможные значения: |
^ Значение | ^ Значение | ||
- | | page | версия статьи на момент создания рассылки | | + | | page | Версия статьи на момент создания рассылки. | |
- | | current | наиболее свежая версия статьи | | + | | current | Наиболее свежая версия статьи. | |
- | | rev | + | | rev |
- | | diff | вид | + | | diff | [[diff]]-вид |
==== Содержание новостной ленты ==== | ==== Содержание новостной ленты ==== | ||
Строка 28: | Строка 28: | ||
Этой опцией определяется, | Этой опцией определяется, | ||
- | | + | * Опция конфигурации: |
- | | + | * Параметр URL: content |
- | | + | * По умолчанию: |
- | | + | * Возможные значения: |
^ Значение | ^ Значение | ||
| abstract | Первый параграф статьи | | | abstract | Первый параграф статьи | | ||
- | | diff | diff изменений статьи в виде простого текста | | + | | diff | diff-вид |
- | | htmldiff | diff изменений статьи в виде таблице в формате HTML | | + | | htmldiff | diff-вид |
- | | html | + | | html |
==== Формат новостной ленты ==== | ==== Формат новостной ленты ==== | ||
- | DokuWiki | + | «ДокуВики» |
- | | + | * Опция конфигурации: |
- | | + | * Параметр URL: type |
- | | + | * По умолчанию: |
- | | + | * Возможные значения: |
^ Значение | ^ Значение | ||
Строка 60: | Строка 60: | ||
feed.php может быть использован для экспорта списка последних изменений (по умолчанию), | feed.php может быть использован для экспорта списка последних изменений (по умолчанию), | ||
- | | + | * Опция конфигурации: |
- | | + | * Параметр URL: mode |
- | | + | * По умолчанию: |
- | | + | * Возможные значения: |
^ Значение | ^ Значение | ||
- | | recent | + | | recent |
- | | list | простой список всех статей в пространстве имен (какого имени см. ниже) | | + | | list | Простой список всех статей в пространстве имён (какого имени |
- | | search | + | | search |
- | ==== Фильтр пространств имен ==== | + | ==== Фильтр пространств имён ==== |
+ | Лента новостей может быть ограничена статьями только конкретного пространства имён. | ||
- | The feed can be limited to include pages of a certain namespace only. | + | * Опция конфигурации: |
+ | * Параметр URL: ns | ||
+ | * По умолчанию: | ||
+ | * Возможные значения: | ||
- | * **Опция конфигурации:** none | + | В [[# |
- | * **Параметр URL:** ns | + | |
- | * **По умолчанию:** * | + | |
- | * **Возможные | + | |
- | In [[#list mode]] '' | + | В [[#Режим списков|режиме списков]] '' |
- | In [[#list mode]] '' | + | Ограничение пространства имён напрямую не поддерживается для |
- | Namespace limitation is not directly supported for the [[#list mode]] '' | + | ==== Ограничение числа элементов ==== |
- | ==== Item Limits ==== | + | Здесь может быть определено число статей в рассылке новостей. |
- | The number of pages listed in the feed can be controlled as well. | + | * Опция конфигурации: |
+ | * Параметр URL: num | ||
+ | * По умолчанию: | ||
+ | * Возможные значения: | ||
- | * **Config Option:** [[config: | + | ==== Включение малых правок ==== |
- | * **URL Parameter: | + | |
- | * **Default: | + | |
- | * **Possible Values:** any integer | + | |
- | ==== Including Minor Edits ==== | + | По умолчанию малые правок (minor edits) будут отражаться в рассылке. Это может быть изменено в параметре URL. |
- | By default no minor edits will be shown in the feed. This can be changed by an URL argument. | + | * Опция конфигурации: |
+ | * Параметр | ||
+ | * По умолчанию: | ||
+ | * Возможные значения: | ||
- | * **Config Option:** none | + | ==== Кэширование ==== |
- | * **URL Parameter: | + | |
- | * **Default: | + | |
- | * **Possible Values:** 0 or 1 | + | |
- | ==== Caching | + | Рассылки XML кэшируются для уменьшения нагрузки на вики. Эта опция контролирует, |
- | XML feeds are cached to reduce the load on the wiki. This option controls how long feed caches are valid. | + | * Опция конфигурации: |
+ | * Параметр URL: нет | ||
+ | * По умолчанию: | ||
+ | * Возможные значения: | ||
- | * **Config Option:** [[config: | + | ==== Сводки изменений ==== |
- | * **URL Parameter: | + | |
- | * **Default: | + | |
- | * **Possible Values:** time in seconds | + | |
- | ==== Summaries ==== | + | [[summary|Сводка]] изменений статьи обычно включается в заголовок элемента новостной ленты. Это может быть нежелательно и может быть отключено. |
- | The [[summary]] of a page change will usually be included in the feed item title. This might be unwanted sometimes and can be disabled. | + | |
- | + | * Параметр | |
- | | + | * По умолчанию: 1 |
- | * **URL Parameter:** none | + | * Возможные значения: 0 или |
- | * **Default:** 1 | + | |
- | * **Possible Values:** 0 or 1 | + | |
===== Примеры ===== | ===== Примеры ===== | ||
- | * [[this> | + | * [[this> |
- | * [[this> | + | * [[this> |
- | ===== Новостные ленты и ACL ===== | + | ===== Новостные ленты и списки доступа |
- | When ACLs are enabled, read restricted pages will **not** be included in public feeds. | + | Когда включены [[acl|списки доступа]] (ACL), статьи с ограниченным доступом по чтению |
- | If you want to access feeds for restricted pages you have to pass your username and password along in the URL like this: %%'' | + | Если вы хотите получить доступ к рассылкам ограниченных статей, |
+ | | ||
- | :!: This is not very secure and might lead to the leakage of your user credentials. When DokuWiki is running atop of '' | + | :!: Это не очень безопасно и может привести к утечке ваших персональных данных. |
+ | Но в тоже время, это может работать, | ||
- | ==== Approach with .htusers ==== | + | ==== Подход, |
- | For my configuration | + | В моей конфигурации |
- | I used the following simple script to generate a htusers | + | Я использовал следующий простой скрипт для генерации файла .htusers, используемый Apache, из данных пользователей «ДокуВики»: |
user@host# cat update_htusers | user@host# cat update_htusers | ||
Строка 145: | Строка 146: | ||
grep -v ' | grep -v ' | ||
- | Add to your existing | + | Добавьте к существующему файлу |
<code apache> | <code apache> | ||
Строка 159: | Строка 160: | ||
===== См. также ===== | ===== См. также ===== | ||
- | * [[rss|RSS/ | + | * [[rss|Агрегация рассылок |
- | * The [[plugin: | + | * Плагин |
- | * Tips on [[tips: | + | * Советы по [[tips: |
ru/syndication.1254326303.txt.gz · Последнее изменение: 2009-09-30 17:58 — 95.72.98.12