Это старая версия документа!
Содержание
Последовательности
«ДокуВики» может заменять различные последовательности символов на их типографские эквиваленты.
Т. е.
<< на « >> на » => на ⇒
См. также синтаксис типографских символов.
Изменение / отключение замен последовательностей
Подробная информация о преобразованиях хранится в файле 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) # теперь замена отключена
или, если вы предпочитаете другую стрелку
Чтобы изменения конфигурации вступили в силу на страницах, кэш должен быть очищен.
Несмотря на то, что по умолчанию система последовательностей используется только для простых замен символов, её также может использоваться для вставки более сложных конструкций. Это включает в себя HTML-последовательности. Однако вы должны знать, что некоторых случаях это может привести к сбою отображения замены (например, при экспорте страницы в ODT). Рекомендуется использовать символы UTF-8 вместо них, когда это возможно.
Обязательно прочитайте о кодировке UTF-8 перед редактированием файла конфигурации.
Примеры конфигураций
Механизм последовательностей можно использовать для адаптации ДокуВики к некоторым правилам французской типографии, которые требуют неразрывных пробелов перед или после некоторых знаков препинания.
- conf/entities.local.conf
<< « ? ? : : ! ! ; ; >> »
Чтобы добавить последовательности для символов эсперанто, которых нет в стандартной латинской раскладке, используйте следующее:
- 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>