DokuWiki

It's better when it's simple

Инструменты пользователя

Инструменты сайта


ru:entities

Это старая версия документа!


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

«ДокуВики» может заменять различные последовательности символов на их типографские эквиваленты.

Т. е.

<<  на « 
>>  на » 
=>  на ⇒

См. также синтаксис типографских символов.

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

Подробная информация о преобразованиях хранится в файле conf/entities.conf. Чтобы избежать перезаписи ваших изменений при обновлении ДокуВики, вы должны поместить свои собственные дополнения в новый файл под названием conf/entities.local.conf.

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

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

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

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

conf/entities.local.conf
=> ▶

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

Несмотря на то, что по умолчанию система последовательностей используется только для простых замен символов, её также может использоваться для вставки более сложных конструкций. Это включает в себя HTML-последовательности. Однако вы должны знать, что некоторых случаях это может привести к сбою отображения замены (например, при экспорте страницы в ODT). Рекомендуется использовать символы UTF-8 вместо них, когда это возможно.

Обязательно прочитайте о кодировке UTF-8 перед редактированием файла конфигурации.

Примеры конфигураций

Механизм последовательностей можно использовать для адаптации ДокуВики к некоторым правилам французской типографии, которые требуют неразрывных пробелов перед или после некоторых знаков препинания.

conf/entities.local.conf
<< &laquo;&nbsp;
? &nbsp;?
: &nbsp;:
! &nbsp;!
; &nbsp;;
>> &nbsp;&raquo;

Чтобы добавить последовательности для символов эсперанто, которых нет в стандартной латинской раскладке, используйте следующее:

conf/entities.local.conf
 CX  Ĉ     cx   ĉ
 GX  Ĝ     gx   ĝ
 HX  Ĥ     hx   ĥ
 JX  Ĵ     jx   ĵ
 SX  Ŝ     sx   ŝ
 UX  Ŭ     ux   ŭ

Использование знака хэш (#), не в качестве комментария

В conf/entities.local.conf знак # (хэш) используется для начала комментариев. Если вы хотите использовать его как обычный символ, вы должны экранировать его с помощью обратной косой черты (\#). Например:

conf/entities.local.conf
~~noheader~~      <style> \#dokuwiki__header { display: none; } </style>

Смотри также

ru/entities.1677642414.txt.gz · Последнее изменение: 2023-03-01 04:46 — 92.37.142.245

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki