Смайлики

Использование

Докувики может преобразовывать текстовые смайлики в их графический эквивалент. Изображения по умолчанию и пользовательские изображения автоматически отображаются в окне выбора смайликов на панели инструментов.

Изображения смайликов по умолчанию хранятся в каталоге lib/images/smileys/ и настраиваются в conf/smileys.conf файле. Администраторы вики могут настраивать свои собственные смайлики, см. Ниже.

Вместо использования пиксельной графики на основе gif в версиях DokuWiki, начиная с выпуска Igor 2022, используются смайлики SVG, основанные на проекте Twemoji.

Настройка смайликов

Чтобы добавить свои собственные смайлики, а также защетить их от перезаписи при обновлении, вы должны следовать этим инструкциям, а не смешивать их со смайликами по умолчанию из пакета докувики:

Создайте новую папку с именем local внутри папки smileys
```
lib/images/smileys/local
```

и поместите в него файлы изображений (убедитесь, что изображения доступны для чтения веб-сервером). По умолчанию смайлики в докувики имеют высоту около 24 пикселей.

Создайте пользовательский файл конфигурации смайликов по адресу
```
conf/smileys.local.conf
```
и поместите туда ваши комбинации смайдликов с именем файла изображения (имя файла изображения должно начинатся с local/).

Пример файла конфигурации может выглядеть следующим образом:

conf/smileys.local.conf

# Пользовательские смайлики
# Изображения отображаются по относительному адресу из каталога смайликов lib/images/smileys/
# ТЕКСТ_ДЛЯ_ЗАМЕНЫ           ФАЙЛ_ИЗОБРАЖЕНИЯ
#
:MYFACE:                     local/i_am_so_pretty.png

# или удалите смайлик, указав ключ, без пути к изображению.
DELETEME

Примечания и подсказки

Хорошей практикой считается окружать свои собственные текстовые макросы двоеточиями (:), например :REPLACEME:
Поскольку символ # (хэш) зарезервирован для обозначения строки комментария, он должен быть экранирован обратной косой чертой (\#). Символ $ (доллар) не может быть использован в кофигурационном файле.
Если ваш недавно добавленный смайлик не отображается во всплывающем окне панели инструментов редактирования, это почти всегда проблема кэширования. Возможно, вам придется очистить кеш, а затем обновить страницу.
Убедитесь, что при добавлении в статью вики перед и после смайлика есть пробел (например, Test :NEW: smiley).

Дополнительные смайлики от пользователей

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

Изображение смайлика	Создатель
	Toby
	Toby
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Kevin Locke
	Hella Breitkopf
	Hella Breitkopf
	Cyrille37
Different sets: dokuwiki-smileys-local	Davidjimenez75

Дополнительные пакеты смайликов

Следующие наборы смайликов были созданы пользователями DokuWiki, используя стиль, аналогичный стандартным. Если они вам нравятся, поместите их в свой локальный каталог смайликов (lib/images/smileys/local) и создайте / скопируйте / настройте конфигурационный файл (conf/smileys.local.conf). Не забудьте обновить conf/local.php чтобы обновить кэш редактора WYSIWYG.

Пакет изображений смайликов	url	Создатель
	dokuwiki-tags-en	Davidjimenez75
	emojione-faces	Davidjimenez75
	github-tags-en	Davidjimenez75
	openmoji32-faces	Davidjimenez75

Больше примеров на https://github.com/davidjimenez75/dokuwiki-smileys-local

Смотри таже

Настройка Докувики