stringtranslate.com

Справка:Раздел

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

Создание и нумерация разделов

  • WP:НОМЕР РАЗДЕЛА
  • WP:SECTIONLEVELS

Разделы создаются путем создания их заголовков, как показано ниже.

== Раздел == === Подраздел === ==== Подраздел ====

Их иногда называют «уровнями» в зависимости от количества знаков равенства до и после, так что верхний «Раздел» с двумя знаками равенства представляет собой заголовок «второго уровня», подраздел — заголовок «третьего уровня», а «подподраздел» — это «четвёртый уровень».

  • WP:LEVELONESECTION

Пожалуйста, не используйте заголовок «первого уровня» (только один знак равенства с каждой стороны, например: =Heading= ). Это приведет к тому, что заголовок раздела будет размером с заголовок страницы в верхней части страницы. Максимальное количество уровней — шесть.

Названия заголовков разделов (включая подразделы) должны быть уникальными на странице. Использование одного и того же заголовка более одного раза на странице приводит к проблемам:

Нумерация

Разделы пронумерованы в оглавлении (не применимо в Векторе 2022 ).

Порядок сортировки

Порядок расположения разделов (приложение и нижний колонтитул) см. в Википедии: Руководство по стилю/макету § Порядок элементов статьи .

Конечные секции

Иерархия разделов и подразделов в викитексте в основном определяется уровнем заголовков, поэтому любой текст без нового заголовка автоматически считается частью предыдущего раздела или подраздела. Это означает, что нет прямого способа указать, что конечный текст принадлежит родительскому разделу. Если это различие важно, обычно можно изменить порядок текста или просто добавить еще один подраздел.

Оглавление (ТОС)

  • Ч:ТОС
  • WP:ТОС
Пример оглавления в стандартном скине Vector 2022.

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

Для каждой страницы, имеющей как минимум четыре заголовка, оглавление (TOC) автоматически генерируется из заголовков разделов, если только к викитексту статьи не добавлено магическое слово (с двумя подчеркиваниями по обе стороны от слова) . не следует использовать в статьях, которые (а) имеют менее четырех заголовков или (б) не умещаются на одном экране. [1]__NOTOC____NOTOC__

Использование определенных шаблонов, таких как {{ Compact ToC }}, заменит обычную функциональность оглавления.

Позиционирование ТОС

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

При использовании __FORCETOC__оглавление помещается непосредственно перед заголовком первого раздела. Использование __TOC__помещает TOC в ту же позицию, что и этот код.

В большинстве статей перед оглавлением имеется вводный текст, известный как «главный раздел». Хотя обычно заголовок раздела должен следовать сразу за оглавлением, использование __TOC__может предотвратить необходимость вставлять бессмысленный заголовок только для того, чтобы правильно расположить оглавление (т. е. не слишком низко). Однако если между оглавлением и первым заголовком вообще есть какой-либо текст, это вызовет проблемы с доступностью.

Плавающее содержание

В некоторых случаях оглавление можно перемещать вправо или влево, используя или когда это выгодно для макета статьи, или когда оглавление по умолчанию мешает другим элементам. Прежде чем изменить оглавление по умолчанию на плавающее оглавление, примите во внимание следующие рекомендации:{{TOC right}}{{TOC left}}

  1. Если оглавление плавающее, его следует разместить в конце ведущего раздела текста, перед заголовком первого раздела. Пользователи программ чтения с экрана не ожидают наличия текста между оглавлением и первым заголовком, а отсутствие текста над оглавлением сбивает с толку. Смотрите последнюю строку в информации об элементах раздела лида .
  2. При размещении оглавления проверьте, не повредится ли макет страницы, если оглавление будет скрыто пользователем.
  3. Длинные списки могут создавать очень длинные оглавления. Оглавление не должно быть длиннее, чем необходимо, независимо от того, плавающее оно или нет. может использоваться для уменьшения длины оглавления путем сокрытия вложенных подразделов, а не плавающего оглавления.{{TOC limit}}
  4. Оглавление по умолчанию размещается перед первым заголовком, но после любого вводного текста. Если вводное резюме достаточно длинное, и обычному пользователю приходится прокручивать вниз, чтобы увидеть верхнюю часть оглавления, вы можете разместить оглавление так, чтобы оно отображалось ближе к началу статьи. Однако в большинстве случаев плавающее оглавление должно следовать как минимум за первым абзацем текста статьи.
  5. Использование широкого оглавления приведет к созданию узкого столбца читаемого текста для пользователей с низким разрешением. Если ширина оглавления превышает 30% видимого экрана пользователя (примерно в два раза больше размера навигационной панели Википедии слева), то оно не подходит для плавающего размещения. (Проценты предполагают типичную пользовательскую настройку.) Если текст зажат между плавающим оглавлением и изображением, плавающее перемещение можно отменить в определенной текстовой точке, см. Принудительный разрыв .
  6. Если оглавление размещается в непосредственной близости от других плавающих изображений или блоков, оно может быть плавающим до тех пор, пока столбец с плавным текстом не станет уже более 30 % от видимой ширины экрана среднего пользователя.
  7. Перемещенное слева содержание может влиять на маркированные или нумерованные списки.

Шаблон: Право TOC было предложено удалить в начале июля 2005 года, но консенсуса по этому вопросу не было. Архив обсуждения и голосования по этому поводу можно увидеть в Википедии:Шаблоны на удаление/TOCright . Обсуждение Руководства по стилю можно найти здесь .

Ограничение ширины страницы оглавления

Смягчающее обстоятельство может потребовать корректировки ширины оглавления в процентах от страницы. Например:{{TOC left|width=30%}}

Ограничение глубины содержания оглавления

  • Ч:ЛИМИТТОК

По умолчанию оглавление включает все заголовки на странице, независимо от их уровня. Если страница статьи или проекта имеет очень большое количество подразделов, может оказаться целесообразным скрыть подразделы нижнего уровня из оглавления. Вы можете указать ограничение для раздела самого нижнего уровня, который должен отображаться, используя , где — количество знаков, используемых на каждой стороне заголовка раздела самого нижнего уровня, который должен отображаться (например, чтобы показать все заголовки вниз, но скрыть и все заголовки ниже). Параметр также может быть задан таким же образом.{{TOC limit|n}}n=3===sub-sections=======sub-sub-sections====limit=n{{TOC left}}{{TOC right}}

Замена оглавления по умолчанию

  • WP:REPLACETOC

Автоматически созданное содержание не является максимально подходящим или полезным для всех типов статей, таких как статьи с длинными списками и глоссарии , поэтому существует множество шаблонов замены . Чтобы использовать его, поместите замещающий шаблон оглавления, например (который можно настроить для многих стилей списка), где это необходимо. Рекомендуется размещать его в верхней части статьи, чтобы обеспечить правильную работу, но во многих случаях обычное оглавление будет подавлено просто добавлением заменяющего шаблона оглавления.{{Compact TOC}}__NOTOC__

Горизонтальный ТОС

Шаблон {{ Горизонтальное содержание }} размещает содержание в горизонтальном списке, а не в вертикальном. Это может быть практично в оглавлении со многими краткими записями. Возможность отображать длинное содержание без прокрутки делает его подходящим для таблиц, строки которых содержат заголовки разделов.

Пример: Законность каннабиса по странам – используется краткое, но функциональное горизонтальное содержание от A до Z.
Пример: Законность каннабиса в юрисдикции США – используются два TOC; короткий вертикальный и длинный горизонтальный.

Связывание разделов

В HTML-коде каждого раздела есть атрибут «id», содержащий заголовок раздела. Это позволяет напрямую ссылаться на разделы. Эти привязки разделов автоматически используются MediaWiki, когда он генерирует оглавление для страницы, и поэтому при щелчке по заголовку раздела в ToC происходит переход к этому разделу. Кроме того, привязки разделов можно вручную связать непосредственно с одним разделом на странице.

Например, HTML-код, созданный в начале этого раздела:

< span  class = "mw-headline"  id = "Section_linking" > Связывание разделов </ span >

Ссылка на этот раздел (Связка разделов) выглядит так:

[[Help:Section#Section linking|Section linking]]

(Примечание: ссылки на разделы чувствительны к регистру, включая первый символ ( Help:Link ).)

Для ссылки на раздел на той же странице вы можете использовать [[#section name|displayed text]], а для ссылки на раздел на другой странице [[page name#section name|displayed text]].

Якоря не учитывают глубину сечения; ссылка на подраздел или подраздел и т.д. будет [[#subsection name]]и [[#sub-subsection name]]т.п.

К повторяющимся названиям разделов добавляются подчеркивание и число. Например, для трех разделов с именем «Пример» имена (для связывания разделов) будут «Пример», «Пример_2» и «Пример_3». Однако после редактирования раздела «Пример_2» или «Пример_3» (см. ниже) из сводки редактирования , что сбивает с толку, попадаете в раздел «Пример» .

Если в заголовке раздела есть пустое место, это приводит к тому, что ссылка в оглавлении не работает. Похожий эффект см. в NS:0 .

Чтобы создать цель привязки без заголовка раздела, вы можете использовать шаблон {{ anchor }} или диапазон: <span id="anchor_name"></span>.

Чтобы отформатировать ссылку на раздел со знаком раздела («§»), а не с «#» или произвольным текстом, используйте {{ Ссылка на раздел }} (или {{ slink }}). Например, эквивалентен ссылке Foo#Bar , но имеет формат Foo § Bar .{{Section link|Foo|Bar}}

Примечания:

Информацию о привязке к произвольной позиции на странице см. в разделе «Связывание (якоря)» .

Связывание разделов и перенаправления

Ссылка, указывающая раздел страницы перенаправления, соответствует ссылке на этот раздел цели перенаправления.

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

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

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

Страницы перенаправления можно классифицировать, добавив тег категории после команды перенаправления. В случае, если целью перенаправления является раздел, это в некоторой степени влияет на категоризацию раздела: посредством перенаправления страница категории ссылается на раздел; однако, если не указана явная ссылка, этот раздел не ссылается на категорию. На странице категории перенаправления отображаются с перенаправлением класса в категории, поэтому их можно выделить, например, курсивом; это можно определить в MediaWiki:Common.css . См. также WP:Категоризация перенаправлений .

Редактирование раздела

  • WP:EDITLINK
  • WP:SECTIONEDIT

Разделы можно редактировать отдельно, щелкнув специальные ссылки редактирования с надписью «[изменить]» рядом с заголовком или щелкнув правой кнопкой мыши заголовок раздела.

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

Добавление раздела в конце

  • ВП:+

Навигация по страницам из пространств имен «обсуждений» обеспечивает специальную ссылку с надписью «Новый раздел», «+» или «Добавить тему», используемую для создания нового раздела в конце страницы. [2] Ссылку можно удалить со страницы с помощью волшебного слова __NONEWSECTIONLINK__ или добавить с помощью __NEWSECTIONLINK__.

URL-адрес такого действия выглядит так:

https://en.wikipedia.org/w/index.php?title=Wikipedia:Sandbox&action=edit§ion=new.

В этом случае появится текстовое поле с заголовком «Тема:», и введенное в него содержимое станет названием нового заголовка раздела. Поле ввода для сводки редактирования отсутствует ; он создается автоматически.

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

Редактирование перед первым разделом

По умолчанию ссылка для редактирования основного раздела страницы отсутствует, поэтому необходимо редактировать всю страницу. Редактирование раздела лидов можно включить в меню «Настройки»  → «Гаджеты»  → «Внешний вид» → «Добавить ссылку [редактировать]» для раздела лидов на странице . Вы также можете нажать «[изменить]» в другом разделе и вручную изменить URL-адрес на . section=nsection=0

Удаление ссылок на редактирование раздела

Ссылки на редактирование раздела можно убрать, например в архивах, волшебным словом __NOEDITSECTION__. Некоторые шаблоны добавляют его автоматически.

Предварительный просмотр

Предварительный просмотр при редактировании раздела не всегда отображается так же, как соответствующая часть полной страницы, например, если на полной странице изображение из предыдущего раздела вторгается в соответствующий раздел. Кроме того, <ref> обычно становятся скрытыми; см. #Редактирование сноски для решения.

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

Подразделы

Подразделы включаются в ту часть раздела, которая редактируется. Нумерация разделов относится к редактируемой части, поэтому на относительном верхнем уровне всегда есть только номер 1, все относительные подразделы имеют номера, начинающиеся с 1: 1.1., 1.2 и т. д.; например, при редактировании подраздела 3.2 подразделу 3.2.4 присваивается номер 1.4. Однако формат заголовка соответствует абсолютному уровню.

Редактирование сноски

Чтобы отредактировать сноску, отображаемую в разделе, содержащем код <references />, отредактируйте раздел со знаком сноски, ссылающимся на него (см. Справка:Сноски ). При предварительном просмотре раздела будет показан предварительный просмотр сноски.

Разделы внутри функций парсера

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

Таким образом, ссылки «редактировать» разделов включенного шаблона ссылаются на саму страницу, а не на шаблон, а ссылки «редактировать» после включенного шаблона ссылаются на правильную страницу, но с неправильным номером раздела.

В более общем смысле, условные разделы создают такое осложнение.

Проблема не возникает при транслировании шаблона с условным именем (что имеет больше преимуществ). Используйте m:Template:void  (редактирование обратных ссылок), чтобы шаблон включался и ничего не производил.

Редактирование разделов включенных шаблонов

Возможности редактирования также можно применить к разделу включенного шаблона. Этот раздел « Справка:Редактирование разделов включенных шаблонов » является примером.

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

Если размер разделов в соответствии с системой отличается от того, что предлагает отображаемая страница, это может сбить с толку. Чтобы избежать этого:

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

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

Обратите внимание, что значение параметра, появляющееся в шаблоне, например «{{{1}}}», если мы хотим сохранить параметр, редактируется не путем редактирования шаблона, а путем редактирования вызова шаблона, даже если отображаемая страница и его ссылки на редактирование не показывают это автоматически. Некоторый пояснительный текст и/или дополнительная ссылка для редактирования могут быть полезны. В этом случае, чтобы отредактировать «{{{1}}}», нам нужно отредактировать тег шаблона на странице, вызывающей шаблон. Если мы используем редактирование раздела, соответствующая ссылка на редактирование раздела находится в заголовке, который появляется перед заголовком в самом шаблоне.

Тег __NOEDITSECTION__ в любом шаблоне влияет как на этот шаблон, на страницы, на которых он включен, так и на любые другие шаблоны, включенные в ту же страницу.

{{ фальшивый заголовок }} можно использовать в шаблонах и страницах справки, где желательно появление заголовка без отображения в оглавлении и без ссылки на редактирование.

Разделы, отдельные страницы и включение

Преимущества отдельных страниц:

  1. какие ссылки здесь есть
  2. отдельная история редактирования
  3. на страницу действуют некоторые ограничения шаблона
  4. автоматическое перенаправление при переименовании
  5. загрузка одной маленькой страницы происходит быстрее, чем загрузка одной большой страницы, но захотят ли читатели использовать только один раздел или просмотреть множество разделов темы? – увидеть преимущества объединенных страниц
  6. можно отдельно разложить по категориям (однако см. также ниже)
  7. с Semantic MediaWiki : иметь отдельные аннотации

Преимущества одной объединенной страницы с разделами:

  1. загрузка одной объединенной страницы происходит быстрее и удобнее, чем загрузка нескольких разделенных
  2. поиск внутри одной большой страницы или ее викитекста с помощью функции локального поиска выполняется быстрее и имеет преимущества перед поиском по нескольким страницам с использованием поисковой системы по сайту или поисковой системы в Интернете.
  3. Оглавление обеспечивает удобную навигацию.
  4. большая вероятность редакционной сплоченности концепции по сравнению с наличием нескольких определений, которые могут редактироваться независимо
  5. избегается дублирование элементов, относящихся к каждому разделу, таких как шаблоны навигации и информационные поля.

Альтернативой является составление страницы из других страниц с использованием функции шаблона (создание составного документа путем включения ). Это позволяет легко осуществлять поиск внутри объединенной отображаемой страницы, но не в объединенном викитексте. Недостатком является необходимость предоставления заголовка для каждой страницы. Что касается ограничения размера предварительного расширения, это невыгодно даже по сравнению с одной большой страницей: размер предварительного расширения представляет собой сумму размеров предварительного расширения компонентов плюс сумму размеров викитекстов компонентов.

Включение раздела

  • Справка:ПЕРЕСЕЧЕНИЕ

Включение маркированного раздела

Включение разделов в стиле шаблона

  • Справка:ТСТ

Включение разделов в стиле шаблона (TST) — это более старый метод включения разделов.

Маркировка разделов

Выделите разделы в тексте с помощью такой разметки:

< onlyinclude >{{ #ifeq :{{{ transcludesection |}}}| глава 1 |содержание}}</ onlyinclude >

Включение раздела

Используйте вызов шаблона, чтобы включить раздел. Например, чтобы включить раздел, вызываемый chapter1со страницы с именем pageX:

{{:pageX|transcludesection=глава1}}

Целевая страница определяет расположение раздела.

Размещение изображения

Разделы для демо выше

Демо http://example.com

Ссылка на этот раздел находится в #Section linking.

Смотрите также

Руководство по стилю

Сноски

  1. ^ Мобильные платформы с маленьким экраном используют альтернативную схему навигации, на которую не влияет __NOTOC__. При рендеринге статей на ПК размещение статьи на одном экране зависит от размера экрана и настроек дисплея.
  2. ^ Скин Vector может скрывать ссылку в раскрывающемся меню , хотя это не относится к внешнему виду Vector по умолчанию в английской Википедии.