| Следующая версия | Предыдущая версия |
| 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 | |
| |