Шаблон предназначен для простановки коротких сносок на источники, перечисленные в списках литературы и внешних ссылок (разделы «Литература» и «Ссылки», см.ВП:Оформление статей#Структура статьи). Используется вместо парных тегов<ref></ref>.
Источники в разделах «Литература» или «Ссылки» оформляются специальными шаблонами ({{книга}},{{статья}},{{публикация}}, периодика —{{cite news}}, страницы сайтов —{{cite web}}). Для того чтобы из текста статьи сослаться на источник в этих разделах, нужно в соответствующий шаблон добавить параметрref= с идентификатором источника, который потом будет использоваться для сносок. Этот идентификатор будет показываться в примечаниях статьи как название ссылки, поэтому должен нести короткую визуально-значимую информацию. (Например, фамилии авторов или название источника, но не непонятные сокращения типа «md1».) Если фамилий много, то ставится фамилия первого автора с припиской «и др.» («et al»).
Пример:
{{книга | автор = Иванов И. И. | заглавие = Введение в практическую упячкологию | издательство = Наука | год = 1985 | страниц = 165| ref = Иванов}}
Параметры шаблона{{sfn}} позволяют указать конкретную страницу или диапазон страниц для русско- и англоязычных источников, расширить короткую сноску пояснительным текстом.
Ссылка ref из шаблона-ссылки ({{книга}} и т. п.). Обязательный параметр
год
1985
Если в шаблоне{{книга}} или{{статья}} указан параметргод=, то для отсылки к нему в шаблоне{{sfn}} должен быть указан тот же год, иначе отсылка через{{sfn}} не будет работать. В шаблоне{{cite web}} не используется.
loc
=
текст
Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)
quote
=
текст
Дословная цитата из источника. Обрамлять цитату кавычками не следует: шаблон сам подставляет кавычки-лапки
p
=
100
page — номер страницы иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских)
pp
=
100, 101—102
pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских)
S
Seite(n) — номер страницы (диапазон страниц) немецкого источника
s
strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника
Аналог атрибутаgroup= в теге<ref> (подробнее см. в описании шаблона{{примечания}})
group
name
=
имя сноски
Аналог атрибутаname= в теге<ref> (подробнее см.ниже)
Шаблоны{{sfn}} с одинаковыми аргументами автоматически используют одну общую сноску (см. примеры ниже).
Примеры
Основной способ применения
Пусть имеется раздел со списком литературы. Тогда ссылаться на книги из этого списка можно следующим образом:
Код
Результат
Текст{{sfn|Иванов|1985}} текст{{sfn|Иванов|1985|с=13}} текст{{sfn|Иванов|1985|с=13}} текст{{sfn|Иванов|1985|loc=таблица 5}} текст.Текст{{sfn|Bennet et al|1813}} текст{{sfn|Bennet et al|1813}} текст{{sfn|Bennet et al|1813|quote=This is a very important result!}} текст{{sfn|Bennet et al|1813|pp=141—142}} текст.== Примечания =={{примечания}}== Литература ==* {{книга | автор = Иванов И. И. | заглавие = Введение в практическую упячкологию | издательство = Наука | год = 1985 | страниц = 165 | ref = Иванов}}* {{статья | автор = Bennet E., Darcy F., Bennet J., Bingley C. | заглавие = Analytical theory of pride and prejudice | издание = Review of General Psychology | издательство = American Psychological Association | год = 1813 | номер = 2 | pages = 137—171 | ref = Bennet et al}}
Иванов И. И. Введение в практическую упячкологию. — Наука, 1985. — 165 с.
Bennet E., Darcy F., Bennet J., Bingley C. Analytical theory of pride and prejudice // Review of General Psychology. — American Psychological Association, 1813. —№ 2. — P. 137—171.
Обратите внимание: для коротких ссылок на источники, оформленные шаблонами{{книга}} и{{статья}} с непустым параметромгод=, кроме идентификатора («Иванов» и «Bennet et al») указывается соответствующий год — без этого ссылки работать не будут.
Использование в случае предварительно заданной ref-ссылки
Часто в шаблонах-ссылках на некоторые источники, оформленных на основе шаблонов{{книга}},{{статья}},{{cite news}} и{{cite web}}, уже есть предварительно заданный параметр «ref-ссылка». В этом случае в текущем шаблоне следует использовать параметр «ref-ссылка» именно в том виде, в каком он задан в шаблонах-ссылках на конкретный источник.
Иногда в шаблонах-ссылках на конкретные источники, также оформленных на основе шаблонов{{книга}},{{статья}},{{cite news}} и{{cite web}}, в значении параметра «ref» указана конструкция типа{{{ref|<ref-ссылка по умолчанию>}}}. В этом случае предусмотрено два варианта оформления сносок, когда параметр «ref-ссылка» указывается в шаблоне{{sfn}}:
А) По умолчанию.
В этом случае в размещаемом в тексте статьи (обычно, в разделе «Литература») шаблоне-ссылке на источник не следует дополнительно указывать значение параметра «ref», а шаблон{{sfn}} следует использовать с ref-ссылкой в том виде, в каком она задана в шаблоне-ссылке на источник: «<ref-ссылка по умолчанию>». Параметр «год» в шаблоне{{sfn}} следует указывать в соответствии с годом (годами), отображаемым в зависимости от того или иного варианта использования шаблона-ссылки на источник (иногда таких вариантов бывает несколько для одного и того же шаблона-сылки на источник, особенно в случае многотомных изданий).
Б) Произвольно.
В этом случае в шаблоне-ссылке на источник следует поставить дополнительную вертикальную черту, после которой указать произвольное (по желанию автора правки) значение параметра «|ref=<произвольная ref-ссылка>», которое и следует использовать в шаблоне{{sfn}}. Параметр «год» в шаблоне{{sfn}} следует задавать аналогично случаю указания параметра «ref-ссылка» по умолчанию.
Примеры использования шаблонов в этих случаях приведены в таблице:
Код
Результат
А)<ref-ссылка по умолчанию>
Дом{{sfn|Ушаков|1935}}.== Примечания =={{примечания}}== Литература ==* {{словарь Ушакова|Дом | ссылка = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1 | том = 1 | столбцы = 759}}
Параметрname= связан с одноимённом атрибутом тега<ref> (подробнее см. в описании шаблона{{примечания}}). Он позволяет задать для sfn-сноски новое имя и далее использовать для сносок этот тэг. Это может быть удобно, если ссылка sfn слишком длинная (включает имена страниц, комментарии и т. п.), и многократные её копии затрудняют редактирование текста. В отличие от ref-ссылки отсылающей на публикацию независимо от указанной страницы и комментариев в ней, name-ссылка отсылает на экземпляр sfn в котором была объявлена, то есть с теми же страницами и комментариями.
Если подобных сносок много и статья большая, то sfn может быть удобно разместить в разделе «Примечания» внутри шаблона{{примечания}} в параметре «refs=». Пример:
Код
Результат
Текст<ref name="Иванов105" /> текст. Ещё текст<ref name="Иванов105" />.== Примечания =={{примечания|refs={{sfn|Иванов|1956|страницы=105|loc=комментарий|name=Иванов105}}}}== Литература ==* {{книга|автор=Иванов И. И. |заглавие=Необъяснимое |год=1956 |ref=Иванов}}
Использование шаблона в комбинации с шаблоном-якорем
Альтернативный способ привязки короткой ссылки к источнику — использование шаблона{{sfn}} в комбинации с шаблоном-якорем{{h}}, не зависящим от шаблонов{{книга}},{{статья}},{{cite news}} и{{cite web}}.
Код
Результат
Текст{{sfn|Петров|2000а}}{{sfn|Сидоров|с=123}} текст. Ещё текст{{sfn|Петров|2000б|с=321}}.== Примечания =={{примечания}}== Литература ==* {{h|Петров|2000а}} ''Петров П. П.'' Мир и война. — {{М.}}: Искусство, 2000.* {{h|Петров|2000б}} ''Петров П. П.'' Свобода, равенство и братство. — {{М.}}: Философия, 2000.* {{h|Сидоров}} ''Сидоров С. С.'' Наказание и преступление. — {{СПб.}}: Культура.
Ссылка на ref-якорь (параметр ref из шаблона-ссылки {{книга}} и т. п.)
String
required
год
2
Если в шаблоне {{книга}} или {{статья}} указан параметр год=, то для отсылки к нему в шаблоне {{sfn}} должен быть указан тот же год, иначе отсылка через {{sfn}} не будет работать. Например: 1985
Number
optional
пояснение
loc
Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)
String
optional
цитата
quote
Дословная цитата из источника
String
optional
page
p
page — номер страницы иноязычного источника (кроме немецких и польских). Например: 100
Number
optional
pages
pp
pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских). Например: 101—102
String
optional
strona/…
s
strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника. Например: 101—102
String
optional
Seite(n)
S
Seite(n) — номер страницы (диапазон страниц) немецкого источника. Например: 101—102
String
optional
страницы
страницысc
номер страницы (диапазон страниц). Например: 100, 101—102