Различия

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

--- ru:entities [2014-09-19 16:44] – 213.234.238.122
+++ ru:entities [2023-03-01 05:12] (текущий) – Aleksandr
@@ Строка 1: / Строка 1: @@
 ====== Последовательности ======
-<<[[dokuwiki|ДокуВики]]>> может заменять различные последовательности символов на их типографские эквиваленты.
+<<[[dokuwiki|Докувики]]>> может заменять различные последовательности символов на их типографские эквиваленты.
 Т. е.
@@ Строка 12: / Строка 12: @@
 См. также синтаксис [[ru:wiki:syntax#типографские_символы|типографских символов]].
-Детали преобразования хранятся в файле ''conf/entities.conf''. Вы сами можете добавить свои преобразования последовательностей, поместив их в файл ''conf/entities.local.conf''. Также можно редактировать непосредственно файл ''conf/entities.conf'', однако это может привести к потере ваших изменений при [[.:install:upgrade|обновлении]].
+===== Изменение / отключение замен последовательностей =====
-===== Примеры =====
+Подробная информация о преобразованиях хранится в файле ''[[https://github.com/dokuwiki/dokuwiki/blob/master/conf/entities.conf|conf/entities.conf]]''. Чтобы избежать перезаписи ваших изменений при [[ru:install:upgrade|обновлении]] Докувики, вы должны поместить свои собственные дополнения в новый файл под названием ''%%conf/entities.local.conf%%''.
-> It seems that it is possible to use this table to adapt DokuWiki to some French typography rules that necessitate non-breaking spaces before or after some punctuation marks. For example, in the ''conf/entities.conf'' file, I write rules like this:
+Последовательности заданные в файле ''%%conf/entities.local.conf%%'' имеют приоритет перед последовательностями заданными в файле ''%%conf/entities.local.conf%%''. Поэтому, если вам нужно заменить  определённую последовательность заданную по умолчанию, вы можете сделать это, добавив в файл ''%%conf/entities.local.conf%%'' шаблон последовательности, который вы хотите изменить и символ, который нужно использовать в качестве замены. Если, последовательность нужно отключить, просто не указвайте символ замены.
-  << &laquo;&nbsp;
+Например, если вы не хотите, чтобы буква ''c'' в скобках автоматически заменялась знаком авторского права, добавьте следующие изменения:
-  ? &nbsp;?
-  : &nbsp;:
-  ! &nbsp;!
-  ; &nbsp;;
-> To use typography for [[wp>esperanto|esperanto]] x-writing:
+<code - conf/entities.local.conf>
+(c)
+# теперь замена отключена
+</code>
-  cx	─Й
+или, если вы предпочитаете другую стрелку
-  Cx	─И
-  CX	─И
-  gx	─Э
-  Gx	─Ь
-  GX	─Ь
-  hx	─е
-  Hx	─д
-  HX	─д
-  jx	─╡
-  Jx	─┤
-  JX	─┤
-  sx	┼Э
-  Sx	┼Ь
-  SX	┼Ь
-  ux	┼н
-  Ux	┼м
-  UX	┼м
->>The typography for esperanto writing did not show right in the code section above; for those interested these are the characters as they should be displayed: (--- //[[visuallucho_plusplus@yahoo.es|'Ryan Chappelle']] 2008/05/28 06:04//)
+<code - conf/entities.local.conf>
-  CX  Ĉ     cx   ĉ
+=> ▶
-  GX  Ĝ     gx   ĝ
+</code>
-  HX  Ĥ     hx   ĥ
-  JX  Ĵ     jx   ĵ
-  SX  Ŝ     sx   ŝ
-  UX  Ŭ     ux   ŭ
-===== Редактирование файлов =====
+Чтобы изменения конфигурации вступили в силу на страницах, [[ru:devel:caching|кэш должен быть очищен]].
-Как указано в ''entities.conf'', вы можете использовать HTML-последовательности в своих подстановках, но это не рекомендуется из-за того, что при не-HTML отображении. Таким образом, вместо этого лучше использовать символы UTF-8. Для этого либо используйте текстовые редакторы, «понимающие» UTF-8, такие как [[SourceForge>projects/notepad-plus|notepad++]], либо шестнадцатеричные редакторы, такие как [[SourceForge>projects/hexplorer/|hexplorer]] и [[http://www.unicode.org/Public/5.2.0/ucd/|UTF-8 character map]].
+Несмотря на то, что по умолчанию система последовательностей используется только для простых замен символов, её также может использоваться для вставки более сложных конструкций. Это включает в себя HTML-последовательности. Однако вы должны знать, что некоторых случаях это может привести к сбою отображения замены (например, при экспорте страницы в [[plugin:ODT)]]. Рекомендуется использовать символы UTF-8 вместо них, когда это возможно.
-Однако, обычные текстовые редакторы **НЕ** должны использоваться, т. к. некоторые символы, используемые в кодировании UTF-8, недоступны на обычной клавиатуре.
+Обязательно прочитайте о кодировке [[ru:UTF-8|UTF-8]] перед редактированием файла конфигурации.
+===== Примеры конфигураций=====
+Механизм последовательностей можно использовать для адаптации «Докувики» к некоторым правилам французской типографии, которые требуют неразрывных пробелов перед или после некоторых знаков препинания.
+<code - conf/entities.local.conf>
+<< &laquo;&nbsp;
+? &nbsp;?
+: &nbsp;:
+! &nbsp;!
+; &nbsp;;
+>> &nbsp;&raquo;
+</code>
+Чтобы добавить последовательности для символов [[wpru>эсперанто]], которых нет в стандартной латинской раскладке, используйте следующее:
+<code - conf/entities.local.conf>
+ CX  Ĉ     cx   ĉ
+ GX  Ĝ     gx   ĝ
+ HX  Ĥ     hx   ĥ
+ JX  Ĵ     jx   ĵ
+ SX  Ŝ     sx   ŝ
+ UX  Ŭ     ux   ŭ
+</code>
+===== Использование знака решётки (#) не в качестве комментария =====
+В ''%%conf/entities.local.conf%%'' знак ''#'' (решётка) используется для начала комментариев. Если вы хотите использовать его как обычный символ, вы должны экранировать его с помощью обратной косой черты (''\#''). Например:
+<code - conf/entities.local.conf>
+~~noheader~~      <style> \#dokuwiki__header { display: none; } </style>
+</code>
-В частности, эквивалентом символа ≠ (HTML: &ne;) в UTF-8 является последовательность байт 0xE2; 0x89; 0xA0; И байт 0xA0 отображается как обычный пробел, хотя и не является таковым.
+===== Смотри также =====
-Так же **НЕ** пытайтесь вычислить сами UTF-8 (если не представляете, как устроен UTF-8) --- ваша подстановка может не заработать.
+  * [[ru:config|Настройка «Докувики»]]