====== Последовательности ======

<<[[dokuwiki|Докувики]]>> может заменять различные последовательности символов на их типографские эквиваленты. 

Т. е.
<code>
<<  на « 
>>  на » 
=>  на ⇒
</code>

См. также синтаксис [[ru:wiki:syntax#типографские_символы|типографских символов]].

===== Изменение / отключение замен последовательностей =====

Подробная информация о преобразованиях хранится в файле ''[[https://github.com/dokuwiki/dokuwiki/blob/master/conf/entities.conf|conf/entities.conf]]''. Чтобы избежать перезаписи ваших изменений при [[ru:install:upgrade|обновлении]] Докувики, вы должны поместить свои собственные дополнения в новый файл под названием ''%%conf/entities.local.conf%%''.

Последовательности заданные в файле ''%%conf/entities.local.conf%%'' имеют приоритет перед последовательностями заданными в файле ''%%conf/entities.local.conf%%''. Поэтому, если вам нужно заменить  определённую последовательность заданную по умолчанию, вы можете сделать это, добавив в файл ''%%conf/entities.local.conf%%'' шаблон последовательности, который вы хотите изменить и символ, который нужно использовать в качестве замены. Если, последовательность нужно отключить, просто не указвайте символ замены.

Например, если вы не хотите, чтобы буква ''c'' в скобках автоматически заменялась знаком авторского права, добавьте следующие изменения:

<code - conf/entities.local.conf>
(c)
# теперь замена отключена
</code>

или, если вы предпочитаете другую стрелку

<code - conf/entities.local.conf>
=> ▶
</code>

Чтобы изменения конфигурации вступили в силу на страницах, [[ru:devel:caching|кэш должен быть очищен]].

Несмотря на то, что по умолчанию система последовательностей используется только для простых замен символов, её также может использоваться для вставки более сложных конструкций. Это включает в себя HTML-последовательности. Однако вы должны знать, что некоторых случаях это может привести к сбою отображения замены (например, при экспорте страницы в [[plugin:ODT)]]. Рекомендуется использовать символы 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>

===== Смотри также =====

  * [[ru:config|Настройка «Докувики»]]