Руководство:Содержание

This page is a translated version of the page Manual:Table of contents and the translation is 94% complete.
Outdated translations are marked like this.
Эта страница о таблицах содержания на вики-страницах. Если вы искали страницу содержания технического руководства MediaWiki см. Manual:Содержание .

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

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

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

  • ‎<sup>, ‎<sub>[1]
  • ‎<i>[2]
  • ‎<b>[3]
  • ‎<bdi>[4]
  • <span dir="rtl">, <span dir="ltr">[5]
  • ‎<s>, ‎<strike>[6]
  • ‎<q>[7]

Таблица контента не создаётся для заголовков разделов, которые находятся в html-тэгах (Manual:$wgRawHtml ).

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

Расположите __NOTOC__ в любом месте страницы, чтобы скрыть её содержание.

Использование определённых шаблонов, например, Template:Compact ToC в английской Википедии, может заменить стандарнтый функционал таблицы содержания.

Расположение таблицы содержания

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

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

Добавление таблицы содержания

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

Настройка ТС

Ширина

An extenuating circumstance may require the width of a TOC width to be adjusted as a percentage of a page. Например: {{TOC left|width=30%}}

Глубина

Максимальный уровень заголовков, отображаемый в ТС, определяется в $wgMaxTocLevel . Для настройки его для конкретной странице ТС можно заключить в элемент с классом toclimit-<limit>, если соответствующие правила CSS определены в страницах CSS .

См. Template:TOC и соответствующие правила в Template:TOC/limit-styles.css как пример реализации.

Автоматическая нумерация

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

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

Чтобы сделать это выборочно, вокруг оглавления можно поместить элемент-оболочку, например, <div class="noautonum">__TOC__</div> на странице и .noautonum .tocnumber { display: none; } в MediaWiki:Common.css..

Также можно добавить нумерацию к самим заголовкам с помощью JavaScript, как объясняется в Snippets/Auto-number headings .

Интернационализация

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

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

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

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

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

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.]

(Заметьте дополнительные точки после порядковых номеров перед названием разделов!)

Этот эффект можно создать, используя CSS. Поместите следующий код CSS в "расшаренный" файл CSS вашей MediaWiki, и это должно сработать:

.tocnumber:after { content: '.' }

где символ между одиночными кавычками является знаком после номера (под)раздела.

Также, см. bugzilla:43494 и bugzilla:33450 для дополнительной информации, относящейся к проблемам интернационализации таблиц содержания.

Размещение

ТС можно отображать как плавающий элемент на странице, чтобы текст обтекал её вокруг.

Для этого заключите ТС в элемент со стилем CSS float:left; или float:right;.

См. Template:TOC для примера реализации.

Расширения

Поведение таблицы содержания можно настроить шире, используя расширения.

См Category:TOC extensions для всего списка.

See also

  1. Начиная с MediaWiki 1.11 (сентябрь 2007). См. phab:T10393.
  2. Начиная с MediaWiki 1.19 (ноябрь 2011). См. phab:T28375.
  3. Начиная с MediaWiki 1.19 (декабрь 2011). См. phab:T28375.
  4. Начиная с MediaWiki 1.25/wmf14 (). См. phab:T74884.
  5. Начиная с MediaWiki 1.21/wmf1 (). См. phab:T37167.
  6. Начиная с MediaWiki 1.28/wmf.21 (). См. phab:T35715.
  7. Начиная с MediaWiki 1.39.0-wmf.6 (). См. phab:T251672.