Ҳуҷҷатгузорӣ

Используйте этот шаблон для создания списка примечаний, как отражено в руководстве Википедиа:Пайнавиштҳо.

В отличие от шаблона {{subst:footnotes}}, шаблон {{эзоҳ}} не содержит заголовка секции, что делает чтение исходного текста статей более удобным. Например:

== Мундариҷа ==
Мама мыла раму<ref>Аннотированный список видов рам</ref>.

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

== Эзоҳ ==
{{эзоҳ}}

Параметрҳои асосӣ

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

== Содержание ==
Мама мыла раму<ref name="list">Аннотированный список видов рам</ref>.

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

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

== Эзоҳ ==
{{эзоҳ}}

Для облегчения чтения текста при редактировании саму сноску можно разместить не в тексте, а ниже — в параметре refs этого шаблона. А в тексте использовать сноски по имени (name).

== Мундариҷа ==
Мама мыла раму<ref name="link"/>.

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

== Эзоҳ ==
{{эзоҳ|refs=
<ref name="list">Аннотированный список видов рам</ref>
<ref name="link">Аннотированный список видов ламп</ref>
}}

Используя атрибут group, можно группировать примечания.

== Мундариҷа ==
Мама мыла раму<ref group="rama">Аннотированный список видов рам</ref>.

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

== Эзоҳ ==
{{эзоҳ|group=rama}}

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

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

Используя атрибут group и атрибут name, можно группировать именованные примечания.

== Мундариҷа ==
Нас ждёт рассказ о возмездии и воздаянии<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=Наказания}}

Якчанд сутун

При указании ширины колонки, например: {{эзоҳ|30em}}, браузер автоматически выберет число колонок, основываясь на ширине экрана. Указывайте ту ширину колонки, которая позволит показать примечания наиболее компактно в данной конкретной статье (это будет зависеть от средней длины примечаний в ней).

Устаревший способ создания многоколоночных примечаний — непосредственное указание числа колонок, например {{эзоҳ|2}} для двух колонок или {{эзоҳ|3}} для трёх.

Сворачивание

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

Разные браузеры организуют прокрутку многоколоночных списков по-разному: Firefox (до версии 22.0) показывает вертикальную прокрутку, а Chrome, Safari и Firefox (с версии 22.0) — горизонтальную (если задано количество колонок, то ровно столько колонок будут видны на экране одновременно).

На версии для печати сворачивание отключено.

Множественное использование

Если шаблон {{эзоҳ}} используется в тексте статьи несколько раз и без параметров, то при каждом использовании он будет выводить в виде списка все сноски, которые были сделаны в статье вплоть до места вставки такого шаблона. Для того чтобы потребовать от парсера, чтобы он «закрывал» уже сформированные списки сносок, надо при каждом использовании шаблона {{эзоҳ}} передавать ему хоть какие-нибудь параметры. Даже неопределёные параметры, например: {{эзоҳ|close=1}}, могут быть использованы для таких целей.

Параметры шаблона для визуального редактора

Создаёт список примечаний. В отличие от шаблона {{subst:footnotes}}, этот шаблон не включает в себя заголовок секции, что делает чтение исходного текста статей более удобным.

Template parameters[Edit template data]

ПараметрТавзеҳотTypeStatus
число колонок1

Параметр для создания двухколоночных и трёхколоночных списков примечаний.

Пешфарз
1
Numberoptional
сноскиrefs

Для облегчения чтения текста при редактировании саму сноску можно разместить не в тексте, а ниже — в этом параметре шаблона. А в тексте использовать сноски по имени (name).

Stringoptional
группаgroup

Параметр для группировки примечаний.

Stringoptional
ширина колонкиcolwidth

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

Пешфарз
30em
Stringoptional
закрытьclose

Если шаблон {{эзоҳ}} используется в тексте статьи несколько раз и без параметров, то при каждом использовании он будет выводить в виде списка все сноски, которые были сделаны в статье вплоть до места вставки такого шаблона. Для того чтобы потребовать от парсера, чтобы он «закрывал» уже сформированные списки сносок, надо при каждом использовании шаблона {{примечания}} передавать ему хоть какие-нибудь параметры. Этот параметр используется для такой цели.

Пешфарз
1
Numberoptional

Эзоҳ

Нигаред