Форматтер (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) текст%%" |
Внимание! «текст» ¶ |