Шаблон:Sfn/doc

Шаблон предназначен для простановки коротких сносок на источники, перечисленные в списках литературы и внешних ссылок (разделы «Литература» и «Ссылки», см. ВП:Оформление статей#Структура статьи). Используется вместо парных тегов <ref></ref>.

Источники в разделах «Литература» или «Ссылки» оформляются специальными шаблонами ({{книга}}, {{статья}}, {{публикация}}, периодика — {{cite news}}, страницы сайтов — {{cite web}}). Для того чтобы из текста статьи сослаться на источник в этих разделах, нужно в соответствующий шаблон добавить параметр ref с идентификатором источника, который потом будет использоваться для сносок. Этот идентификатор будет показываться в примечаниях статьи как название ссылки, поэтому должен нести короткую визуально значимую информацию. (Например, фамилии авторов или название источника, но не непонятные сокращения типа «md1».) Если фамилий много, то ставится фамилия первого автора с припиской «и др.» («et al.»).

Пример:

{{sfn|Иванов|1985}}
...
{{книга
 | автор         = Иванов И. И.
 | заглавие      = Введение в практическую упячкологию
 | издательство  = Наука
 | год           = 1985
 | страниц       = 165
 | ref           = Иванов
}}

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

Синтаксис

{{sfn|ref-ссылка|год|loc=|quote=|p=|pp=|s=|S=|с=|g=|name=}}

Параметр	=	Формат	Пояснение
ref-ссылка		`Иванов`	Ссылка ref из шаблона-ссылки ({{книга}} и т. п.). Обязательный параметр
год		`1985`	Если в шаблоне {{книга}} или {{статья}} указан параметр `год`, то для отсылки к нему в шаблоне {{sfn}} должен быть указан тот же год, иначе отсылка через {{sfn}} не будет работать. Для отсылки к {{cite web}} указывать, наоборот, не следует.
`loc`	=	текст	Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)
`quote`	=	текст	Дословная цитата из источника. Обрамлять цитату кавычками не следует: шаблон сам подставляет кавычки-лапки
`p`	=	`100`	page — номер страницы иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских)
`pp`	=	`100, 101—102`	pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских)
`S`			Seite(n) — номер страницы (диапазон страниц) немецкого источника
`s`			strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника
`с`			Номер страницы (диапазон страниц) источника
`страницы`			Номер страницы (диапазон страниц) источника
`g`	=	имя группы	Аналог атрибута `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.
}}

Текст^[1] текст^[1] текст^[1] текст^[1] текст.

Примечания

↑ ^1,0 ^1,1 ^1,2 ^1,3 ^1,4 ^1,5 ^1,6 ^1,7 Иванов, 1985. Ошибка цитирования Неверный тег <ref>: название «_Ошибка скрипта: Модуля «Hash» не существует.» определено несколько раз для различного содержимого

Литература

Иванов И. И. Введение в практическую упячкологию. — Наука, 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-ссылка именно в том виде, в каком он задан в шаблонах-ссылках на конкретный источник.

Иногда же в таких шаблонах в значении параметра ref указана конструкция типа {{{ref|ref-ссылка по умолчанию}}}. В этом случае предусмотрено два варианта оформления сносок, когда параметр ref-ссылка указывается в шаблоне {{sfn}}:

По умолчанию.
В этом случае в размещаемом в тексте статьи (обычно в разделе «Литература») шаблоне — ссылке на источник не следует дополнительно указывать значение параметра ref, а шаблон {{sfn}} следует использовать с ref-ссылкой в том виде, в каком она задана в шаблоне-ссылке на источник: ref-ссылка по умолчанию. Параметр год в шаблоне {{sfn}} следует указывать в соответствии с годом (годами), отображаемым в зависимости от того или иного варианта использования шаблона — ссылки на источник (иногда таких вариантов бывает несколько для одного и того же шаблона-сылки на источник, особенно в случае многотомных изданий).
Произвольно.
В этом случае в шаблоне-ссылке на источник следует поставить дополнительную вертикальную черту, после которой указать произвольное (по желанию автора правки) значение параметра: |ref=произвольная ref-ссылка, которое и следует использовать в шаблоне {{sfn}}. Параметр год в шаблоне {{sfn}} следует задавать аналогично случаю указания параметра ref-ссылка по умолчанию.

Примеры использования шаблонов в этих случаях:

Код	Результат
1. ref-ссылка по умолчанию
Дом{{sfn\|Ушаков\|1935}}. == Примечания == {{примечания}} == Литература == * {{словарь Ушакова\|Дом \| ссылка = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1 \| том = 1 \| столбцы = 759 }}	Дом^[1]. Примечания ↑ Ушаков, 1935. Литература Дом // Толковый словарь русского языка : в 4 т. / сост. Г. О. Винокур, Б. А. Ларин, С. И. Ожегов, Б. В. Томашевский, Д. Н. Ушаков ; под ред. Д. Н. Ушакова. — М. : Государственный институт «Советская энциклопедия» : ОГИЗ, 1935. — Т. 1 : А — Кюрины. — Стб. 759.
2. Произвольная ref-ссылка
Дом{{sfn\|Словарь Ушакова\|1935}}. == Примечания == {{примечания}} == Литература == * {{словарь Ушакова\|Дом \| ссылка = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1 \| том = 1 \| столбцы = 759 \| ref = Словарь Ушакова }}	Дом^[1]. Примечания ↑ Словарь Ушакова, 1935. Литература Дом // Толковый словарь русского языка : в 4 т. / сост. Г. О. Винокур, Б. А. Ларин, С. И. Ожегов, Б. В. Томашевский, Д. Н. Ушаков ; под ред. Д. Н. Ушакова. — М. : Государственный институт «Советская энциклопедия» : ОГИЗ, 1935. — Т. 1 : А — Кюрины. — Стб. 759.

Использование с параметром name

Параметр name связан с одноимённом атрибутом тега <ref> (подробнее см. в описании шаблона {{примечания}}). Он позволяет задать для sfn-сноски новое имя и далее использовать для сносок этот тэг. Это может быть удобно, если ссылка sfn слишком длинная (включает имена страниц, комментарии и т. п.), и многократные её копии затрудняют редактирование текста. В отличие от ref-ссылки, отсылающей на публикацию независимо от указанной страницы и комментариев в ней, name-ссылка отсылает на экземпляр sfn, в котором была объявлена, то есть с теми же страницами и комментариями.

Если подобных сносок много и статья большая, то sfn может быть удобно разместить в разделе «Примечания» внутри шаблона {{примечания}} в параметре refs. Пример:

Код

Результат

Текст<ref name="Иванов105" /> текст. Ещё текст<ref name="Иванов105" />.

== Примечания ==
{{примечания|refs=
{{sfn|Иванов|1956|страницы=105|loc=комментарий|name=Иванов105}}
}}

== Литература ==
* {{книга|автор=Иванов И. И. |заглавие=Необъяснимое |год=1956 |ref=Иванов}}

Текст^[1] текст. Ещё текст^[1].

Примечания

↑ ^1,0 ^1,1 Иванов, 1956, комментарий, с. 105.

Литература

Иванов И. И. Необъяснимое. — 1956.

Использование шаблона в комбинации с шаблоном-якорем

Альтернативный способ привязки короткой ссылки к источнику — использование шаблона {{sfn}} в комбинации с шаблоном-якорем {{h}}, не зависящим от шаблонов {{книга}}, {{статья}}, {{cite news}} и {{cite web}}. Для того, чтобы строка или абзац с интересующим фрагментом текста при обращении к нему выделялась светло-голубым цветом среди других строк (что может быть особо актуальным в случае наличия длинного списка литературы в тех или иных статьях, а также для списков вообще), необходимо задать третий параметр в виде самого интересующего текста в пространстве между элементами синтаксиса |3= и }}.

Код	Результат
Текст{{sfn\|Петров\|2000а}}{{sfn\|Сидоров\|с=123}} текст{{sfn\|Иванов}}. Ещё текст{{sfn\|Петров\|2000б\|с=321}}. == Примечания == {{примечания}} == Литература == * {{h\|Иванов\|''Иванов И. И.'' Мир. Дружба. Жвачка. — {{М.}}: Политиздат.}} * {{h\|Петров\|2000а\|''Петров П. П.'' Мир и война. — {{М.}}: Искусство, 2000.}} * {{h\|Петров\|2000б\|''Петров П. П.'' Свобода, равенство и братство. — {{М.}}: Философия, 2000.}} * {{h\|Сидоров\|''Сидоров С. С.'' Наказание и преступление. — {{СПб.}}: Культура.}}	Текст^[1]^[1] текст^[1]. Ещё текст^[1]. Примечания ↑ ^1,0 ^1,1 ^1,2 ^1,3 Петров, 2000а. Ошибка цитирования Неверный тег `<ref>`: название «_Ошибка скрипта: Модуля «Hash» не существует.» определено несколько раз для различного содержимого Литература Иванов И. И. Мир. Дружба. Жвачка. — М.: Политиздат. Петров П. П. Мир и война. — М.: Искусство, 2000. Петров П. П. Свобода, равенство и братство. — М.: Философия, 2000. Сидоров С. С. Наказание и преступление. — СПб.: Культура.

См. также

{{sfn0}}
{{arf}}
{{rp}}
{{r}}

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

Оформление коротких сносок на источники, уже перечисленные в списке примечаний. См. https://ru.wikipedia.org/wiki/Шаблон:Sfn

Параметры шаблона
Параметр		Описание	Тип	Статус
ref-ссылка	`1`	Ссылка на ref-якорь (параметр ref из шаблона-ссылки {{книга}} и т. п.)	Строковый (без форматирования)	обязательный
год	`2`	Если в шаблоне {{книга}} или {{статья}} указан параметр год=, то для отсылки к нему в шаблоне {{sfn}} должен быть указан тот же год, иначе отсылка через {{sfn}} не будет работать. Например: 1985	Число	необязательный
пояснение	`loc`	Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)	Строковый (без форматирования)	необязательный
цитата	`quote`	Дословная цитата из источника	Строковый (без форматирования)	необязательный
page	`p`	page — номер страницы иноязычного источника (кроме немецких и польских). Например: 100	Число	необязательный
pages	`pp`	pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских). Например: 101—102	Строковый (без форматирования)	необязательный
strona/…	`s`	strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника. Например: 101—102	Строковый (без форматирования)	необязательный
Seite(n)	`S`	Seite(n) — номер страницы (диапазон страниц) немецкого источника. Например: 101—102	Строковый (без форматирования)	необязательный
страницы	`страницы` `с` `c`	номер страницы (диапазон страниц). Например: 100, 101—102	Строковый (без форматирования)	необязательный
имя группы	`group` `g`	имя группы примечаний	Строковый (без форматирования)	необязательный
имя сноски	`name`	имя существующего примечания	Строковый (без форматирования)	необязательный
style	`style`	оборачивает в тег <span style=>	Строковый (без форматирования)	необязательный

[_<strong_class="error"><span_class="scribunto-error_mw-scribunto-error-606643bc">Ошибка_скрипта:_Модуля_«Hash»_не_существует.</span></strong>-1] 1,0 ^1,1 ^1,2 ^1,3 ^1,4 ^1,5 ^1,6 ^1,7 Иванов, 1985. Ошибка цитирования Неверный тег <ref>: название «_Ошибка скрипта: Модуля «Hash» не существует.» определено несколько раз для различного содержимого

[_<strong_class="error"><span_class="scribunto-error_mw-scribunto-error-606643bc">Ошибка_скрипта:_Модуля_«Hash»_не_существует.</span></strong>-2] Ушаков, 1935.

[_<strong_class="error"><span_class="scribunto-error_mw-scribunto-error-606643bc">Ошибка_скрипта:_Модуля_«Hash»_не_существует.</span></strong>-3] Словарь Ушакова, 1935.

[Иванов105-4] 1,0 ^1,1 Иванов, 1956, комментарий, с. 105.

[_<strong_class="error"><span_class="scribunto-error_mw-scribunto-error-606643bc">Ошибка_скрипта:_Модуля_«Hash»_не_существует.</span></strong>-5] 1,0 ^1,1 ^1,2 ^1,3 Петров, 2000а. Ошибка цитирования Неверный тег <ref>: название «_Ошибка скрипта: Модуля «Hash» не существует.» определено несколько раз для различного содержимого

[1]

[1]

[1]

[1]

[1]