====== Смайлики ======
===== Использование =====
[[wiki:DokuWiki|Докувики]] может преобразовывать текстовые смайлики в их графический эквивалент. [[.:syntax#Преобразование текста в изображение|Изображения по умолчанию]] и пользовательские изображения автоматически отображаются в окне выбора смайликов на [[wiki:toolbar|панели инструментов]].
Изображения смайликов по умолчанию хранятся в каталоге ''%%lib/images/smileys/%%'' и настраиваются в [[wiki:devel:smileys.conf|conf/smileys.conf]] файле. Администраторы вики могут настраивать свои собственные смайлики, см. Ниже.
Вместо использования пиксельной графики на основе gif в версиях DokuWiki, начиная с выпуска Igor 2022, используются смайлики SVG, основанные на проекте [[https://twemoji.twitter.com/|Twemoji]].
=====Настройка смайликов=====
Чтобы добавить свои собственные смайлики, а также защетить их от перезаписи при [[wiki:install:upgrade|обновлении]], вы должны следовать этим инструкциям, а не смешивать их со смайликами по умолчанию из пакета докувики:
* Создайте новую папку с именем local внутри папки smileys lib/images/smileys/local
и поместите в него файлы изображений (убедитесь, что изображения доступны для чтения веб-сервером). По умолчанию смайлики в докувики имеют высоту около 24 пикселей.
* Создайте пользовательский файл конфигурации смайликов по адресу conf/smileys.local.conf
и поместите туда ваши комбинации смайдликов с именем файла изображения (имя файла изображения должно начинатся с ''local/'').
Пример файла конфигурации может выглядеть следующим образом:
# Пользовательские смайлики
# Изображения отображаются по относительному адресу из каталога смайликов lib/images/smileys/
# ТЕКСТ_ДЛЯ_ЗАМЕНЫ ФАЙЛ_ИЗОБРАЖЕНИЯ
#
:MYFACE: local/i_am_so_pretty.png
# или удалите смайлик, указав ключ, без пути к изображению.
DELETEME
=====Примечания и подсказки=====
* Хорошей практикой считается окружать свои собственные текстовые макросы двоеточиями ('':''), например '':REPLACEME:''
* Поскольку символ ''#'' (хэш) зарезервирован для обозначения строки комментария, он должен быть экранирован обратной косой чертой (''\#''). Символ ''$'' (доллар) не может быть использован в кофигурационном файле.
* Если ваш недавно добавленный смайлик не отображается во всплывающем окне панели инструментов редактирования, это почти всегда проблема [[wiki:caching|кэширования]]. Возможно, вам придется [[wiki:caching#Очистка кэша|очистить кеш]], а затем обновить страницу.
* Убедитесь, что при добавлении в статью вики перед и после смайлика есть пробел (например, Test :NEW: smiley).
===== Дополнительные смайлики от пользователей =====
Следующие смайлики были созданы пользователями Докувики, используя стиль, аналогичный стандартным. Если они вам нравятся, поместите их в свой каталог смайликов и настройте конфигурационный файл.
^ Изображение смайлика ^ Создатель ^
| {{wiki:usersmileys:new.gif}} | [[tobia.conforto@linux.it|Toby]] |
| {{wiki:usersmileys:todo.gif}} | [[tobia.conforto@linux.it|Toby]] |
| {{wiki:usersmileys:button-danger-yellow.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-delete-yellow.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-fixme-yellow.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-note-yellow.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-todo-yellow.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-warning-yellow.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-danger-red.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-delete-red.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-fixme-red.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-note-red.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-todo-red.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-warning-red.png}} | [[kwl7@cornell.edu|Kevin Locke]] |
| {{http://wiki.guug.de/lib/images/smileys/local/todo.gif?80x15}} | [[http://www.unixwitch.de|Hella Breitkopf]]|
| {{http://wiki.guug.de/lib/images/smileys/local/done.gif?80x15}} | [[http://www.unixwitch.de|Hella Breitkopf]]|
| {{http://savoirscom1.comptoir.net/lib/images/smileys/todo_button.png}} | [[user>cyrille37|Cyrille37]] |
| Different sets: [[https://github.com/davidjimenez75/dokuwiki-smileys-local|dokuwiki-smileys-local]] | [[user>davidjimenez75|Davidjimenez75]]|
===== Дополнительные пакеты смайликов ======
Следующие наборы смайликов были созданы пользователями DokuWiki, используя стиль, аналогичный стандартным. Если они вам нравятся, поместите их в свой локальный каталог смайликов (lib/images/smileys/local) и создайте / скопируйте / настройте конфигурационный файл (conf/smileys.local.conf). Не забудьте обновить ''%%conf/local.php%%'' чтобы обновить кэш редактора WYSIWYG.
^ Пакет изображений смайликов ^ url ^ Создатель ^
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/dokuwiki-tags-en/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|dokuwiki-tags-en]] | [[user>davidjimenez75|Davidjimenez75]]|
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/emojione-faces/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|emojione-faces]] | [[user>davidjimenez75|Davidjimenez75]]|
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/github-tags-en/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|github-tags-en]] | [[user>davidjimenez75|Davidjimenez75]]|
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/openmoji32-faces/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|openmoji32-faces]] | [[user>davidjimenez75|Davidjimenez75]]|
Больше примеров на https://github.com/davidjimenez75/dokuwiki-smileys-local
===== Смотри таже =====
* [[wiki:config|Настройка Докувики]]