Шаблон:Валэктонъёс/Документация

Использование

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

== Содержание ==
Мама мыла раму<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 и атрибут 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=Наказания}}

Несколько колонок

Используя {{валэктонъёс|2}} можно создавать двухколоночные списки примечаний, а {{валэктонъёс|3}} позволяет создать трёхколоночный список.

При указании ширины колонки, например: {{валэктонъёс|colwidth=30em}}, браузер автоматически выберет число колонок, основываясь на ширине страницы. Указывайте ширину колонки, достаточную для отображения средней ширины используемых примечаний.

Замечание: несколько колонок в настоящее время поддерживаются только в Gecko- и WebKit-браузерах (Firefox, Google Chrome, Safari), однако эта опция включена в CSS3, а следовательно, будет поддерживаться в будущем и другими браузерами.

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

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

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

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

Зарегистрированные пользователи могут поставить для сносок сворачивание по умолчанию, добавив в свой monobook.js следующую строку: document.cookie = 'refcoll=min', затем очистив кэш браузера (Mozilla / Firefox: Ctrl+Shift+R, IE: Ctrl+F5, Safari: Cmd+Shift+R, Konqueror: F5, Opera: через меню Tools→Preferences). Подробнее смотрите ru:ВП:Персональное оформление.

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

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