Редактирование: Шаблон:Примечания/doc

{{Docpage}}
{{СИШ}}
{{Используйте песочницу}}
Используйте этот шаблон для создания списка примечаний, как отражено в руководстве '''[[Википедия:Сноски]]'''.

Шаблон {{T|Примечания}} не содержит заголовка секции, что делает чтение исходного текста статей более удобным:
<pre>
== Содержание ==
Мама мыла раму<ref>Аннотированный список видов рам</ref>.

Раму мыла мама<ref>Пособие по мытью рам</ref>.

== Примечания ==
{{Примечания}}
</pre>

== Базовые параметры ==
С помощью атрибута <code>name</code> можно задавать имя примечания, чтобы в дальнейшем использовать его по имени.
<pre>
== Содержание ==
Мама мыла раму<ref name="list">Аннотированный список видов рам</ref>.

Раму мыла мама<ref>Пособие по мытью рам</ref>.

Ещё одна мама мыла раму<ref name="list" />.

== Примечания ==
{{Примечания}}
</pre>
{{Видимый якорь|refs|текст=
Для облегчения чтения текста при редактировании саму сноску можно разместить не в тексте, а ниже — в параметре <code>refs</code> этого шаблона, однако использование такой конструкции делает сноски недоступными через [[Википедия:Визуальный редактор|визуальный редактор]]. А в тексте использовать сноски по имени (<code>name</code>).}}
<pre>
== Содержание ==
Мама мыла раму<ref name="link"/>.

Раму мыла мама<ref name="list"/>.

== Примечания ==
{{Примечания|refs=
<ref name="list">Аннотированный список видов рам</ref>
<ref name="link">Аннотированный список видов ламп</ref>
}}
</pre>

Используя атрибут <code>group</code>, можно группировать примечания.
<pre>
== Содержание ==
Мама мыла раму<ref group="rama">Аннотированный список видов рам</ref>.

Раму мыла мама<ref group="rama">Пособие по мытью рам</ref>.

== Примечания ==
{{Примечания|group=rama}}
</pre>

При этом примечания без указания группы тоже, по сути, входят в отдельную группу. В самом шаблоне можно указывать группу через параметр <code>group</code> или <code>группа</code>.

Выводить примечания повторно нельзя.

Используя атрибут <code>group</code> и атрибут <code>name</code>, можно группировать именованные примечания.
<pre>
== Содержание ==
Нас ждёт рассказ о возмездии и воздаянии<ref>Было это давным-давно</ref>

Столько лет прошло…<ref name="Награда1" group="Награды">Награда нашла героя</ref>

Потом у героя отобрали награду<ref name="Награда1" group="Награды"/>.

Героя наказали<ref name="Наказание1" group="Наказания">Поделом имяреку!</ref>.

Позже он описал и это<ref name="Наказание2" group="Наказания">К ответу!</ref>.

Так раньше наказывали<ref name="Наказание1" group="Наказания"/>.

== Примечания ==
{{Примечания}}

'''Награды'''
{{Примечания|group=Награды}}

'''Наказания'''
{{Примечания|group=Наказания}}
</pre>

Также с помощью стандартных значений атрибута <code>group</code> можно заменять установленное по умолчанию индексирование примечаний арабскими цифрами на другие:
: <code>upper-alpha</code> — прописные буквы латинского алфавита
: <code>upper-roman</code> — прописные римские цифры
: <code>lower-alpha</code> — строчные буквы латинского алфавита
: <code>lower-greek</code> — строчные буквы греческого алфавита
: <code>lower-roman</code> — строчные римские цифры
<pre>
== Содержание ==
Стандартно примечания нумеруются арабскими цифрами<ref>Арабские цифры — это 1, 2, 3, 4…</ref>

Но можно их поменять на другие, например — латинские буквы<ref name="альфа1" group="lower-alpha">Строчные латинские буквы — это a, b, c, d, e…</ref><ref name="альфа2" group="upper-alpha">Прописные латинские буквы — это A, B, C, D, E…</ref>.

Можно пронумеровать римскими цифрами<ref name="роман1" group="lower-roman">Строчные римские цифры — это i, ii, iii, iv, v…</ref><ref name="роман2" group="upper-roman">Прописные римские цифры — это I, II, III, IV, V…</ref>.

А можно даже использовать греческий алфавит<ref name="грек1" group="lower-greek">Строчные греческие буквы — это α, β, γ, δ, ε…</ref>.

Так можно, например, отделить комментарии от ссылок на источники<ref name="альфа1" group="lower-alpha"/><ref name="роман2" group="upper-roman"/><ref name="грек1" group="lower-greek"/>.

== Примечания ==
{{Примечания}}

'''Комментарии'''
{{Примечания|group=lower-alpha}}

'''Архивные источники'''
{{Примечания|group=upper-alpha}}

'''Литературные источники'''
{{Примечания|group=lower-roman}}

'''Онлайн-источники'''
{{Примечания|group=upper-roman}}

'''Прочее'''
{{Примечания|group=lower-greek}}
</pre>

== Ширина колонок ==
Список примечаний [[mw:Contributors/Projects/Columns for references|автоматически]] делится на колонки, если примечаний больше 10.
* Если вам нужны более узкие (например, если в примечаниях содержатся шаблоны типа {{T|Sfn}}) или более широкие колонки, укажите <code>узкие</code> или <code>широкие</code> в первом параметре (например, {{Tc|примечания|узкие}} и {{Tc|примечания|широкие}}).
* Чтобы не делить список примечаний на колонки, укажите <code>1</code> в первом параметре (например, {{Tc|примечания|1}}).
* Чтобы задать ширину колонки самостоятельно, укажите её в [https://learn.javascript.ru/css-units#относительно-шрифта-em em] (например, {{Tc|примечания|30em}}; <code>30em</code> — стандартная ширина колонки). В таком случае колонки будут всегда, а не только тогда, когда примечаний больше 10.
* Старый способ создания колонок — прямое указание их числа — больше не работает (см. [[Википедия:Форум/Архив/Предложения/2018/06#И снова о колонках примечаний]]). В настоящий момент для обратной совместимости значения числа колонок от 4 и выше интерпретируются так же, как значение <code>узкие</code> ([[ВП:Викификатор|Викификатор]] выполняет автоматическую замену устаревших значений).

== Сворачивание ==
Длинные блоки примечаний (больше 40[https://learn.javascript.ru/css-units#otnositelno-shrifta-em em] по высоте) пользователи могут сворачивать; при этом для не поместившихся примечаний организуется прокрутка. Состояние запоминается при переходе между страницами.

== Категоризация ==
Статьи, в которых используются нераспознанные параметры шаблона, добавляются в {{C|Википедия:Страницы с некорректным использованием шаблонов:Примечания|ю}}.

== См. также ==
* {{T|Arf}}
* {{T|Ref+}}
* {{T|Sfn}}
* {{T|Комментарии}}

== Параметры шаблона для визуального редактора ==
<templatedata>
{
	"description": "Создаёт список примечаний. Вставленные в текст сноски с источниками (ref) сами появится в этом разделе примечаний.",
	"params": {
		"1": {
			"label": "Ширина колонок",
			"description": "Если примечаний больше 10, примечания будут автоматически разбиты на колонки. Задайте значение «узкие», чтобы колонки были уже, или «широкие», чтобы они были шире. Чтобы отключить разбиение на колонки, задайте «1». Чтобы задать точную ширину колонки, укажите её в единицах измерения em, например: «30em» (это стандартное значение ширины).",
			"type": "string",
			"default": "30em",
			"required": false
		},
		"refs": {
			"label": "сноски",
			"description": "Для облегчения чтения текста при редактировании саму сноску можно разместить не в тексте, а ниже — в этом параметре шаблона. А в тексте использовать сноски по имени (name).",
			"type": "string",
			"required": false
		},
		"group": {
			"label": "группа",
			"description": "Параметр для группировки примечаний.",
			"type": "string",
			"required": false
		},
		"colwidth": {
			"label": "Ширина колонки",
			"description": "Устаревший параметр",
			"type": "line",
			"default": "30em",
			"required": false,
			"deprecated": "(Устаревший параметр, используйте вместо него первый.) При указании ширины колонки браузер автоматически выберет число колонок, основываясь на ширине страницы. Указывайте ширину колонки, достаточную для отображения средней ширины используемых примечаний."
		}
	}
}
</templatedata>

<includeonly>
[[Категория:Шаблоны:Ссылки на источники]]
[[Категория:Шаблоны:Разделы статьи]]
</includeonly>