Следующая версия | Предыдущая версия |
wiki:smileys [2022/07/21 10:39] – создано - внешнее изменение 127.0.0.1 | wiki:smileys [2025/01/14 12:50] (текущий) – [Примечания и подсказки] vladpolskiy |
---|
===== Использование ===== | ===== Использование ===== |
| |
Вы можете использовать в синтаксисе «[[dokuwiki|ДокуВики]]» специальные ключевые слова, которые будут конвертироваться в смайлики и иконки. | [[wiki:DokuWiki|Докувики]] может преобразовывать текстовые смайлики в их графический эквивалент. [[.:syntax#Преобразование текста в изображение|Изображения по умолчанию]] и пользовательские изображения автоматически отображаются в окне выбора смайликов на [[wiki:toolbar|панели инструментов]]. |
| |
Смайлики и иконки находятся в директории ''lib/images/smileys/'' и настраиваются с помощью файлa ''conf/smileys.conf''. Вы также можете создавать свои собственные смайлики и иконки. Для этого можно редактировать ''conf/smileys.conf'' файл, но рекомендуется создать ''conf/smileys.local.conf'', чтобы впоследствии не было проблем при [[.:install:upgrade|обновлении]]. | Изображения смайликов по умолчанию хранятся в каталоге ''%%lib/images/smileys/%%'' и настраиваются в [[wiki:devel:smileys.conf|conf/smileys.conf]] файле. Администраторы вики могут настраивать свои собственные смайлики, см. Ниже. |
| |
===== Настройка смайликов ===== | Вместо использования пиксельной графики на основе gif в версиях DokuWiki, начиная с выпуска Igor 2022, используются смайлики SVG, основанные на проекте [[https://twemoji.twitter.com/|Twemoji]]. |
| |
To add your own smileys, and make them upgrade-safe as well, you should follow these instructions instead of mixing them with the default-smileys from Dokuwiki-package: | =====Настройка смайликов===== |
| |
- Create a new folder called ''local'' inside the smileys-dir <code>lib/images/smileys/local</code> and put the imagefiles into it (make sure the images are readable by the webserver) | Чтобы добавить свои собственные смайлики, а также защетить их от перезаписи при [[wiki:install:upgrade|обновлении]], вы должны следовать этим инструкциям, а не смешивать их со смайликами по умолчанию из пакета докувики: |
- Create a custom smiley-config file at <code>conf/smileys.local.conf</code> and prefix each image filename with "''local/''..." | |
| |
An example configfile could look like this: <code> | * Создайте новую папку с именем local внутри папки smileys <code>lib/images/smileys/local</code> |
# Custom Smileys | и поместите в него файлы изображений (убедитесь, что изображения доступны для чтения веб-сервером). По умолчанию смайлики в докувики имеют высоту около 24 пикселей. |
# Images are seend from the smiley directory lib/images/smileys/ | * Создайте пользовательский файл конфигурации смайликов по адресу <code>conf/smileys.local.conf</code> и поместите туда ваши комбинации смайдликов с именем файла изображения (имя файла изображения должно начинатся с ''local/''). |
# TEXT_TO_REPLACE FILENAME_OF_IMAGE | |
| Пример файла конфигурации может выглядеть следующим образом: |
| <code - conf/smileys.local.conf> |
| # Пользовательские смайлики |
| # Изображения отображаются по относительному адресу из каталога смайликов lib/images/smileys/ |
| # ТЕКСТ_ДЛЯ_ЗАМЕНЫ ФАЙЛ_ИЗОБРАЖЕНИЯ |
# | # |
:MYFACE: local/i_am_so_pretty.jpg | :MYFACE: local/i_am_so_pretty.png |
| |
| # или удалите смайлик, указав ключ, без пути к изображению. |
| DELETEME |
</code> | </code> |
| |
===== Заметки и приёмы ===== | =====Примечания и подсказки===== |
| |
* It is good practice to surround your own text macros with colons ('':''), like '':REPLACEME:'' | * Хорошей практикой считается окружать свои собственные текстовые макросы двоеточиями ('':''), например '':REPLACEME:'' |
* You can't use ''#'' or ''$'' in the configuration file. | * Поскольку символ ''#'' (хэш) зарезервирован для обозначения строки комментария, он должен быть экранирован обратной косой чертой (''\#''). Символ ''$'' (доллар) не может быть использован в кофигурационном файле. |
* If your newly added smiley does not appear in your edit toolbar popup, it is almost always a problem of [[caching]]. You may have to [[devel:caching|purge the cache]], then refresh your page. | * Если ваш недавно добавленный смайлик не отображается во всплывающем окне панели инструментов редактирования, это почти всегда проблема [[wiki:caching|кэширования]]. Возможно, вам придется [[wiki:caching#Очистка кэша|очистить кеш]], а затем обновить страницу. |
| * Убедитесь, что при добавлении в статью вики перед и после смайлика есть пробел (например, Test :NEW: smiley). |
| |
===== Дополнительные смайлики ===== | ===== Дополнительные смайлики от пользователей ===== |
| |
dokuwiki-смайлики-местные | Следующие смайлики были созданы пользователями Докувики, используя стиль, аналогичный стандартным. Если они вам нравятся, поместите их в свой каталог смайликов и настройте конфигурационный файл. |
Перекомпиляция пакетов смайлов для использования в «Докувики». | |
| |
Небольшой PHP-скрипт для легкого создания ваших собственных пакетов смайликов/тегов/ярлыков conf/smileys.local.confс помощью простого копирования и вставки из вашего собственного браузера. | ^ Изображение смайлика ^ Создатель ^ |
| | {{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]]| |
| |
(http://YourDOKUWIKI.URL/lib/images/smileys/local/index.php) | ===== Дополнительные пакеты смайликов ====== |
| |
Быстрый старт | Следующие наборы смайликов были созданы пользователями DokuWiki, используя стиль, аналогичный стандартным. Если они вам нравятся, поместите их в свой локальный каталог смайликов (lib/images/smileys/local) и создайте / скопируйте / настройте конфигурационный файл (conf/smileys.local.conf). Не забудьте обновить ''%%conf/local.php%%'' чтобы обновить кэш редактора WYSIWYG. |
Создайте lib/images/smileys/local/папку и клонируйте туда этот репозиторий. | |
| |
cd ./lib/images/smileys/ | ^ Пакет изображений смайликов ^ url ^ Создатель ^ |
mkdir local | | {{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]]| |
cd local | | {{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]]| |
git clone https://github.com/davidjimenez75/dokuwiki-smileys-local/ ./ | | {{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]]| |
Скопируйте smileys.local.confвconf/smileys.local.conf | | {{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]]| |
| |
Нажмите conf/local.php, чтобы обновить кеш редактора «Докувики». | Больше примеров на https://github.com/davidjimenez75/dokuwiki-smileys-local |
| |
WYSIWYG Редактор «Докувики» | |
Сравнение смайликов Dokuwiki по умолчанию, EmojiOne и OpenMoji | |
Просто скопируйте корневую папку smileys.local.confвconf/smileys.local.conf | |
| |
Не забудьте коснуться файла, conf/local.phpчтобы обновить кеш редактора «Докувики». ;) | ===== Смотри таже ===== |
| |
WYSIWYG смайлики | * [[wiki:config|Настройка Докувики]] |
| |
WYSIWYG-редактор | |
Пример с установленными пакетами значков "emojione-smileys" + "dokuwiki-tags-en". | |
| |
WYSIWYG смайлики | |
| |
Наборы смайликов | |
dokuwiki-tags-ru | |
смайлики докувики | |
| |
смайлики | |
смайлики докувики | |
| |
emojione-smileys (просто замените стандартные смайлики Dokuwiki) | |
смайлики докувики | |
| |
github-теги-ru | |
смайлики докувики | |
| |
icons8 (svg) | |
смайлики докувики | |
| |
openmoji32-faces | |
смайлики докувики | |
| |
openmoji32-smileys (просто замените смайлики dokuwiki по умолчанию) | |
смайлики докувики | |
| |
Настройка смайлов (официальная информация Dokuwiki) | |
https://www.dokuwiki.org/smileys | |
| |
Чтобы добавить свои собственные смайлики, а также сделать их безопасными для обновления, вам следует следовать этим инструкциям, а не смешивать их со смайликами по умолчанию из пакета Dokuwiki: | |
| |
Создайте новую папку с именем localвнутри smileys-dir lib/images/smileys/local/и поместите в нее файлы изображений (убедитесь, что изображения доступны для чтения веб-сервером) | |
Создайте собственный файл конфигурации смайликов по адресу conf/smileys.local.confи добавьте к каждому имени файла изображения префиксlocal/ | |
An example configuration file could look like this: <code> | |
# Custom Smileys | |
# Images are seen relatively from the smiley directory lib/images/smileys/ | |
# TEXT_TO_REPLACE FILENAME_OF_IMAGE | |
# | |
:MYFACE: local/i_am_so_pretty.jpg | |
| |
# or eventually disable a smiley by mentioning the key, without image path. | |
DELETEME | |
Авторы и лицензии | |
Пакет смайлов Веб-сайт Репо Лицензия | |
иконки8 https://icons8.com гитхаб Лицензия хорошего мальчика | |
опенмоджи https://openmoji.org/about/ гитхаб CC BY-SA 4.0 | |
смайлик https://www.joypixels.com/ github заархивировано - github Бесплатная лицензия | |
докувики Пак создал сам гитхаб CC BY-SA 4.0 | |
гитхаб Пак создал сам гитхаб CC BY-SA 4.0 | |
Часто задаваемые вопросы | |
Я не вижу новые смайлики в редакторе Докувики. | |
Редактирование smileys.local.confиногда не работает из-за проблем с кешем, попробуйте коснуться даты conf/local.phpи перезагрузить «Докувики» (Ctrl + F5). | |
| |
Я хочу создать свой собственный пакет значков. | |
Просто создайте новую папку со своими смайликами, запустите генератор конфигурации в своем браузере , нажмите на свою папку, выберите содержимое и скопируйте его в свой(http://YourDOKUWIKI.URL/lib/images/smileys/local/index.php)(Ctrl + A)conf/smileys.local.conf | |
| |
Все папки пакетов значков предварительно просматриваются при загрузке. | |
| |
Что означает текст #ПОВТОР? | |
Есть еще смайлик с таким же текстом на замену. | |
| |
Могу ли я создать собственный проект/персональный (TAGS) | |
По умолчанию «Докувики» использует :TAGS: | |
| |
Но вы можете отредактировать index.php, чтобы сгенерировать conf/smileys.local.confсвои собственные символы. | |
| |
// CONFIG | |
$smileStringStart =':'; // prefix for smileys by default is : | |
$smileStringEnd =':'; // suffix for smileys by default is : | |
Вы также можете вручную отредактировать conf/smileys.local.confтекст для замены в первом столбце. | |
| |
Пример GTD "(TAGS)": | |
| |
(ACTION) local/dokuwiki/action.gif | |
(TO-DO) local/dokuwiki/to-do.gif | |
(NEXT) local/dokuwiki/next.gif | |
(SOMEDAY) local/dokuwiki/someday.gif | |
(WAITING) local/dokuwiki/waiting.gif | |
(FINISHED) local/dokuwiki/finished.gif | |
Могу ли я использовать GTD :TAGS: в своей «Докувики», чтобы отслеживать свои списки задач? | |
С помощью инструмента поиска Dokuwiki легко отслеживать :TAGS: | |
| |
Я использовал это в своей собственной Dokuwiki: | |
| |
:ACTION: local/dokuwiki/action.gif | |
:TO-DO: local/dokuwiki/to-do.gif | |
:NEXT: local/dokuwiki/next.gif | |
:SOMEDAY: local/dokuwiki/someday.gif | |
:WAITING: local/dokuwiki/waiting.gif | |
:FINISHED: local/dokuwiki/finished.gif | |
Я хочу отключить некоторые смайлики по умолчанию | |
Добавьте текст для замены к этим смайликам в нижней части вашего conf/smileys.local.conf | |
| |
# DISABLED | |
| |
FIXME | |
DELETEME | |
<WRAP center round download 60%> | |
{{ :wiki:setting:dokuwiki-smileys-local-master.zip |блок «Скачивание»}} | |
</WRAP> | |
https://github.com/davidjimenez75/dokuwiki-smileys-local | |
| |