UverseWiki

Форматтер 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>
PHP
<?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).