Редактирование: Таблица содержаний

Любая страница может содержать несколько '''разделов''', также называемых '''секциями'''. Страница может быть разделена на несколько '''секций'''. Для их разметки существует специальный синтаксис.

См. также [[mw:Manual:MediaWiki feature list|список возможностей МедиаВики]] {{ref-en}}.

== Создание секций ==
Разделение документа на секции происходит при добавлении в него заголовков. Например:
<pre>
== Первый раздел ==
Текст.
=== Подраздел ===
Ещё текст.
==== Под-подраздел ====
Еще какой-то текст.
== Второй раздел ==
</pre>

== Таблица содержания ==
<span style="font-size:smaller;">(«Table of contents», «TOC»)</span>

Таблица содержания автоматически добавляется на каждую страницу, имеющую больше трёх заголовков, исключая следующие случаи:
* пользователь отключил показ таблицы содержания в своих [[{{NAMESPACE}}:Настройки|настройках]];
* в коде страницы содержится специальный тег <tt><nowiki>__NOTOC__</nowiki></tt> (либо же <tt><nowiki>__БЕЗСОДЕРЖАНИЯ__</nowiki></tt>, при использовании [[LanguageRu.php]]).

При помощи тегов <tt><nowiki>__FORCETOC__</nowiki></tt> или <tt><nowiki>__TOC__</nowiki></tt> (в проектах, использующих последнюю версию LanguageRu.php также применимо <tt><nowiki>__СОДЕРЖАНИЕ__</nowiki></tt>) можно принудительно создавать таблицу содержания, даже если число заголовков меньше четырёх.

Содержание отображается перед первым из заголовков, либо же в том месте текста, где размещён тег <nowiki>__TOC__</nowiki>. Обычно перед содержанием помещается некоторый дополнительный текст с кратким обзором статьи. <!-- Хотя чаще всего наиболее удобным вариантом является размещение таблицы содержания перед основным текстом статьи, иногда бывает удобно перенести малоосмысленный заголовок -->Хотя вариант по умолчанию является наиболее удобным, иногда имеет смысл передвинуть таблицу содержания, например, зафиксировать её в самом начале статьи, либо же добавить её копию в конце. (В текущей версии МедиаВики есть небольшая недоработка: при использовании нескольких таблиц содержания свернуть можно только первую из них, учитывайте это).

Если вы хотите, чтобы {{nobr|при этом}} «Содержание» появлялось сдвинутым {{nobr|к правому}} краю страницы, {{nobr|а текст}} слева обтекал содержание, {{nobr|то используйте}} шаблон {{tl|TOCright}} вместо ключевого слова <nowiki>__TOC__.</nowiki>

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

При использовании секций в тексте [[{{NAMESPACE}}:Шаблоны|шаблона]] нумерация разделов соответствует их позиции в итоговой странице. Например, если тег шаблона добавлен в четвёртый раздел, первый раздел шаблона будет пятым. Любой текст, присутствующий в шаблоне до начала его первой секции, считается частью раздела с тегом секции.
<!-- Например:

Шаблон, названный «Template:Пример1»
<pre>
это шаблон с разделами.
==Это первый раздел==
Текст
==Это второй раздел==
И его текст
</pre>

Его использует некая страница:
<pre>
Это, знаете ли, страница.
==А вот тут у нас первый раздел==
Какой-то текст.

И ещё.
==Второй раздел==
Идёт текст страницы. А вот {{{{NAMESPACE}}:{{PAGENAME}}/Шаблон1}}.
==Последний раздел==
Конец.

</pre>

Результат можно посмотреть здесь → [[{{NAMESPACE}}:{{PAGENAME}}/Пример1]].
 -->

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

<!--<tt>{{tl|CompactTOC}}</tt>-->
<tt>{{tl|АБВ}}</tt>

В результате получается нечто вроде этого:

{{АБВ}}

Также это может быть применено к временным промежуткам:

[[#1900-е|1900-е]] — [[#1910-е|1910-е]] — [[#1920-е|1920-е]] — [[#1930-е|1930-е]] — [[#1940-е|1940-е]] — [[#1950-е|1950-е]] — [[#1960-е|1960-е]] — [[#1970-е|1970-е]] — [[#1980-е|1980-е]] — [[#1990-е|1990-е]] — [[#2000-е|2000-е]]

Учтите, что данный шаблон не поставляется в комплекте с MediaWiki.

== Ссылки на разделы ==
Если просмотреть HTML-код любой страницы, содержащей несколько разделов, можно заметить, что в начале каждого раздела присутствует тег «&lt;a&gt;» с двумя параметрами «name» и «id», значение которых совпадает с его заголовком. Это позволяет [[Гиперссылка|ссылаться]] на разделы внутри страницы. Эти же элементы используются для внутренних ссылок на разделы в таблице содержания.

Например, вот HTML-код ссылки на данный раздел:
<pre><nowiki><p><a name="Ссылки_на_разделы" id="Ссылки_на_разделы"></a></p>
<h2>Ссылки на разделы</h2></nowiki></pre>

Вики-код ссылки на данный раздел ([[{{NAMESPACE}}:{{PAGENAME}}#Ссылки_на_разделы|Ссылки на разделы]]) выглядит следующим образом:
<tt><nowiki>[[</nowiki>{{NAMESPACE}}:{{PAGENAME}}#Ссылки_на_разделы|Ссылки на разделы<nowiki>]]</nowiki></tt>

Общий синтаксис таков:

<tt><nowiki>[[</nowiki>''Имя_страницы''#''id''|текст ссылки<nowiki>]]</nowiki></tt>.

Если ссылка делается на раздел этой же страницы, можно использовать упрощённый синтаксис:

<tt><nowiki>[[</nowiki>#''id''|текст ссылки<nowiki>]]</nowiki></tt>

Если на странице присутствует несколько одинаково озаглавленных разделов, то ссылки на них образуются путём добавления к имени символа подчёркивания и порядкового номера. Например, если в статье три раздела с заголовком «Пример», то ссылки на них используют «#Пример», «#Пример_2» и «#Пример_3».

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

Внутренняя ссылка, размещённая внутри заголовка раздела, не создаёт никаких сложностей:
* [[#Пример_а]]

В старых версиях MediaWiki возникали проблемы, если в названии секции была внешняя ссылка, содержащая "http://» ({{bug|917}}). Чтобы обойти данную ошибку, нужно заменить в ссылке двоеточие на «%3A» (например, <tt><nowiki>[[#Пример_http%3A//a]]</nowiki></tt>). При этом в ссылке нельзя использовать пробелы, только знак подчёркивания. В настоящее время ошибка устранена не до конца, поэтому могут возникать неверные ссылки. Будьте внимательны при редактировании. <!-- Когда бага будет залатана, нужно поправить текст -->
Примеры (правильные — последние три варианта):
{|
!Исходный текст
!Результат
|----
|<nowiki>[[#Пример http://a]]</nowiki>
|[[#Пример http://a]]
|----
|<nowiki>[[#Пример http%3A//a]]</nowiki>
|[[#Пример http%3A//a]]
|----
|<nowiki>[[#Пример_http://a]]</nowiki>
|[[#Пример_http://a]]
|----
|<nowiki>[[#Пример_http%3A//a]]</nowiki>
|[[#Пример_http%3A//a]]
|----
|<nowiki>[[#Пример_http%3A%2F%2Fa]]</nowiki>
|[[#Пример_http%3A%2F%2Fa]]
|}

При создании внешнего URL также следует заменять «://» на «%3A%2F%2F»
 {{SERVER}}/wiki/{{NAMESPACE}}:{{PAGENAME}}#Пример_http%3A%2F%2Fa
<!--
Чтобы ссылаться на произвольное место в тексте страницы, см. [[{{NAMESPACE}}:Ссылки#Ссылка на страницу|Ссылка на страницу]].-->

=== Ссылки на разделы и перенаправления ===
Допускается [[Википедия:Перенаправления|перенаправление]] на определённый раздел внутри целевой статьи.

Также допускается указывать определённый раздел в ссылке, указывающей на страницу-перенаправление. Если раздел присутствует в целевой статье перенаправления, то на него и будет осуществлён переход. Подобная ситуация часто возникает при [[Википедия:Переименование|переименовании страницы]].

Однако при переименовании раздела не происходит автоматического создания перенаправления со старого варианта на новый. Также невозможно просмотреть [[{{NAMESPACE}}:Ссылки сюда|ссылки]] на каждый отдельный раздел. Возможные варианты решения:
* Использовать [[{{NAMESPACE}}:Якоря|якорь]] и ссылаться на него.
* В начале раздела поместить комментарий, перечисляющий статьи, которые на него ссылаются. Комментарий невидим при просмотре статьи. Например: <br /> <code><nowiki>== История ==<!--Заголовок используется для перенаправления [[История Петербурга]]--></nowiki></code>
* Самый кардинальный вариант: вынести раздел на отдельную страницу.

== Редактирование разделов ==
Каждый раздел может редактироваться отдельно, это экономит трафик и даёт возможность избежать [[{{NAMESPACE}}:Конфликт правок|конфликтов правок]] при одновременной правке разными участниками разных разделов страницы (После перехода на Mediawiki 1.5 была обнаружена ошибка ({{bug|3059}}), вследствие которой при одновременной правке разных разделов статьи получается так, что последняя правка стирает правки всех других разделов, причём даже не выдаётся предупреждение о конфликте правок). Вход в режим редактирования осуществляется<!-- по правому клику на заголовке раздела либо же --> посредством специальных ссылок редактирования, размещающихся рядом с заголовком (точное положение задаётся в [[{{NAMESPACE}}:Настройки|настройках]]) или же по правому щелчку на заголовке секции (используется JavaScript), данная возможность активируется в настройках пользователя.
Также можно самостоятельно сконструировать URL наподобие этого:
<!--http://meta.wikimedia.org/w/index.php?title={{NAMESPACE}}:{{PAGENAME}}&action=edit&section=3
 {{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit&section=3}} -->
 {{SERVER}}/w/index.php?title={{NAMESPACE}}:{{PAGENAME}}&action=edit&section=3
Добавление новой секции происходит при создании нового заголовка, соответственно, при его удалении секции сливаются в одну.

Тег <tt><nowiki>__NOEDITSECTION__</nowiki></tt> (<tt><nowiki>__БЕЗРЕДАКТИРОВАНИЯРАЗДЕЛА__</nowiki></tt> при использовании [[LanguageRu.php]]), добавленный в любом месте исходного кода страницы, запрещает отображение ссылок редактирования разделов. Однако правка текста секций по правому щелчку по заголовку или посредством URL остаётся возможной.

В настоящий момент на странице не создаётся ссылки для редактирования части текста, идущей перед первым из заголовков ({{bug|156}}), однако нужный URL может быть создан вручную, например, для данной страницы:

<!-- {{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}}&section=0 -->
 {{SERVER}}/w/index.php?title={{NAMESPACE}}:{{PAGENAME}}&action=edit&section=0
Наиболее простой способ получить подобный адрес — скопировать ссылку для редактирования любой из секций и сменить в нём номер секции на 0.

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

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

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

Тег <nowiki>__NOEDITSECTION__</nowiki>, присутствующий в ''любом'' из включённых в страницу шаблонов, влияет на неё соответствующим образом, и ни одна из секций, как самой страницы, так и всех включённых в неё шаблонов, не будет иметь ссылки для редактирования.

=== Редактирование раздела в новом окне ===
Если пользователь включил в своих настройках возможность редактирования статей по правому щелчку на заголовке раздела, то становится невозможным вызвать всплывающее меню и открыть ссылку в новом окне. Однако большинство браузеров предоставляют для этого и другие способы (Mozilla/Firefox: щелчок по ссылке колёсиком, ctrl+щелчок, всплывающее меню для найденного выделенного текста; IE: shift+щелчок).

== Горизонтальная разделительная линия ==
Горизонтальная разделительная линия (для её создания нужно написать «----» в начале строки) используется только для визуального разделения текста и не создаёт новых разделов.

== Раздел «См. также» ==
Если на странице есть несколько разделов и текст «См. также» со ссылками на другие страницы, рекомендуется вынести их.
Ссылки на другие страницы сходной тематики рекомендуется выносить в отдельный раздел под названием «См. также». Это препятствует внесению их в другие разделы и делает удобным навигацию при помощи таблицы содержания.

В противовес данной практике, иногда текст «см. также» выносят в самое начало статьи.

Каждый отдельный раздел также может включать в себя подраздел (или же просто отдельный абзац) «см. также», содержащий ссылки на более узкую тему.

== Заголовки, не создающие новых разделов ==
 Внимание! Информация в этом разделе не актуальна. 
<font style="color:#999999"> Имеется возможность создания заголовков, не образующих новых разделов. Соответственно, на них также нельзя ссылаться. Делается это следующим образом:

<tt><nowiki><h2>Не заголовок</h2></nowiki></tt>

Выглядит это так:

<h2>Не заголовок</h2>

Также можно использовать теги <tt><nowiki><h3></nowiki></tt>—<tt><nowiki><h6></nowiki></tt> для создания заголовков следующих уровней.

Применяется и другая конструкция:

<tt><nowiki><b><font style="font-size:120%">Другой пример</font></b></nowiki><tt>

что выглядит как

'''<font style="font-size:120%">Другой пример</font>'''

Однако выделенный таким образом текст может отличаться от прочих заголовков. Данный вариант используется обычно для смыслового выделения.</font>
 Начиная с версии 1.5, тег <nowiki><h2></nowiki> тоже создает разделы.

== Пробел в заголовке ==
Если заголовок любого уровня состоит только из пробела, это вызывает проблемы: в этом месте в HTML-код страницы добавляется тег вида <pre><a name=""></a>
</pre> соответственно, ссылки на этот раздел невозможны, не работает даже ссылка в таблице содержания.

== Разделы, страницы и слияние страниц ==
Преимущества отдельных страниц:
* возможность получения информации о [[{{NAMESPACE}}:Что ссылается сюда|ссылках на страницу]];
* автоматическое [[{{NAMESPACE}}:Перенаправления|перенаправление]] со старых ссылок при переименовании страницы;
* загрузка небольшой страницы происходит быстрее.

Преимущества объёмной страницы, разделённой на несколько секций:
* загрузка одной большой страницы происходит быстрее, чем загрузка ''нескольких'' маленьких страниц;
* по одной большой странице гораздо проще осуществлять поиск (средствами браузера пользователя), во многих случаях это гораздо удобнее поиска по всему проекту (и снижает нагрузку на сервер);
* таблица содержания предоставляет удобные возможности навигации.

Ещё один путь — это составлять одну страницу из нескольких, используя их как [[{{NAMESPACE}}:Шаблоны|шаблоны]]. В результате образуется так называемый [[{{NAMESPACE}}:Составной документ|составной документ]]. Этот вариант даёт возможность поиска по отрисованной странице, но не по её вики-коду.

== Раздел для примеров ==

=== Пример [[а]] ===

=== Пример http://a  ===

== См. также ==
[[Mediawiki разметка]]

----


[http://taxguide.ru/services/transfertnoe-tsenoobrazovanie/ документация по контролируемым сделкам]