Форматирование текста

Оглавление

Основы форматирования
Cсылки
Заголовки
Отступы и списки
Цитирование и определение
Сноски (footnotes)
Таблицы
Прочее
Макросы
Расширения – дополнительные форматтеры
Обёртки вокруг форматтеров

Форматирование текста в Wacko немного отличается от других вики. Поэтому стоит поглядеть на описание и примеры ниже.

Текст, заключенный в две двойные кавычки слева и справа, не форматируется, и выводится так же, как был напечатан.

Основы форматирования

полужирный	полужирный
//курсив//	курсив
__подчеркнутый__	подчеркнутый
##моноширинный## (можно использовать также №№, но это неэстетично и не приветствуется)	`моноширинный`
++Мелкий текст++	Мелкий текст
--зачеркнутый--	~~зачеркнутый~~
NB Зачеркивание, как и все следующие разметки в данном разделе, работает на многострочных текстах, в отличие от предыдущих.
Выравнивание осуществляется при помощи вот такой сложной конструкции: %%(wacko wrapper=text wrapper_align=center) текст по центру %% wrapper_align может быть center, right и justify. Можно использовать >>центрированный<<, но не рекомендуется	текст по центру
!!Замечание!! (работает также ''Замечание'', но его лучше не использовать).	Замечание
!!(blue)Текст синего цвета!! (поддерживаются три цвета: red, green, blue).	Текст синего цвета
??Вопрос??	Вопрос
%%код%%	int main(int arc,char **argv) { printf("Hello, %s!\n", (argc>1) ? argv[1] : "World"); return 0; }

Cсылки

[[http://www.webscript.ru]] или ((http://www.webscript.ru))	http://www.webscript.ru
[[http://www.webscript.ru Вебскрипт]] или ((http://www.webscript.ru Вебскрипт))	Вебскрипт^[link1]
[[Кластеры]] или ((Кластеры))	Кластеры
[[Кластеры Страница про кластеры]] или ((Кластеры Страница про кластеры))	Страница про кластеры
http://www.ya.ru подсвечивается автоматически.	http://www.ya.ru
http://www.yandex.ru/logo1.gif превратится в картинку.
((/HomePage http://www.yandex.ru/logo1.gif)) картинка, которая ссылка.
{{anchor name="test"}} объявление якоря.
((#test)) и ((/HomePage#TOC_1)) ссылки на якорь.	test и /HomePage#TOC_1

NB: слова в смешанном регистре (ВотТакие) выделять ссылками вообще не надо. Для прочих внутрисайтовых ссылок URL писать не нужно (иначе не возникает связи между двумя страницами). URL нужен лишь для внешних ссылок.

NB: чтобы ВотТакое слово не стало ссылкой, поставьте перед ним знак ~ (тильда).

NB: подробности простановки ссылок на документы, находящиеся не в корне, описаны в разделе Кластеры.

Заголовки

Отступы и списки

Отступы делаются с помощью двух пробелов (можно использовать устаревший вариант – табуляцию).
Так же нужно выделять отступом списки.


Списки:
  Отступ
    Двойной отступ
----
  * ненумерованный список
  * ненумерованный список-2
----
  1. нумерованный список
  1. нумерованный список-2
  1.#8 нумерованный список-2, с пропуском
----
  A. Верхний регистр
  A. Верхний регистр-2
----
  a. Нижний регистр
  a. Нижний регистр-2
----
  i. Римские цифры
  i. Римские цифры-2
----
  1. список
    1. вложенный список
      * ещё более вложенный список
    1. вложенный список-2
  2. список-2

Списки:

Отступ

Двойной отступ

ненумерованный список
ненумерованный список-2

нумерованный список
нумерованный список-2
нумерованный список-2, с пропуском

Верхний регистр
Верхний регистр-2

Нижний регистр
Нижний регистр-2

Римские цифры
Римские цифры-2

список
1. вложенный список
  - ещё более вложенный список
2. вложенный список-2
список-2

Цитирование и определение

<[ Цитирование текста ]>	Цитирование текста, длинного, с переносами
>>Однострочное цитирование >Да, это оно А это обычный текст	>>Однострочное цитирование >Да, это оно А это обычный текст
Неизвестное действие "a"(?Термин Некоторое определение?)	Термин
(?Термин с пробелами==Некоторое другое определение?) NB: если вокруг '==' оставить пробелы, они так же останутся в тексте страницы	Термин с пробелами

Сноски (footnotes)

Текст, потом сноска[[]] и вторая[[*]]	Текст, потом сноска^* и вторая^**
Текст, потом цифровая сноска[[1]] и вторая[[2]]	Текст, потом цифровая сноска¹ и вторая²
[[#]] Расшифровка первой сноски [[#*]] Расшифровка второй сноски [[#1]] Расшифровка цифровой сноски [[#2]] Расшифровка второй цифровой сноски	^* Расшифровка первой сноски ^** Расшифровка второй сноски ¹ Расшифровка цифровой сноски ² Расшифровка второй цифровой сноски

Таблицы

Таблица с рамкой
#|
||cell11|cell12|cell13||
||cell21|cell22||
|#

cell11	cell12	cell13
cell21	cell22

Таблица без рамок, шириной 100%
#||
||cell11|cell12|cell13||
||cell21|cell22||
||#

cell11	cell12	cell13
cell21	cell22

Прочее

Разделитель:
----

Явный перевод строки:
тест---шмест
тест
шмест

Вывод текста как есть, без применения форматирования:
текст необходимо заключить в двойные кавычки. В качестве примера можете изучить исходный текст данной страницы.
Кроме того, для экранирования любого вида разметки, можно использовать ~ (тильду).

Вывод HTML как есть:
работает только если такую функциональность разрешил администратор сайта.
<# <input type="text"> #>
<# <input type="text"> #>
Если вы видите <input type="text"> вместо поля ввода — значит, администратор сайта не разрешил данную функцию (параметр allow_rawhtml конфигурационного файла).

Верхний индекс:
E=mc^^2^^
E=mc²

NB: между ^^ не должно быть пробелов. Эта разметка создана для математики и ради компактности и совместимости не допускает наличия пробелов внутри размеченного блока

Нижний индекс:
пробелы перед и после vv обязательны Если их требуется избежать, следует использовать вместо них конструкцию """"

H vv2vv O	H ₂ O
H""""vv2vv""""O	H₂O

NB: между vv не должно быть пробелов. Эта разметка создана для математики и ради компактности и совместимости не допускает наличия пробелов внутри размеченного блока

Макросы

Макросы отличаются от остальной разметки тем, что при повторном редактировании документа вы увидите не вызов макроса, а результат его работы — они отрабатывают при сохранении текста.

Имя текущего пользователя:
::::
RomanIvanov

Имя текущего пользователя и дата:
::@::
RomanIvanov /20.06.2003 18:13/

Дата:
::+::
20.06.2003 18:13

Расширения – дополнительные форматтеры

В Wacko Wiki можно легко добавлять новые обработчики текста. Их вызов происходит по синтаксису %%(name) текст%%.
В стандартной поставке есть следующие форматтеры:

%%(wacko)текст как есть. [[HomePage]]%%
Этот форматтер выводит текст так же, как если бы он был написан без форматера. Удобен для применения дополнительных оберток к тексту (выравнивание, боксы и тому подобное. См ниже.) текст как есть. HomePage

%%(php) PHP-код%%
Важно отметить, что код должен начинаться открывающим <? и заканчиваться закрывающим ?>, так как для используемого встроенного в PHP модуля разметки синтаксиса именно эти разделители являются признаком php-кода.


<?
phpinfo();
$s = "Hello, World!\n";
print "$s";
?>

%%(comments) Комментарий, не выводится%% Formatter "highlight/comments" not found

%%(icq) Логи ICQ Pro%%


Некто Привет 14.05.20 14:52
Роман привет, ага 14.05.20 14:52
Некто экая хрень 14.05.20 14:53
Некто тестирую эту ужасную ицкупро
                               кашмар 28.06.20 2:25
Роман И не говори 28.06.20 2:25

%%(icq_l) Логи ICQ Lite%%


kukutz какой эвристикой? 01:59 AM
TTLogic wassup? 01:59 AM
kukutz оки =) 01:59 AM
kukutz ты меня видишь?

кириллик? 01:59 AM
TTLogic cool. only questions i receive 01:59 AM

%%(icq_m) Логи Miranda IM (плагин nConvers)%%


TTLogic ага, сколько-сколько у даты в пикселях? 27.06.2003 22:23:08
Роман Иванов о, сработало 27.06.2003 22:23:09
TTLogic да, я убрал 100% 27.06.2003 22:23:15
Роман Иванов >> 27.06.2003 22:23:08 TTLogic wrote:
>> ага, сколько-сколько у даты в пикселях?

померяй!! 27.06.2003 22:23:21

%%(email) Email%%

Hi!
RI>> Yes, it is.
>Are you sure?

Of course, yes!

Roman.

%%(sql) SQL-code%%

SELECT * FROM sometable WHERE a = '12' and b = 2 ORDER BY c DESC --Comment

Так же доступны форматтеры (ini), (html), (css), (pascal) и (java)

<html>
<a href="http://www.ya.ru" width="8">test</a>
</html>

[Wiki]
BestEngine="WackoWiki"
Version=4

body {margin: 0; padding:5px;}
.class {background:url("http://www.ya.ru/")}

program megaprogramme; 
{ comment }
BEGIN
 if a = 15 then writeln('test');
END.

Также существуют форматтеры для CSS, diff, DTD, Javascript, mySQL, PHP, Python, SQL, XML.
Они могут быть вызваны путем (hl [форматтер]), например, %%(hl css)

body {margin: 0; padding:5px;}
.class {background:url("http://www.ya.ru/")}

var a = document.getElementById("test");
a.value = new Array(15, 31);
function echo (msg) {alert(msg)};

<?
phpinfo();
$s = "Hello, World!\n";
print "$s";
?>

<config>
<section name="test">
  <var>Test</var>
  <val><![CDATA[..text...]]></val>
</section>
</config>

Обёртки вокруг форматтеров

Кроме того, любому форматтеру можно задать одну из "обёрток" указав ему параметр wrapper.
Доступны обёртки: box, shade, page и text.

%%(css wrapper=box wrapper_align=left wrapper_width=270) .d { font-size:70% } %%	.d { font-size:70% } Как мы видим, обёртка `box` позволяет формировать удобные "меню", обтекаемые текстом. Кстати, есть специальный форматтер (box), который не делает ничего кроме как оборачивает текст в эту обёртку.
%%(css wrapper=shade) .d2 { font-size:70% } %%	.d2 { font-size:70% } `shade` — это `box` без настроек.
%%(wacko wrapper=text wrapper_align=center) текст по центру %%	текст по центру `text` выводит "плавающий" (float) блок текста.
%%(wacko wrapper=page wrapper_width=200) этот текст не может быть шире двухсот пикселей%%	этот текст не может быть шире двухсот пикселей `page` позволяет регулировать ширину обычного блока текста.
%%(wacko wrapper=box wrapper_width=300) Box---- «A hundred times every day I remind myself that my inner and outer life depend upon the labors of other men, living and dead, and that I must exert myself in order to give in the measure as I have received and am still receiving.» - Albert Einstein %%	Box «A hundred times every day I remind myself that my inner and outer life depend upon the labors of other men, living and dead, and that I must exert myself in order to give in the measure as I have received and am still receiving.» – Albert Einstein

Код для вставки видеоролика:

{{html5vid url="https://ontheroad.dmitriev.su/flvtest/files?get=soln.mp4" width="400" height="300"}}

Страницы, ссылающиеся на данную:

ВелоМагадан^[link2]
ВсякийТрепИФлуд^[link3]

Ссылки

^[link1] http://www.webscript.ru

^[link2] https://ontheroad.dmitriev.su/VeloMagadan#sintaksisvaki

^[link3] https://ontheroad.dmitriev.su/VsjakijjTrepIFlud#sintaksisvaki

Клуб «Перевал»: Синтаксис Wacko