Шаблон:Sfn/doc

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

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

Пример:

{{книга
 | автор         = Иванов И. И.
 | заглавие      = Введение в практическую упячкологию
 | издательство  = Наука
 | год           = 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] текст^[2] текст^[2] текст^[3] текст.

Текст^[4] текст^[4] текст^[5] текст^[6] текст.

Примечания

↑ Иванов, 1985.
↑ ^2.0 ^2.1 Иванов, 1985, с. 13.
↑ Иванов, 1985, таблица 5.
↑ ^4.0 ^4.1 Bennet et al, 1813.
↑ Bennet et al, 1813: «This is a very important result!».
↑ Bennet et al, 1813, pp. 141—142.

Литература

Иванов И. И. Введение в практическую упячкологию. — Наука, 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 }}	Дом^[1]. Примечания вироиш Шаблон:Примечания Литература вироиш Шаблон:Словарь Ушакова
Б) `<произвольная ref-ссылка>`
Дом{{sfn\|Словарь Ушакова\|1935}}. == Примечания == {{примечания}} == Литература == * {{словарь Ушакова\|Дом \| ссылка = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1 \| том = 1 \| столбцы = 759 \| ref = Словарь Ушакова }}	Дом^[2]. Примечания вироиш Шаблон:Примечания Литература вироиш Шаблон:Словарь Ушакова

Использование с параметром «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=Иванов}}

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

Примечания

↑ Ушаков, 1935.
↑ Словарь Ушакова, 1935.
↑ ^3.0 ^3.1 Иванов, 1956, комментарий.

Литература

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

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

Альтернативный способ привязки короткой ссылки к источнику — использование шаблона {{sfn}} в комбинации с шаблоном-якорем {{h}}, не зависящим от шаблонов {{книга}}, {{статья}}, {{cite news}} и {{cite web}}.

Код

Результат

Текст{{sfn|Петров|2000а}}{{sfn|Сидоров|с=123}} текст. Ещё текст{{sfn|Петров|2000б|с=321}}.

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

== Литература ==
* {{h|Петров|2000а}} ''Петров П. П.'' Мир и война. — {{М.}}: Искусство, 2000.
* {{h|Петров|2000б}} ''Петров П. П.'' Свобода, равенство и братство. — {{М.}}: Философия, 2000.
* {{h|Сидоров}} ''Сидоров С. С.'' Наказание и преступление. — {{СПб.}}: Культура.

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

Эзоҳ

↑ Петров, 2000а.
↑ Сидоров, с. 123.
↑ Петров, 2000б, с. 321.

Адабиёт

Шаблон:H Петров П. П. Мир и война. — М.: Искусство, 2000.
Шаблон:H Петров П. П. Свобода, равенство и братство. — М.: Философия, 2000.
Шаблон:H Сидоров С. С. Наказание и преступление. — СПб.: Культура.

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

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

Template parameters
Параметр		Тавзеҳот	Type	Status
ref-ссылка	`1`	Ссылка на 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	String	optional
имя группы	`group` `g`	имя группы примечаний	String	optional
имя сноски	`name`	имя существующего примечания	String	optional
style	`style`	оборачивает в тег <span style=>	String	optional

Ҳамчунин нигаред

{{sfn0}}
{{sfn-1}}
{{arf}}
{{rp}}
{{r}}

[Иванов—1985——-1] Иванов, 1985.

[Иванов—1985——13-2] 2.0 ^2.1 Иванов, 1985, с. 13.

[Иванов—1985—таблица_5—-3] Иванов, 1985, таблица 5.

[Bennet_et_al—1813——-4] 4.0 ^4.1 Bennet et al, 1813.

[Bennet_et_al—1813——This_is_a_very_important_result!-5] Bennet et al, 1813: «This is a very important result!».

[Bennet_et_al—1813——141—142-6] Bennet et al, 1813, pp. 141—142.

[Ушаков—1935——-7] Ушаков, 1935.

[Словарь_Ушакова—1935——-8] Словарь Ушакова, 1935.

[Иванов105-9] 3.0 ^3.1 Иванов, 1956, комментарий.

[Петров—2000а——-10] Петров, 2000а.

[Сидоров———123-11] Сидоров, с. 123.

[Петров—2000б——321-12] Петров, 2000б, с. 321.

[1]

[2]

[3]

[4]

[5]

[6]

[1]

[2]

[3]

[1]

[2]

[3]