Различия

Показаны различия между двумя версиями страницы.

--- ru:smileys [2010-09-07 20:53] – Aleksandr
+++ ru:smileys [2013-03-20 10:37] – Aleksandr
@@ Строка 1: / Строка 1: @@
 ====== Смайлики ======
+===== Использование =====
 Вы можете использовать в синтаксисе «[[dokuwiki|ДокуВики]]» специальные ключевые слова, которые будут конвертироваться в смайлики и иконки.
@@ Строка 5: / Строка 7: @@
 Смайлики и иконки находятся в директории ''lib/images/smileys/'' и настраиваются с помощью файлa ''conf/smileys.conf''. Вы также можете создавать свои собственные смайлики и иконки. Для этого можно редактировать ''conf/smileys.conf'' файл, но рекомендуется создать ''conf/smileys.local.conf'', чтобы впоследствии не было проблем при [[.:install:upgrade|обновлении]].
-===== Кое-какие дополнительные иконки =====
+===== Настройка смайликов =====
+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)
+  - 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>
+# Custom Smileys
+# Images are seend from the smiley directory lib/images/smileys/
+# TEXT_TO_REPLACE       FILENAME_OF_IMAGE
+#
+:MYFACE:                local/i_am_so_pretty.jpg
+</code>
+===== Заметки и приёмы =====
+  * It is good practice to surround your own text macros with colons ('':''), like '':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.
+===== Дополнительные смайлики =====
 ^  Первоначальный вариант  ^  Варианты переведённых иконок  ^