Справка:Секции - История изменений

MaxAK в 18:58, 20 мая 2016

2016-05-20T18:58:51Z

← Предыдущая версия		Версия от 18:58, 20 мая 2016
Строка 2:		Строка 2:

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

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

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

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

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

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

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

	Однако при переименовании раздела не происходит автоматического создания перенаправления со старого варианта на новый. Также невозможно просмотреть [[{{NAMESPACE}}:Ссылки сюда\|ссылки]] на каждый отдельный раздел. Возможные варианты решения:		Однако при переименовании раздела не происходит автоматического создания перенаправления со старого варианта на новый. Также невозможно просмотреть [[{{NAMESPACE}}:Ссылки сюда\|ссылки]] на каждый отдельный раздел. Возможные варианты решения:
Строка 233:		Строка 231:
	* [[{{NAMESPACE}}:Шаблоны]]		* [[{{NAMESPACE}}:Шаблоны]]
	* [[{{NAMESPACE}}:Настройки]]		* [[{{NAMESPACE}}:Настройки]]
	* [[~~Википедия~~:Оформление статей]]		* [[ЭАК:Оформление статей]]

	[[Категория:~~Википедия~~:Способы оформления статей]]		[[Категория:ЭАК:Способы оформления статей]]

Hqaweb: Новая страница: «: ''Копия m:Помощь:Секции'' Любая страница может содержать несколько '''разделов''', также…»

2016-05-08T09:37:04Z

Новая страница: «: ''Копия m:Помощь:Секции'' Любая страница может содержать несколько '''разделов''', также…»

Новая страница

: ''Копия [[m:Помощь:Секции]]''

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

См. также [[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}}:Шаблоны|шаблона]] нумерация разделов соответствует их позиции в итоговой странице. Например, если тег шаблона добавлен в четвёртый раздел, первый раздел шаблона будет пятым. Любой текст, присутствующий в шаблоне до начала его первой секции, считается частью раздела с тегом секции.


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


<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-код любой страницы, содержащей несколько разделов, можно заметить, что в начале каждого раздела присутствует тег «<a>» с двумя параметрами «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}}:Якоря|якорь]] и ссылаться на него.
* В начале раздела поместить комментарий, перечисляющий статьи, которые на него ссылаются. Комментарий невидим при просмотре статьи. Например: <br /> <code><nowiki>== История ==</nowiki></code>
* Самый кардинальный вариант: вынести раздел на отдельную страницу.

== Редактирование разделов ==
Каждый раздел может редактироваться отдельно, это экономит трафик и даёт возможность избежать [[{{NAMESPACE}}:Конфликт правок|конфликтов правок]] при одновременной правке разными участниками разных разделов страницы (После перехода на Mediawiki 1.5 была обнаружена ошибка ({{bug|3059}}), вследствие которой при одновременной правке разных разделов статьи получается так, что последняя правка стирает правки всех других разделов, причём даже не выдаётся предупреждение о конфликте правок). Вход в режим редактирования осуществляется посредством специальных ссылок редактирования, размещающихся рядом с заголовком (точное положение задаётся в [[{{NAMESPACE}}:Настройки|настройках]]) или же по правому щелчку на заголовке секции (используется JavaScript), данная возможность активируется в настройках пользователя.
Также можно самостоятельно сконструировать URL наподобие этого:

{{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}}/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 ===

== См. также ==
* [[{{NAMESPACE}}:Шаблоны]]
* [[{{NAMESPACE}}:Настройки]]
* [[Википедия:Оформление статей]]

[[Категория:Википедия:Способы оформления статей]]