UverseWiki

Заголовки

Есть 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 — оба второго. В этом режиметак же, кроме первого заголовка, который стал первым уровнем.