Форматтер (formatter) — это вставка в документ «инородного» содержимого, то есть
имеющего формат, отличный от основного формата документа.
Например, для страницы, что сейчас у вас перед глазами, основной формат (разметка) —
вики. Однако ничто не мешает вставить пару-тройку листингов на HTML или Delphi — заметьте,
без нарушения разметки (это был камень в огород BB-кода :)).
¶
Форматтерам можно передавать параметры, об этом подробнее здесь, а также
они могут быть сцепленными.
Ещё больше о форматтерах можно прочитать в документации. См. также раздел о
действиях. Имена стилей могут иметь альтернативные названия.
¶
Их ещё называют многострочными, хотя они могут состоять и из одной строки. ¶
Для его задания используется двойной процент %%, после которого в скобках может
идти название языка или другое имя для типа текста, заключённого между %%.
Оба %% должны быть на отдельных строках, причём перед ними допускаются пробелы.
Если стиль опущен, то используется умолчательный — здесь это просто моноширный шрифт
без вики- или какой-либо другой разметки. Регистр стиля не важен.
¶
%%
Моноширный текст,
**разметка** отключена.
%%
%%(html)
<!DOCTYPE html>
<html>
<head>
<style type="text/css">
.myClass { font-family: "Consolas"; }
</style>
%%
|
Моноширный текст, **разметка** отключена.
<!DOCTYPE html>
<html>
<head>
<style type="text/css">
.myClass { font-family: "Consolas"; }
</style>
|
Если нужно указать внутри кода двойной процент, то перед ним нужно поставить тильду, чтобы эти символы не считались закрывающими: ¶
%%(отразить)
%%(DELPHI)
WriteLn('Hellold!');
~%%
Обратите внимание на тильду сверху.
%%
|
|
Во всех других случаях тильда внутри блока %% игнорируется полностью. Также можно задавать сколько угодно тильд в зависимости от уровня вложенности: ¶
%%(отразить)
%%(отразить)
%%(ini)
[Section]
~~%%
~%%
%%
|
|
UverseWiki поддерживает все подсветчики (highlighters) движка WackoWiki. Установить их можно простым копированием, как описано здесь. Например, вот wrapper_page оттуда: ¶
%%(wrapper_page wrapper_width=30) Очень узкая колонка %% |
Очень узкая колонка |
Едва ли, однако, стоит использовать обёртки WackoWiki — кроме того, что это не наглядно и смешивает представление (внешний вид документа) с его содержимым — такой метод ещё и намного ограниченнее по возможностям, нежели задание стилей для абзацев — именно их мы и рекомендуем использовать, когда нужно как-то выделить текст. ¶
С ними всё то же самое — задаются двойными процентами (%%) и могут иметь стиль в скобках. ¶
Отформатируем немного %%(XML) <XML>%%. Или просто %%текст **без разметки**%%. |
Отформатируем немного <XML>. Или просто текст **без разметки**. ¶ |
Как и с блочным форматтером, тильда внутри может отменить %%, а в других случаях игнорируется: ¶
Просто двойной процент: %%~%%%%.
Или: %%(pascal) Format('%2.1f~%%');%%
|
Просто двойной процент: %%. Или: Format('%2.1f%%'); ¶ |
Не все форматтеры могут быть выведены в строчной форме, поэтому вместо них будет выведено предупреждение: ¶
Внимание! "%%(wrapper_page) текст%%" |
Внимание! «текст» ¶ |