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

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


Боковая панель

Этот перевод старее, чем оригинальная страница, и может быть неактуальным. Смотрите, что было изменено.
Перевод этой страницы?:

О «Докувики»

Дополнительные возможности

Corporate Use

Наше сообщество


Следуйте за нами на Фейсбуке, в Твиттере и других социальных сетях.

Конфиденциальность (англ.)

ru:plugin:acmenu

AcMenu Plugin

Совместим с «Докувики»

  • 2018-04-22 "Greebo" неизвестно
  • 2017-02-19 "Frusterick Manners" да
  • 2016-06-26 "Elenor Of Tsort" неизвестно
  • 2015-08-10 "Detritus" неизвестно

plugin Меню "аккордеон" для пространства имён и связанных страниц.

Последнее обновление:
2017-11-12
Предоставляет
Syntax
Репозиторий
Исходный код

Теги: menu, navigation

Внимание

:!: URL-адрес репозитория изменен на https://bitbucket.org/tormec/acmenu/src. Если плагин уже установлен, в Менеджере расширений просто нажмите Переустановить для обновления.
Torpedo 2017-10-07 12:25

Описание

AcMenu предоставляет меню в виде «аккордеона», которое отображает содержимое пространств имен в древовидном формате. Дерево будет построено, начиная с пространства имен, где будет прописан синтаксис AcMenu.

Этот плагин учитывает правила ACL и, кроме того, параметры sneaky_index и hidepages, которые поставляются с вашей конфигурацией DokuWiki.

Установка

Установите плагин с помощью Менеджера Плагинов и URL-адреса загрузки выше, это укажет на последнюю версию плагина. Обратитесь к Плагинам чтобы узнать, как установить плагины вручную.

Синтаксис

На странице боковой панели используйте синтаксис:

<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 забывает пространства имен, которые были раскрыты при загрузке страницы.


Развитие

Все вопросы задавайте на этой странице.

ru/plugin/acmenu.txt · Последние изменения: 2017-11-20 06:41 — Wirbel78