Auto-Tooltip для «ДокуВики»

Создавайте всплывающие подсказки вручную или генерируйте их на основе заголовка и аннотации вики-ссылки. Этот плагин позволяет создавать всплывающие подсказки для текста и ссылок на странице или автоматически генерировать всплывающие подсказки на основе заголовка и аннотации вики-ссылки. Если вы включите плагин рендеринга или установите ActionRenderer , он даже сможет добавить всплывающую подсказку к каждой внутренней вики-ссылке на вашем сайте!

• Релиз: 2020-11-22.
• Репозиторий:https://github.com/zioth/dokuwiki-autotooltip
• Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

описание : если вы добавите описание на страницу с помощью этого плагина, во всплывающих подсказках будет показано описание, а не сгенерированное «ДокуВики» резюме.

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

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

Этот плагин позволяет вам вручную вставлять всплывающие подсказки одну за другой или автоматически генерировать их для каждой вики-ссылки на вашем сайте (или ее подмножества, ограниченного пространством имен).

<autott>wiki:syntax</autott>

<autott>wiki:syntax|Переименованная страница синтаксиса</autott>

<autott>
  <content>Простая подсказка</content>
  <tip>Я — подсказка!</tip>
</autott>

<autott blue>wiki:syntax</autott>

<autott plain>wiki:syntax</autott>

<autott small>wiki:syntax</autott>

Есть три способа включить эту функцию:

1. Если вы уже используете ActionRenderer в качестве средства визуализации, вам не нужно ничего делать.
2. Перейдите в «Администратор » → «Конфигурация» → «Дополнительно» → «renderer_xhtml » и выберите «Автоматическая подсказка».
3. Если ни один из этих вариантов не соответствует вашим потребностям, рассмотрите Auto-link 4 , который может добавлять всплывающие подсказки к генерируемым ссылкам при установке вместе с AutoTooltip.

Вы не увидите всплывающие подсказки по ссылкам, ссылающимся на самих себя. Другими словами, ссылка на wiki:whatever на wiki:whatever не будет иметь всплывающей подсказки.

Подсказки вручную

<autott>
  <content>Это текст по ссылке на странице.</content>
  <tip>Тело всплывающей подсказки.</tip>
  <title>Необязательный заголовок всплывающей подсказки</title>
</autott>

Это текст по ссылке на странице.plugin-autotooltip__default plugin-autotooltip_bigНеобязательный заголовок всплывающей подсказки

Тело всплывающей подсказки.

Это создаст простую всплывающую подсказку для текста на странице.

Настройка всплывающей подсказки

<autott style1 style2>...</autott>

Существует настройка администратора, позволяющая изменить стиль всех всплывающих подсказок по умолчанию. Если вы хотите переопределить это для одной всплывающей подсказки, вы можете указать стили в определении всплывающей подсказки. Доступные классы:

• по умолчанию: полупрозрачная черная подсказка с закругленной рамкой.
• синий: то же, что и по умолчанию, но синий.
• Обычный: белая подсказка с черным текстом и черной рамкой.
• small: Меньший размер шрифта. Его можно комбинировать с любым из вышеперечисленных стилей.

Вы можете добавить дополнительные стили в свой CSS . Имена классов имеют вид плагин - autotooltip__MYNAME. Например, чтобы создать всплывающую подсказку с изображением фона и белым текстом, добавьте этот CSS :

.plugin-autotooltip__picture {
  background: url(/path/to/image.jpg);
  color: #fff;
}

а затем создайте всплывающую подсказку следующим образом:

<autott picture>...</autott>

Создание всплывающей подсказки

<autott>вики:синтаксис</autott>

синтаксис

Это создаст ссылку на wiki:syntax, используя заголовок страницы в качестве текста ссылки. Всплывающая подсказка будет включать заголовок и аннотацию страницы.

<autott>wiki:syntax|Пользовательский заголовок</autott>

Пользовательский заголовокplugin-autotooltip__default plugin-autotooltip_bigСинтаксис форматирования

«Докувики» поддерживает простой язык разметки, который по возможности сохраняет файлы данных как можно более читабельными. Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании статей. Просто посмотрите на исходный код этой статьи, нажав кнопку «Править страницу» в правой верхней части страницы в меню управления пользователя. Если хотите поупражняться, просто используйте «…

То же, что и выше, но текст ссылки будет «Пользовательский заголовок»

• стиль: набор классов по умолчанию, разделенных пробелами. Это могут быть встроенные стили или любой созданный вами класс CSS , который начинается с «plugin-autotooltip__».
• задержка: время ожидания в миллисекундах перед отображением всплывающей подсказки.
• linkall_inclusions: при использовании плагина рендеринга для добавления всплывающих подсказок ко всем ссылкам это регулярное выражение для включения страниц или пространств имен. Например, «^wiki:|^stuff:» включает только ссылки из пространств имен wiki и «stuff». Оставьте пустым, чтобы включить все страницы.
• linkall_exclusions: регулярное выражение для исключаемых страниц или пространств имен. В сочетании с linkall_inclusions это означает «Включить эти страницы, кроме этих страниц». Это хорошо работает с Include и подобными плагинами, позволяя, например, исключить всплывающие подсказки на всех боковых панелях, но оставить их на странице.

Помощник предоставляет следующие методы:

для текста
Создайте вручную всплывающую подсказку для произвольного текста.

$tooltip->forText($content, $tooltip, $title='', $preTitle='', $classes='', $textStyle='');

• $content: текст на странице.
• $tooltip: содержимое всплывающей подсказки. Новые строки будут отображаться как разрывы строк.
• $title: заголовок внутри всплывающей подсказки.
• $preTitle: Текст, отображаемый перед заголовком. Новые строки будут отображаться как разрывы строк.
• $classes: классы CSS , которые можно добавить в эту подсказку. «dokuwiki-plugin__» будет добавлен к каждому классу.
• $textStyle — стили CSS для связанного контента.

для Wikilink
Создайте викиссылку со всплывающей подсказкой.

$tooltip->forWikilink($id, $content=null, $classes='', $linkStyle='');

• $id — идентификатор страницы.
• $content — содержимое страницы. Новые строки будут отображаться как разрывы строк. Не используйте заголовок страницы.
• $preTitle — текст, отображаемый перед заголовком во всплывающей подсказке. Новые строки будут отображаться как разрывы строк.
• $classes — классы CSS , которые нужно добавить в эту подсказку. «dokuwiki-plugin__» будет добавлен к каждому классу.
• $linkStyle — атрибут стиля ссылки.

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

zioth-dokuwiki-autotooltip-413232e.zip

• Author: Eli Fenton
• License: GNU GPL v2

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