stringtranslate.com

Помощь:Раздел

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

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

  • WP:НУМЕРАЦИЯ РАЗДЕЛА
  • WP:SECTIONLEVELS

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

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

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

  • WP:LEVELONESECTION
  • WP:МАКС.УРОВЕНЬ

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

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

Нумерация

Разделы пронумерованы в содержании (не применимо в Vector 2022 ).

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

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

Завершающие секции

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

Содержание (TOC)

  • H:ОСНОВНОЕ
  • WP:TOC
Пример оглавления, отображаемого в стандартном скине Vector 2022

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

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

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

Позиционирование TOC

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

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

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

Плавающий TOC

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

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

Template:TOC right был предложен для удаления в начале июля 2005 года, но консенсуса по этому вопросу не было. Архив обсуждений и голосований по этому поводу можно увидеть на Wikipedia:Templates for deletion/TOCright . Обсуждение Manual of Style можно найти здесь .

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

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

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

  • H:LIMITTOC

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

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

  • WP:REPLACETOC

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

Горизонтальное оглавление

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

Пример: Легальность каннабиса по странам — используется краткое, но функциональное горизонтальное оглавление от 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]]т. д.

Подчеркивание и номер добавляются к дублирующимся названиям разделов. Например, для трех разделов с названием "Example" названия (для связи разделов) будут "Example", "Example_2" и "Example_3". Однако после редактирования раздела "Example_2" или "Example_3" (см. ниже) из сводки редактирования , что сбивает с толку, попадает в раздел "Example" .

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

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

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

Примечания:

Для ссылки на произвольное место на странице см. раздел Ссылка на раздел (якоря) .

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

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

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

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

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

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

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

  • WP:EDITLINK
  • WP:РЕДАКТИРОВАНИЕ РАЗДЕЛА

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

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

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

  • ВП:+

Навигация по страницам из пространств имен «talk» обеспечивает специальную ссылку с метками «Новый раздел», «+» или «Добавить тему», используемую для создания нового раздела в конце страницы. [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 />, отредактируйте раздел с меткой сноски, ссылающейся на него (см. Help:Footnotes ). Предварительный просмотр раздела покажет предварительный просмотр сноски.

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

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

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

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

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

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

Возможности редактирования также могут быть применены к разделу включенного шаблона. Этот раздел, Help:Editing sections of included templates , является примером.

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

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

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

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

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

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

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

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

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

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

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

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

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

Раздел трансклюзия

  • Помощь:ТРАНССЕКЦИЯ

Маркированный раздел трансклюзии

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

  • Помощь:TST

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

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

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

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

Раздел трансклюзия

После маркировки соответствующего (под-)раздела вы можете использовать вызов шаблона для включения раздела. Например, для включения раздела, вызванного chapter1со страницы, которая называется pageX:

{{:pageX|transcludesection=chapter1}}

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

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

Разделы для демонстрации выше

Демо http://example.com

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

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

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

Сноски

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