======Auto-Tooltip для «ДокуВики»====== {{:wiki:plugin:dwplugin.png?70 |}} Создавайте всплывающие подсказки вручную или генерируйте их на основе заголовка и аннотации вики-ссылки. Этот плагин позволяет создавать всплывающие подсказки для текста и ссылок на странице или автоматически генерировать всплывающие подсказки на основе заголовка и аннотации вики-ссылки. Если вы включите плагин рендеринга или установите [[https://www.dokuwiki.org/plugin:actionrenderer|ActionRenderer]] , он даже сможет добавить всплывающую подсказку к каждой внутренней вики-ссылке на вашем сайте!\\ {{:wiki:plugin:ac525e1d98e45a861c80e9945a576552.media.png?|}} * **Релиз:** 2020-11-22. * **Репозиторий:**https://github.com/zioth/dokuwiki-autotooltip * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам" =====Совместимость===== **[[https://www.dokuwiki.org/plugin:description|описание]]** : если вы добавите описание на страницу с помощью этого плагина, во всплывающих подсказках будет показано описание, а не сгенерированное «ДокуВики» резюме. =====Монтаж===== Используйте менеджер плагинов для установки или… - скачать zip-файл - распаковать его в/lib/plugins/ - войдите как администратор и измените плагин в менеджере конфигурации =====Применение===== Этот плагин позволяет вам вручную вставлять всплывающие подсказки одну за другой или автоматически генерировать их для каждой вики-ссылки на вашем сайте (или ее подмножества, ограниченного пространством имен). #: Нажмите тут, чтобы посмотреть примеры... **Примеры:**\\ Автоматическое создание из викиссылки wiki:syntax wiki:syntax **Автоматическое создание из вики-ссылки с пользовательским текстом** wiki:syntax|Переименованная страница синтаксиса wiki:syntax|Переименованная страница синтаксиса **Построить вручную** Простая подсказка Я — подсказка! Простая подсказка Я — подсказка! **Кастомизация: Синий** wiki:syntax wiki:syntax **Кастомизация: Обычный** wiki:syntax wiki:syntax Кастомизация: Маленький wiki:syntax wiki:syntax :# Есть три способа включить эту функцию: - Если вы уже используете ActionRenderer в качестве средства визуализации, вам не нужно ничего делать. - Перейдите в «Администратор » → «Конфигурация» → «Дополнительно» → «renderer_xhtml » и выберите «Автоматическая подсказка». - Если ни один из этих вариантов не соответствует вашим потребностям, рассмотрите Auto-link 4 , который может добавлять всплывающие подсказки к генерируемым ссылкам при установке вместе с AutoTooltip. Вы не увидите всплывающие подсказки по ссылкам, ссылающимся на самих себя. Другими словами, ссылка на //wiki:whatever// на //wiki:whatever// не будет иметь всплывающей подсказки. **Подсказки вручную** Это текст по ссылке на странице. Тело всплывающей подсказки. Необязательный заголовок всплывающей подсказки Это текст по ссылке на странице. Тело всплывающей подсказки. Необязательный заголовок всплывающей подсказки Это создаст простую всплывающую подсказку для текста на странице. **Настройка всплывающей подсказки** ... ... Существует настройка администратора, позволяющая изменить стиль всех всплывающих подсказок по умолчанию. Если вы хотите переопределить это для одной всплывающей подсказки, вы можете указать стили в определении всплывающей подсказки. Доступные классы: * по умолчанию: полупрозрачная черная подсказка с закругленной рамкой. * синий: то же, что и по умолчанию, но синий. * Обычный: белая подсказка с черным текстом и черной рамкой. * small: Меньший размер шрифта. Его можно комбинировать с любым из вышеперечисленных стилей. Вы можете добавить дополнительные стили в свой CSS . Имена классов имеют вид плагин - %%autotooltip__MYNAME%%. Например, чтобы создать всплывающую подсказку с изображением фона и белым текстом, добавьте этот CSS : .plugin-autotooltip__picture { background: url(/path/to/image.jpg); color: #fff; } а затем создайте всплывающую подсказку следующим образом: ... **Создание всплывающей подсказки** вики:синтаксис вики:синтаксис Это создаст ссылку на wiki:syntax, используя заголовок страницы в качестве текста ссылки. Всплывающая подсказка будет включать заголовок и аннотацию страницы. wiki:syntax|Пользовательский заголовок wiki:syntax|Пользовательский заголовок То же, что и выше, но текст ссылки будет «Пользовательский заголовок» ===== Конфигурация и настройки ===== * стиль: набор классов по умолчанию, разделенных пробелами. Это могут быть встроенные стили или любой созданный вами класс 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 и установите новую версию, как указано выше. =====Файл для загрузки===== {{ :wiki:plugin:zioth-dokuwiki-autotooltip-413232e.zip |}} =====Лицензия===== * **Author:** [[elifenton@this_is_not_a_real_email.fake|Eli Fenton]] * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]] Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:autotooltip|эту страницу]] с вашего сайта, если вам нравится этот продукт.