DokuWiki

It's better when it's simple

Инструменты пользователя

Инструменты сайта


ru:syndication

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
ru:syndication [2009-09-30 18:58] 95.72.98.12ru:syndication [2022-11-13 05:41] (текущий) – [Примеры] Aleksandr
Строка 1: Строка 1:
 ====== Новостные ленты XML ====== ====== Новостные ленты XML ======
  
-[[DokuWiki]] предоставляет некоторые свои данные  для  новостных лент XML с помощью файла [[this>feed.php]]. На новостную ленту можно подписаться в [[wp>Aggregator|агрегаторе]].+«[[dokuwiki|Докувики]]» предоставляет некоторые свои данные  для  новостных лент XML с помощью файла [[this>feed.php]]. На новостную ленту можно подписаться в [[wp>Aggregator|агрегаторе]].
  
-Функциональность XML-рассылки((XML Syndication)) реализована в замечательном классе [[http://www.bitfolge.de/rsscreator-en.html|Feed Creator]], написанном Kai Blankenhorn.+Функциональность XML-рассылки((XML Syndication)) реализована в замечательном классе [[http://www.bitfolge.de/rsscreator-en.html|Feed Creator]], написанном Каем Блэнкенхорном (Kai Blankenhorn).
  
-===== Опции заданные в конфигурации или переданные в URL =====+===== Опциизаданные в конфигурации или переданные в URL =====
  
-То, каким образом происходит рассылка, настраивается с помощью определенных опций. При вызове feed.php без аргументов он использует эти опции для работы. Значения всех опций могут быть переписаны параметрами переданными в URL.+То, каким образом происходит рассылка, настраивается с помощью определённых опций. При вызове ''feed.php'' без аргументовон использует эти опции для работы. Значения всех опций могут быть переписаны параметрамипереданными в URL.
  
 ==== Ссылки ==== ==== Ссылки ====
Строка 13: Строка 13:
 Каждый элемент в созданной ленте имеет ссылку; эта опция определяет, куда эта ссылка указывает. Каждый элемент в созданной ленте имеет ссылку; эта опция определяет, куда эта ссылка указывает.
  
-  * **Опция конфигурации:** [[config#rss_linkto]] +  * Опция конфигурации: [[ru:config:rss_linkto]] 
-  * **Параметр URL:** linkto +  * Параметр URL: linkto 
-  * **По умолчанию:** diff +  * По умолчанию: diff 
-  * **Возможные значения:**+  * Возможные значения:
  
 ^ Значение   ^ Ссылка ^ ^ Значение   ^ Ссылка ^
-| page    | версия статьи на момент создания рассылки | +| page    | Версия статьи на момент создания рассылки
-| current | наиболее свежая версия статьи | +| current | Наиболее свежая версия статьи
-| rev     страница со списком версий статьи | +| rev     Страница со списком версий статьи
-| diff    | вид [[diff]] изменений статей |+| diff    | [[diff]]-вид изменений статей|
  
 ==== Содержание новостной ленты ==== ==== Содержание новостной ленты ====
Строка 28: Строка 28:
 Этой опцией определяется, что показывается в теле элемента новостной ленты. Этой опцией определяется, что показывается в теле элемента новостной ленты.
  
-  * **Опция конфигурации:** [[config#rss_content]] +  * Опция конфигурации: [[ru:config:rss_content]] 
-  * **Параметр URL:** content +  * Параметр URL: content 
-  * **По умолчанию:** abstract +  * По умолчанию: abstract 
-  * **Возможные значения:**+  * Возможные значения:
  
 ^ Значение   ^ Содержимое элемента ^ ^ Значение   ^ Содержимое элемента ^
 | abstract | Первый параграф статьи | | abstract | Первый параграф статьи |
-| diff     | diff изменений статьи в виде простого текста | +| diff     | diff-вид изменений статьи в виде простого текста
-| htmldiff | diff изменений статьи в виде таблице в формате HTML | +| htmldiff | diff-вид изменений статьи в виде таблице в формате HTML
-| html     все содержание статьи в виде HTML |+| html     Всё содержание статьи в виде HTML|
  
  
 ==== Формат новостной ленты ==== ==== Формат новостной ленты ====
  
-DokuWiki может создавать XML-рассылки в нескольких форматах.+«ДокуВики» может создавать XML-рассылки в нескольких форматах.
  
-  * **Опция конфигурации:** [[config#rss_type]] +  * Опция конфигурации: [[ru:config:rss_type]] 
-  * **Параметр URL:** type +  * Параметр URL: type 
-  * **По умолчанию:** rss1 +  * По умолчанию: rss1 
-  * **Возможные значения:**+  * Возможные значения:
  
 ^ Значение   ^ Формат рассылки ^ ^ Значение   ^ Формат рассылки ^
Строка 60: Строка 60:
 feed.php может быть использован для экспорта списка последних изменений (по умолчанию), но на ряду с этим может использоваться и для других списков. feed.php может быть использован для экспорта списка последних изменений (по умолчанию), но на ряду с этим может использоваться и для других списков.
  
-  * **Опция конфигурации:** none +  * Опция конфигурации: none 
-  * **Параметр URL:** mode +  * Параметр URL: mode 
-  * **По умолчанию:** recent +  * По умолчанию: recent 
-  * **Возможные значения:**+  * Возможные значения:
  
 ^ Значение   ^ Режим списка ^ ^ Значение   ^ Режим списка ^
-| recent список наиболее свежие статья, самые свежие сверху | +| recent Список наиболее свежих статей, самые свежие сверху
-| list    | простой список всех статей в пространстве имен (какого имени см. ниже) | +| list    | Простой список всех статей в пространстве имён (какого имени --- см. ниже) | 
-| search список статей соответствующих запросу поиска, заданного в дополнительном параметре ''q'' |+| search Список статейсоответствующих запросу поиска, заданного в дополнительном параметре ''q'' |
  
-==== Фильтр пространств имен ====+==== Фильтр пространств имён ====
  
-Лента новостей может быть ограничено статьями только конкретного пространства имен.+Лента новостей может быть ограничена статьями только конкретного пространства имён.
  
-  * **Опция конфигурации:** none +  * Опция конфигурации: none 
-  * **Параметр URL:** ns +  * Параметр URL: ns 
-  * **По умолчанию:** +  * По умолчанию:
-  * **Возможные значения:** любое допустимое пространство имен+  * Возможные значения: любое допустимое пространство имён
  
-В [[#Режим списков|режиме списков]] ''list''лента будет содержать статьи только из данного пространства имен, но не из его подпространств.+В [[#Режим списков|режиме списков]] ''list'' лента будет содержать статьи только из данного пространства имён, но не из его подпространств.
  
-В [[#Режим списков|режиме списков]] ''recent''подпространства включаются.+В [[#Режим списков|режиме списков]] ''recent'' подпространства включаются.
  
-Ограничение пространства имен напрямую не поддерживается для [[#Режим списков|режима списков]] ''search''. Вместо этого вы можете ограничить пространство имен в запросе (используя символ ''@''), однакопри этом будут включены подпространства.+Ограничение пространства имён напрямую не поддерживается для [[#Режим списков|режима списков]] ''search''. Вместо этого вы можете ограничить пространство имён в запросеиспользуя символ «@», однако при этом будут включены подпространства.
  
 ==== Ограничение числа элементов ==== ==== Ограничение числа элементов ====
Строка 89: Строка 89:
 Здесь может быть определено число статей в рассылке новостей. Здесь может быть определено число статей в рассылке новостей.
  
-  * **Опция конфигурации:** [[config:recent]] +  * Опция конфигурации: [[ru:config:recent]] 
-  * **Параметр URL:** num +  * Параметр URL: num 
-  * **По умолчанию:** 20 +  * По умолчанию: 20 
-  * **Возможные значения:** целое число+  * Возможные значения: целое число
  
 ==== Включение малых правок ==== ==== Включение малых правок ====
  
-По умолчанию малые правок((minor edits)) будут отражаться в рассылке. Это может быть изменено в параметре URL.+По умолчанию малые правок (minor edits) будут отражаться в рассылке. Это может быть изменено в параметре URL.
  
-  * **Опция конфигурации:** none +  * Опция конфигурации: none 
-  * **Параметр URL:** minor +  * Параметр URL: minor 
-  * **По умолчанию:** +  * По умолчанию:
-  * **Возможные значения:** 0 или 1+  * Возможные значения: 0 или 1
  
-==== Caching  ====+==== Кэширование ====
  
-XML feeds are cached to reduce the load on the wikiThis option controls how long feed caches are valid.+Рассылки XML кэшируются для уменьшения нагрузки на викиЭта опция контролирует, насколько долго кэши новостей считаются валидными.
  
-  * **Config Option:** [[config:rss_update]] +  * Опция конфигурации: [[ru:config:rss_update]] 
-  * **URL Parameter:** none +  * Параметр URL: нет 
-  * **Default:** 5*60 +  * По умолчанию: 5*60 
-  * **Possible Values:** time in seconds+  * Возможные значениявремя в секундах
  
-==== Summaries ====+==== Сводки изменений ====
  
-The [[summary]] of a page change will usually be included in the feed item titleThis might be unwanted sometimes and can be disabled.+[[summary|Сводка]] изменений статьи обычно включается в заголовок элемента новостной лентыЭто может быть нежелательно и может быть отключено.
  
-  * **Config Option:** [[config:rss_show_summary]] +  * Опция конфигурации: [[ru:config:rss_show_summary]] 
-  * **URL Parameter:** none +  * Параметр URL: нет 
-  * **Default:** +  * По умолчанию: 1 
-  * **Possible Values:** or 1+  * Возможные значения: 0 или 1
  
 ===== Примеры ===== ===== Примеры =====
  
-  * [[this>feed.php?type=rss2&num=5]] returns a [[http://backend.userland.com/rss|RSS 2.0]] feed of the 5 most recent changes +  * [[this>feed.php?type=rss2&num=5]] возвращает  RSS-2.0-рассылку пяти наиболее свежих изменений; 
-  * [[this>feed.php?mode=list&type=atom&linkto=page&ns=wiki]] list all pages in the wiki namespace as an [[http://intertwingly.net/wiki/pie/FrontPage|ATOM 0.3]] feed with all items linking to the page directly+  * [[this>feed.php?mode=list&type=atom&linkto=page&ns=wiki]] перечисляет все статьи в пространстве имён «wiki» в формате ATOM-0.3-рассылки, в которой каждый элемент связан непосредственно со статьёй.
  
-===== Новостные ленты и ACL =====+===== Новостные ленты и списки доступа =====
  
-When ACLs are enabledread 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%%''http://example.com/dokuwiki/feed.php?u=username&p=password''%%.+Если вы хотите получить доступ к рассылкам ограниченных статей, вам нужно передать ваши имя пользователя и пароль в URL, как показано здесь 
 +  ''http://example.com/dokuwiki/feed.php?u=username&p=password''
  
-:!: This is not very secure and might lead to the leakage of your user credentialsWhen DokuWiki is running atop of ''mod_php'' passing login credentials via HTTP Basic Auth as supported by some newsreaders might work as well.+:!: Это не очень безопасно и может привести к утечке ваших персональных данных 
 +Но в тоже время, это может работать, когда «ДокуВики» работает поверх ''mod_php'', который передаёт логин/пароль через схему аутентификации «HTTP Basic Auth», и некоторые агрегаторы поддерживают её.
  
-==== Approach with .htusers ====+==== Подход, использующий .htusers ====
  
-For my configuration (dokuwiki 2008-05-05 and [[http://liferea.sourceforge.net/|Liferea]]) the HTTP Basic Auth approach did not work out of the boxIt seems that the authentication was not happening because the web server did not ask for itSo I forced this by creating a .htusers file (out of the dokuwiki user informationand restrict the access to feed.php:+В моей конфигурации (dokuwiki 2008-05-05 и [[http://liferea.sourceforge.net/|Liferea]]) аутентификация «HTTP Basic Auth» не работала «из коробки»Оказалось, что аутентификация не проходила потому, что веб-сервер не запрашивал еёПоэтому я принудил её совершаться, создав файл .htusers (из информации по пользователям «ДокуВики»и ограничил доступ к feed.php:
  
-I used the following simple script to generate a htusers file (used by apache) out of dokuwikis user data:+Я использовал следующий простой скрипт для генерации файла .htusers, используемый Apache, из данных пользователей «ДокуВики»:
  
   user@host# cat update_htusers   user@host# cat update_htusers
Строка 144: Строка 146:
   grep -v '^#' users.auth.php |  cut -sd\: -f1,2 > .htusers   grep -v '^#' users.auth.php |  cut -sd\: -f1,2 > .htusers
  
-Add to your existing .htaccess in dokuwiki main folder:+Добавьте к существующему файлу .htaccess в основной директории «ДокуВики»:
  
 <code apache> <code apache>
Строка 158: Строка 160:
 ===== См. также ===== ===== См. также =====
  
-  * [[rss|RSS/ATOM Feed Aggregation]] for adding external feeds to your DokuWiki pages +  * [[rss|Агрегация рассылок RSS/ATOM]] для добавления внешних лент в ваши статьи «ДокуВики». 
-  * The [[plugin:feed|feed plugin]] for more ways to export your [[plugin:blog]] posts via RSS +  * Плагин [[plugin:feed|Feed]] для других способов экспортировать посты вашего [[plugin:blog|блога]] через RSS. 
-  * Tips on [[tips:blogging#feed_setup|feed setup]] when blogging with DokuWiki+  * Советы по [[tips:blogging#feed_setup|установке рассылки]], если хотите вести блог с помощью своей «ДокуВики». 
ru/syndication.1254329888.txt.gz · Последнее изменение: 2009-09-30 18:58 — 95.72.98.12

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki