Шаблон:Sfn/Документация

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

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

Пример:

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

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

Синтаксис

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

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

Обязательным является только первый параметр. Второй (безымянный) параметр с номером года обязателен, если в соответствующем шаблоне {{книга}} или {{статья}} указан параметр год= — в этом случае в шаблоне {{sfn}} вторым параметром должен быть указан тот же год, иначе отсылка не будет работать. Это позволяет нескольким ссылкам, отличающимся годами (например, нескольким книгам одного автора), дать один и тот же идентификатор (например, фамилию автора). Для шаблонов {{книга}} и {{статья}} без параметра год= и для шаблона {{cite web}} указывается только идентификатор.

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

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

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

Код

Результат

Текст{{sfn|Петров|2000}}{{sfn|Сидоров|с=123}} текст.

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

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

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

Литература

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

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

Данный шаблон предназначен для простановки коротких сносок на источники, уже перечисленные в списке примечаний. См. 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=>	Строковый (без форматирования)	необязательный

См. также

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

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

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

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

[Bennet_et_al—1813——-4] а ^б 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

[Петров—2000——-9] Петров, 2000

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

[1]

[2]

[3]

[4]

[5]

[6]

[1]

[1]

[1]

[2]