Содержание
AcMenu Plugin
Совместим с «Докувики»
2017-02-19 "Frusterick Manners"
Это расширение не обновлялось более двух лет. Возможно, оно больше не разрабатывается или не поддерживается; возможны проблемы совместимости.
This extension is not in the 'plugin' or 'template' namespace and is therefore ignored.
Внимание
URL-адрес репозитория изменен на
https://bitbucket.org/tormec/acmenu/src
. Если плагин уже установлен, в Менеджере расширений
просто нажмите Переустановить
для обновления.
— Torpedo 2017-10-07 12:25
Описание
AcMenu предоставляет меню в виде «аккордеона», которое отображает содержимое пространств имен в древовидном формате. Дерево будет построено, начиная с пространства имен, где будет прописан синтаксис AcMenu.
Этот плагин учитывает правила ACL и, кроме того, параметры sneaky_index и hidepages, которые поставляются с вашей конфигурацией DokuWiki.
Установка
- По ссылке:
- Скопируйте адрес из ссылки «Скачать» из формы вверху этой страницы. Вставьте его в Менеджере Плагинов вашего сайта во вкладке «Ручная установка» в первое поле. Нажмите кнопку «Установить».
- Скачанный архив:
- Предложите архив второму полю той же вкладки. Нажмите кнопку «Установить».
- Распакуйте из архива папку плагина. Правильное наименование папки плагина - в файле
plugin.info.txt
после указателя base. Переименуйте папку и загрузите на сервер вашего сайта, если понимаете, как это сделать.
Синтаксис
На странице боковой панели используйте синтаксис:
<acmenu>
Примеры
Несколько скриншотов, чтобы дать общее представление о конечном результате.
Предположим, вы хотите разделить свою основную вики на две независимые между собой суб-вики:
+--sidebar.txt +--start.txt +--branch-a | +--sidebar.txt | +--start.txt | +--products | | +--start.txt | +--services | | +--start.txt | +--private | +--start.txt | +--confidential.txt +--branch-b +--sidebar.txt +--start.txt +--products | +--start.txt +--services | +--start.txt +--private +--start.txt +--confidential.txt
Вы можете заполнить каждый sidebar.txt
следующим образом:
- в
:sidebar.txt
<acmenu>
- в
:branch-a:sidebar.txt
[[..:start| Back to Main]] <acmenu>
- в
:branch-b:sidebar.txt
[[..:start| Back to Main]] <acmenu>
Когда посетитель находится в :start.txt
, плагин показывает, что полное дерево пространства имён свернуто, за исключением пространства имен, в котором sidebar.txt
с синтаксисом AcMenu. В случае, если в браузере посетителя отключён JavaScript, все пространства имён отображают их содержимое, чтобы можно было продолжить навигацию.
Если посетитель решает открыть любое :branch-*
или любое его под-пространство имён :branch-*:*
, AcMenu показывает только боковую панель относительно выбранной ветви.
Если посетитель является гостем, и у него нет разрешения на вход в любую область :branch-*:private
, вы должны установить соответствующее правило в ACL. Кроме того, вы можете скрыть для него пространство имен :branch-*:private
, в котором будет установлен параметр sneaky_index в Менеджере конфигурации.
Если посетитель является зарегистрированным пользователем и имеет разрешение на вход в любую область :branch-*:private
, но не имеет права просмотра страницы :branch-*:confidential.txt
, вы должны установить соответствующее правило в ACL.
Кроме того, можно скрыть все страницы sidebar.txt
с помощью опции hidepages в Менеджере конфигурации:
^:(?:.*sidebar)
Поскольку этот плагин использует файлы cookie для запоминания посещенных страниц (они автоматически удаляются, как только окно браузера закрывается), если посетитель возвращается к :start.txt
, ветви и их подпространства имён без ограничений будут оставаться таковыми.
Порядок, в котором представлено дерево каталогов, выглядит следующим образом:
- сначала папки
0-9A-Za-z
- затем файлы
0-9A-Za-z
Это означает, что, если включена опция useheading, можно принудительно упорядочить порядок файлов, используя прогрессивную нумерацию в первом заголовке каждого файла.
Конфигурация и настройки
Поведение меню
Навигация через пространства имён и ссылки на связанные страницы работает следующим образом:
- в пространстве имён:
- один клик: показать/спрятать связанное содержание;
- двойной клик: открывает связанную стартовую страницу;
- на странице:
- один клик: открывает связанную страницу.
Скрыть пространства имён и страницы
Сначала установите соответствующие разрешения в ACL. Затем используйте параметры:
- sneaky_index: спрятать пространства имён.
- hidepages: спрятать страницы;
Исправление проблем
Симптом: AcMenu не отображает/не скрывает содержимое пространства имен.
Возможное решение: убедитесь, что JavaScript включен в вашем браузере, иначе все пространства имён остаются открытыми, показывая их содержимое.
Симптом: После открытия любой ссылки AcMenu не оставляет без изменений какое-либо пространство имён.
Возможное решение: убедитесь, что файлы cookie включены в браузере, в противном случае AcMenu забывает пространства имен, которые были раскрыты при загрузке страницы.
Развитие
Все вопросы задавайте на этой странице.