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

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


wiki:plugin:inserticon

Inserticon для «ДокуВики»

Добавляет маленькие иконки (16 пикселей) на любую страницу

Этот плагин был разработан Ди Терлицци.

Совместимость

  • 2024-02-06 «Kaos» да
  • 2023-04-04 «Jack Jackrum» да
  • 2022-07-31 «Igor» да
  • 2020-07-29 «Hogfather» да

:!: Внимание: Данный плаген разработан Adolfo González Blázquez в 2008 году и не поддерживается автором проекта и не работает с Dokuwiki старше 2020 года. Внесенные небольшие правки в код автора (без его разрешения), следуя рекомендациям кода авторов Dokuwiki и этот замечательный плагин вновь функционирует в 2025 году.

Монтаж

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

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

:!: Внимание: Данный плаген разработан Adolfo González Blázquez в 2008 году и не поддерживается автором проекта и не устанавливается в Dokuwiki старше 2020 года. Внесенные небольшие правки в код автора (без его разрешения), следуя рекомендациям кода авторов Dokuwiki и этот замечательный плагин вновь функционирует в 2025 году.

Примеры/Использование

Синтаксис

  • {foldericon} will add {foldericon}
  • {imageicon} will add {imagericon}
  • {peopleicon} will add {peopleicon}
  • {soundicon} will add {soundicon}
  • {videoicon} will add {videoicon}
  • {zipicon} will add {zipicon}

Редактирование

Плагин совсем небольшой и состоит из исполняющего код файла syntax.php, файла лицензии и папки images с иконками

Редактируем файл syntax.php (стр. 46 и 50)

index.php
    function handle($match, $state, $pos, &$handler) {  
    	return array($match, $state, $pos);
    }
 
    function render($mode, &$renderer, $data) {

заменим на

index.php
    function handle($match, $state, $pos, Doku_Handler $handler) {  
    	return array($match, $state, $pos);
    }
 
    function render($mode, Doku_Renderer $renderer, $data) {

Да, всего лишь & меняем на Doku_Renderer и сохраняем файл.
упаковываем в архив zip и устанавливаем через менеджер плагинов в Dokuwiki 2024-02-06 «Kaos» Мы видем подсказку об успешной установке плагина Используем синтаксис плагина в редакторе страниц для вставки иконки согласно документации автора И добавленные иконки при предварительном просмотре страницы.
На этом редактирование закончено и плагин можно использовать в Dokuwiki 2024-02-06 «Kaos»

Обновление

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

Добавление плагина в меню

Создадим в папке плагина inserticon путь: dokuwiki/lib/plugins/inserticon файл скрипта script.js и запишем в него код для наших кнопок

script.js
/* JavaScript function to create color toolbar in Dokuwiki */
/* see http://www.dokuwiki.org/plugin:color for more info */
 
icon_icobase = "../../plugins/inserticon/images/";
 
if(window.toolbar != undefined) {
    toolbar[toolbar.length] = {
    "type":"picker",
    "title":"Insert icon",
    "icon":icon_icobase+"toolbar_icon.png",
    "list":[
{"type":"format", "title":"foldericon", "icon":icon_icobase+"folder.png", "open":"{", "close":"}" },
{"type":"format", "title":"imageicon", "icon":icon_icobase+"image.png", "open":"{", "close":"}" },
{"type":"format", "title":"soundicon", "icon":icon_icobase+"sound.png", "open":"{", "close":"}" },
{"type":"format", "title":"videoicon", "icon":icon_icobase+"video.png", "open":"{", "close":"}" },
{"type":"format", "title":"peopleicon", "icon":icon_icobase+"people.png", "open":"{", "close":"}" },
{"type":"format", "title":"zipicon", "icon":icon_icobase+"zip.png", "open":"{", "close":"}" }
	]
  };
}

Сохраним и очистим кэш local.php

Открываем панель редактирования страницы и раскрываем наше новое меню с иконками и вставляем на страницу Результат работы плагина с кнопкой в меню редактора

Дополнения и Файлы

Icons are from the Tango Project, licensed under the Creative Commons Attribution Share-Alike license, and from the GNOME project, licensed under the GPL-2. Далее приведена ссылка загрузки на оригинальный плагин (для ознакомления с кодом - не совместим с Dokuwiki в 2025году):

Ссылка загрузки рабочей в 2025 году версии плагина. После загрузки

Ссылка загрузки рабочей в 2025 году версии плагина со скриптом для меню

:!: Примечание: После загрузки любого из архивов, его перед установкой необходимо переименовать в inserticon_1_.tar.gz –> inserticon.tar.gz
inserticonnavkaos.zip –> inserticon.zip

Лицензия

Только авторизованные участники могут оставлять комментарии.
wiki/plugin/inserticon.txt · Последнее изменение: 2025/01/18 12:52 — vladpolskiy