Форматтер Mirror
Этот форматтер очень полезен для демонстрации процесса форматирования в какую-то
разметку — он создаёт таблицу, в левой колонке у которой исходный текст, а в правой
он же, но отформатированный. Таким образом можно легко сравнить исходник и понять,
что из него получается.
¶
Примеры¶
Форматирование текста с вики-разметкой:
¶
%%(mirror)
Вот так --
форматируется
**вики-текст**.
%%
|
Вот так --
форматируется
**вики-текст**.
|
Вот так —
форматируется
вики-текст.
¶
|
|
Главное правильно экранировать «%%» с помощью тильды — иначе %% будет считаться
концом внешнего блока %%(mirror), а не внутреннего и разметка нарушится:
¶
%%(mirror)
%%(mirror)
Текст...
%%
%%
|
%%(mirror)
Текст...
|
%%(mirror)
Текст…
¶
|
%%
¶
|
В примере выше ошибка, так как вложенный блок имеет столько тильд, какой у него
уровень — здесь она должна быть одна (см. также синтаксис форматтеров в
вики-разметке):
¶
%%(mirror)
%%(mirror)
Заметьте -
снизу тильда.
~%%
%%
|
%%(mirror)
Заметьте -
снизу тильда.
%%
|
Заметьте -
снизу тильда.
|
Заметьте —
снизу тильда.
¶
|
|
|
Можно также форматировать в любой другой существующий формат:
¶
%%(mirror; php)
<?php
require 'header.php';
printf( 'Привет, %s!', $_SERVER['PHP_AUTH_USER'] );
?>
</body>
</html>
%%
|
<?php
require 'header.php';
printf( 'Привет, %s!', $_SERVER['PHP_AUTH_USER'] );
?>
</body>
</html>
|
|
|
Рекомендуется вкладывать не больше 3-х форматтеров — технически предела
вложенности нет, но внешний вид страницы может нарушиться.
¶
%%(отразить)
%%(mirror)
%%(mirror)
Альтернативные названия¶
К этому форматтеру можно также обращаться по названиям «отразить» и «отражение».
Регистр символов значения не имеет:
¶
%%(ОТРАЗИТЬ; html)
<!DOCTYPE html>
<html>
%%
|
<!DOCTYPE html>
<html>
|
<!DOCTYPE html>
<html>
|
|
Вы можете задать свои имена в файле style_aliases.conf. Там же задаётся
форматтер по-умолчанию (в который mirror форматирует текст, если после точки с запятой
не передано никакого имени, в примере выше это html).
¶
Начало
