Заголовки

Есть 6 уровней заголовков: 1 — самый верхний, должен быть одним-единственным в документе, ибо задаёт его заглавие (хотя технически можно использовать сколько угодно первых уровней, заглавием по прежнему будет считаться лишь первый), 2 — секция документа и т. д. до 6 — самого маленького.
Заголовки задаются с помощью «равно» — чем их больше, тем меньше уровень заголовка. Первый уровень имеет 2 «равно», шестой — 7. Кроме того, количество «равно» справа должно быть не больше их слева. Вдобавок, слева и справа от заголовка на строке не должно быть ничего, даже пробелов. И наконец между «равно» и текстом могут быть пробелы, которые игнорируются. ¶

== Заголовок первого уровня ==
===Второго===
и так далее до...
======= Самый маленький =======

Второго¶

и так далее до… ======= Самый маленький ======= ¶

некоторые действия могут использовать заголовки для чего-то, например {{Оглавление}} генерирует содержание документа, которое, например, видно справа на этой странице. ¶

Можно использовать любую строчную разметку внутри, включая форматтеры: ¶

==== //Курсивный// текст; форматтер: %%(php) echo "Hello!";%% ==

Курсивный текст; форматтер: `PHPecho "Hello!";`¶

Можно также пропускать уровни заголовоков, хотя то же {{Оглавление}} будет выводить сообщение вместо таких пропусков: ¶

==== Заголовок 3 ====
====== Заголовок 5 ==

Заголовок 3¶

Заголовок 5¶

Не забывайте, что при использовании Include заголовки будут скорректированы для соответствия новому уровню вложенности внутри включившего их документа. ¶

Заглавие документа можно также задать с помощью Title.
Также полезно знать о настройке hideTitle, которая позволяет убрать заглавие документа из его вывода (полезно для программ, использующих UverseWiki для форматирования документов и выводящих заглавие в отдельное поле на странице). ¶

Альтернативные режимы¶

Описанные выше правила соответствуют традиционным принципам работы заголовков — например, в WackoWiki. Однако существуют ещё несколько и задаются они с помощью настройки headingMode: ¶

normal

Стандартный («традиционный») режим, описан выше.

shifted

Режим призван облегчить задание заголовков — так как на документ заголовок первого уровня всё равно всегда один (он задаёт его заглавие), то фактически используемые заголовки — с ===уровень 2=== по =======уровень 6==. В режиме shifted одно «равно» слева убирается, таким образом: ==уровень 2== до ======уровень 6==.

этот режим включается автоматически, если в документе используется Title.
в этом режиме заглавие документа больше невозможно задать заголовком — поэтому используйте его, когда заглавие либо задано с помощью Title, либо внешним источником (например, из базы данных).

extended

Идентичен режиму shifted, но делает возможным задать заглавие документа — им считается первый встреченный заголовок (==). Таким образом, первый заголовок == становится первым уровнем, а все последующие заголовки == — вторыми, при том, что для обоих используется одинаковый синтаксис — ==заголовок==.

Пример в режиме `shifted`¶

== Заголовок 2 ==
=== Заголовок 3 ===
И так далее до..
====== Заголовок 6 ======

Сравните это с режимом normal, как описано выше — доступных заголовков стало меньше на один, но для их задания был убран один знак «равно». ¶

Пример в режиме `extended`¶

== Заглавие документа ==
== Секция (заголовок 2) ==
===Подсекция (уровень 3)===
И так далее до..
====== Заголовок 6 ======

Таким образом, режим идентичен режиму shifted — отличие лишь в том, что первый встреченный ==заголовок== становится не вторым, а первым уровнем, задавая заглавие для документа.
Можно сказать, что это комбинация режимов normal и shifted. ¶

В режиме normal и «Заглавие документа», и «Секция (заголовок 2)» были бы первого уровня. В режиме shifted — оба второго. В этом режиме — так же, кроме первого заголовка, который стал первым уровнем. ¶