======DocNavigation для «ДокуВики»======
{{:wiki:plugin:dwplugin.png?70 |}} Добавьте навигационные ссылки на предыдущую и следующую страницу вверху и внизу вики-страницы.

  * **Релиз:** 2023-01-23. 
  * **Репозиторий:**https://github.com/Klap-in/dokuwiki-plugin-docnavigation/
  * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам" 

{{:wiki:plugin:docnavigation_pagenav.png?|}}
=====Совместимость=====

Пожалуйста, сообщайте обо всех своих ошибках и пожеланиях в [[https://github.com/Klap-in/dokuwiki-plugin-docnavigation/issues|системе отслеживания ошибок]].

Пример работы виден на этой странице внизу и вверху, ссылки работают, но, несмотря на все тесты совместимости у меня дает ошибку ''<doctoc>: страница wiki:plugin:dokuteaser не ссылается на wiki:plugin:docnavigation.''
<code>
<- wiki:plugin:display|Display Wiki Page для «ДокуВики» ^ wiki:plugin:plugins|основные_плагены ^ wiki:plugin:dokuteaser|Dokuteaser для «ДокуВики» ->
</code>

Пример ошибки:
{{:wiki:plugin:screenshot_2.png?|}}


=====Монтаж=====
Используйте менеджер плагинов для установки или…

  - скачать zip-файл
  - распаковать его в<dokuwiki>/lib/plugins/
  - войдите как администратор и измените плагин в менеджере конфигурации
=====Применение=====

Синтаксис определяет, какие страницы называются предыдущими и следующими. Между ними может быть предоставлена стартовая страница или страница с обзором.

<code>
<- namespace:previous_page ^ namespace:startpage ^ namespace:next page ->
</code>

или, как вариант, только другой синтаксис (например, нужен в сочетании с плагином [[https://www.dokuwiki.org/plugin:ckgedit|ckgedit]])

<code>
<< namespace:previous_page ^ namespace:startpage ^ namespace:next page >>
</code>

А на стартовой странице можно поставить автогенерируемое оглавление с помощью

<code>
<doctoc start= yournamespace:firstpage>
</code>


===== Конфигурация и настройки =====

Навигация по страницам
URL-адреса отображаются с именами ссылок по умолчанию, полученными из URL-адреса или настройки [[https://www.dokuwiki.org/config:useheading|useheading]].

<code>
<-namespace:previous^namespace:startpage^namespace:next->
</code>
URL-адреса отображаются с указанными именами.

<code>
<-previous|Your previous page^startpage|Overview^other_page|Navigate to next page ->
</code>

Пример навигации, добавленной плагином DocNavigation. Здесь включена конфигурация [[https://www.dokuwiki.org/config:useheading|useheading]], так что заголовки страниц используются в качестве имени ссылки.

{{:wiki:plugin:docnavigation_pagenav_1_.png?|}}

====Оглавление, созданное из связанных страниц====

Оглавление связанных страниц может быть создано с помощью ''<doctoc //optionname=value[, more=..]//>''.

<code>
<doctoc>
<doctoc start=firstpage, includeheadings=2-3>
</code>

возможные варианты:

|**Вариант**|**Описание**|
|''start=<pageid>''|Идентификатор страницы первой страницы с постраничной навигацией, если он не указан, поиск постраничной навигации осуществляется на текущей странице.|
|''includeheadings=<topheading>-<maxheading>''|Включает заданные уровни заголовков страницы в оглавление. например ''2-3'' По умолчанию: ''2'' (уровни пронумерованы от 1 до 5)|
|''hidepagelink=<0 or 1>''|Скрыть ссылки на страницы, но показать по умолчанию первые два уровня оглавления. С помощью ''includeheadings'' настройки можно изменить количество уровней. Если используется only ''includeheadings'', отображаются ссылки на страницы, что может привести к дублированию заголовков, если отображается уровень 1.|
|''useheading=<0 or 1>''|Отменяет «навигацию» в настройке useheading .|

=====Обновление=====
Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
=====Файл для загрузки=====
{{ :wiki:plugin:dokuwiki-plugin-docnavigation-master.zip |}}
=====Лицензия=====
  * **Author:** [[klapinklapin@gmail.com|Gerrit Uitslag]]
  * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]

Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:docnavigation#docnavigation_plugin|эту страницу]] с вашего сайта, если вам нравится этот продукт.