Страница содержания

Материал из Брацка Правки
Перейти к: навигация, поиск

Страница содержания -- содержание (англ. table of contents) автоматически добавляется на каждую страницу, имеющую больше трёх заголовков, исключая следующие случаи:

  • пользователь отключил показ содержания в своих настройках;
  • в коде страницы содержится специальный тег __NOTOC__.

При помощи тегов __FORCETOC__ или __TOC__ можно принудительно создавать содержание, даже если число заголовков меньше четырёх.

Содержание отображается перед первым из заголовков, либо же в том месте текста, где размещён тег __TOC__. Обычно перед содержанием помещается некоторый дополнительный текст с кратким обзором статьи. Хотя вариант по умолчанию является наиболее удобным, иногда имеет смысл передвинуть таблицу содержания, например, зафиксировать её в самом начале статьи, либо же добавить её копию в конце.

Если вы хотите, чтобы при этом «Содержание» появлялось сдвинутым к правому краю страницы, а текст слева обтекал содержание, то используйте шаблон {{TOC right}} вместо ключевого слова __TOC__.

В настройках пользования можно включить автоматическую нумерацию заголовков разделов в тексте страницы. Это никак не влияет на исходный код, однако может оказаться удобным при чтении объёмных статей.

При использовании секций в тексте шаблона нумерация разделов соответствует их позиции в итоговой странице. Например, если тег шаблона добавлен в четвёртый раздел, первый раздел шаблона будет пятым. Любой текст, присутствующий в шаблоне до начала его первой секции, считается частью раздела с тегом секции.

Связанные лектио