| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
| plugin:docnavigation [2025/02/22 13:13] – [DocNavigation для «ДокуВики»] VladPolskiy | plugin:docnavigation [Дата неизвестна] (текущий) – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1 |
|---|
| ======Плагин DocNavigation====== | |
| ---- plugin ---- | |
| description: Добавьте навигационные ссылки на предыдущую и следующую страницу вверху и внизу вики-страницы. | |
| author : Gerrit Uitslag | |
| email : klapinklapin@gmail.com | |
| type : syntax, action | |
| lastupdate : 2024-02-08 | |
| compatible : Hogfather, Igor, Jack Jackrum, Kaos | |
| depends : | |
| conflicts : bloglinks | |
| similar : pagenav | |
| tags : navigation, listing, browse | |
| |
| downloadurl: https://github.com/Klap-in/dokuwiki-plugin-docnavigation/archive/master.zip | |
| bugtracker : https://github.com/Klap-in/dokuwiki-plugin-docnavigation/issues | |
| sourcerepo : https://github.com/Klap-in/dokuwiki-plugin-docnavigation/ | |
| donationurl: | |
| |
| screenshot_img : :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|эту страницу]] с вашего сайта, если вам нравится этот продукт. | |
| |
| |
| |