Manual:Table of contents/ru

По умолчанию, содержание (англ. аббревиатура TOC) автоматически создается на странице, когда используется более трех заголовков на ней.

Типично таблица воспроизводит и нумерует эти заголовки.

Вся разметка HTML для заголовков очищается в таблице содержания, за исключением, , , , ,.

Скрытие таблицы содержания

 * См. 

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

Скин может убрать или переместить таблицу содержания в другой раздел страницы при использовании.

Добавление таблицы содержания
Если у вас три или менее заголовков, но хочется иметь таблицу содержания (ТС), напишите или волшебное слово  где-нибудь на странице, чтобы она появилась в позиции по умолчанию, или   в желаемом месте.

Глубина
Максимальный уровень заголовков, отображаемый в ТС, определяется в. Для настройки его для конкретной странице ТС можно заключить в элемент с классом, если соответствующие правила CSS определены в.

См. и соответствующие правила в MediaWiki:Common.css для примера реализации.

Автоматическая нумерация
По умолчанию ТС автоматически нумерует секции. Заголовки секций сами по себе не нумеруются. Это поведение таблицы содержания можно настроить несколькими способами:


 * можно подавить автогенерацию номеров разделов в ТС, если подходящий класс существует локальнов в MediaWiki:Common.css, определенный как.

Чтобы это сделать выборочно, элемент оболочки можно разместить вокруг ТС, как в  на странице и   в MediaWiki:Common.css.


 * также есть пользовательская настройка Автоматически нумеровать заголовки, в  > Внешний вид > Расширенные настройки > Автоматически нумеровать заголовки. Это можно установить глобально для всей вики, выставив параметр  в
 * Эти настройки могут быть переопределены индивидуально пользователями, изменяя свои настройки как описано выше, или установив  в своей странице стиля user style. Администраторы, у которых нет доступа к серверу, также могут переопределить эту настройки для всех пользователей, если она активирована указанным выше способом. Это сделано с использованием того же кода CSS в глобальном файле common.css сайта.

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

Различные руководства по стилям каждого языка иногда рекомендуют следовать различным соглашениям по оформлению.

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

Пример о том, как изменить стиль ТС на локализованный, приведен ниже:

Некоторые языки ставят точку после порядкового номера (под)раздела, например они не используют следующий стиль ТС:

Contents 1 Section [1] 1.1 Subsection [1.1] 2 Section [2] 2.1 Subsection [2.1] 3 Section [3] 3.1 Subsection [3.1] 3.1.1 Subsubsection [3.1.1] 3.1.2 Subsubsection [3.1.2]

А используют его таким образом:

Contents 1. Section [1.] 1.1. Subsection [1.1.] 2. Section [2.] 2.1. Subsection [2.1.] 3. Section [3.] 3.1. Subsection [3.1.] 3.1.1. Subsubsection [3.1.1.] 3.1.2. Subsubsection [3.1.2.]

(Notice the addition of dots after ordinal numerals before the section names!)

It's possible to produce that effect using CSS. Put the following CSS code in a shared CSS file of your MediaWiki installation and it should work:

where the symbol between the single quotation marks is the sign after a (sub)section number.

Also, see 43494 and 33450 for details on related i18n problems of TOCs.

Floating
The TOC can be made to display as a floating element on the page, with text flowing around it.

For this, enclose the TOC in an element with the CSS style  or.

See for an example implementation.

Extensions
The behavior of the table of contents can be further adjusted using extensions.

See for a list.