Редактирование: Шаблон:Sfn/doc

{{Docpage}}
{{High-use}}
Шаблон предназначен для простановки коротких сносок на источники, перечисленные в списках литературы, и внешних ссылок (разделы «Литература» и «Ссылки», см. [[РуСказки:Оформление статей#Структура статьи]]). Используется вместо парных тегов {{Tag|Ref}}. sfn - shortened footnote template.

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

Пример:
 <nowiki>{{</nowiki>Sfn|Иванов|1985<nowiki>}}</nowiki>
 ...
 <nowiki>{{Книга</nowiki>
  | автор         = Иванов И. И.
  | заглавие      = Введение в практическую упячкологию
  | издательство  = Наука
  | год           = 1985
  | страниц       = 165
  '''| ref           = Иванов'''
 <nowiki>}}</nowiki>

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

== Синтаксис ==
: <code><nowiki>{{</nowiki>Sfn|''ref-ссылка''|''год''|loc=|quote=|p=|pp=|s=|S=|{{Abbr|с|кириллица|0}}=|{{Abbr|стб|кириллица|0}}=|g=|name=<nowiki>}}</nowiki></code>

{| class=wikitable
 ! Параметр || = || Формат || Пояснение
 |-
 | ''ref-ссылка'' || || <code>Иванов</code> || Ссылка ref из шаблона-ссылки ({{Tl|Книга}} и т. п.). Обязательный параметр. Может быть указано несколько через вертикальную черту (фактически в разных параметрах).
 |-
 | ''год'' || || <code>1985</code> || В шаблоне {{Tl|Книга}} или {{Tl|Статья}} должен быть указан параметр <code>год</code>, и для отсылки к нему в шаблоне {{Tl|Sfn}} должен быть указан тот же год, иначе отсылка через {{Tl|Sfn}} не будет работать. Для отсылки к {{Tl|Cite web}} указывать, наоборот, не следует.
 |-
 | <code>loc</code> || = || ''текст'' || Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)
 |-
 | <code>quote</code> || = || ''текст'' || Дословная цитата из источника. Обрамлять цитату кавычками не следует: шаблон сам подставляет кавычки-лапки.
 |-
 | <code>p</code> || = || <code>100</code> || page — номер страницы иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских).
 |-
 | <code>pp</code> ||rowspan=7| = ||rowspan="7" nowrap| <code>100, 101—102</code> || pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских).
 |-
 | <code>S</code> || Seite(n) — номер страницы (диапазон страниц) немецкого источника.
 |-
 | <code>s</code> || strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника.
 |-
 | {{Abbr|<code>с</code>|кириллица|0}} ||rowspan=2| Номер страницы (диапазон страниц) источника
 |-
 | <code>страницы</code> 
 |-
 | {{Abbr|<code>стб</code>|кириллица|0}} ||rowspan=2| Номер столбца (диапазон столбцов) источника 
 |-
 | <code>столбцы</code> 
 |-
 | <code>g</code> ||rowspan=2| = ||rowspan=2| ''имя группы'' ||rowspan="2"| Аналог атрибута <code>group</code> в теге {{Tago|Ref}} (подробнее см. в описании шаблона {{Tl|Примечания}})
 |-
 | <code>group</code> 
 |-
 | <code>name</code> || = || ''имя сноски'' || Аналог атрибута <code>name</code> в теге {{Tago|Ref}} (подробнее см. [[#Использование с параметром name|ниже]])
|}

Шаблоны {{Tl|Sfn}} с одинаковыми аргументами автоматически используют одну общую сноску (см. примеры ниже).

== Примеры ==

=== Основной способ применения ===
Пусть имеется раздел со списком литературы. Тогда ссылаться на книги из этого списка можно следующим образом:

{| class="wikitable wide"
 ! Код || Результат
 |-valign=top
 |width=50%|<pre style="border:0; padding:0 1em 0 1em; white-space:pre-wrap">
Текст{{Sfn|Иванов|1985}} текст{{Sfn|Иванов|1985|с=13}} текст{{Sfn|Иванов|1985|с=13}} текст{{Sfn|Иванов|1985|loc=таблица 5}} текст{{Sfn|Иванов|Петров|2007}} текст.

Текст{{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          = Иванов
}}
* {{Книга
 | автор        = Иванов И. И., Петров П. П.
 | заглавие     = Практическая упячкология. Продвинутый курс
 | издательство = Наука
 | год          = 2007
 | страниц      = 299
 | 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.
}}
</pre>
|style=padding:1em|
Текст{{Sfn|Иванов|1985}} текст{{Sfn|Иванов|1985|с=13}} текст{{Sfn|Иванов|1985|с=13}} текст{{Sfn|Иванов|1985|loc=таблица 5}} текст{{Sfn|Иванов|Петров|2007}} текст.

Текст{{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}} текст.

{{Фальшзаголовки|Примечания}}
{{Примечания}}{{^|1em}}

{{Фальшзаголовки|Литература}}
* {{Книга
 | автор        = Иванов И. И.
 | заглавие     = Введение в практическую упячкологию
 | издательство = Наука
 | год          = 1985
 | страниц      = 165
 | ref          = Иванов
}}
* {{Книга
 | автор        = Иванов И. И., Петров П. П.
 | заглавие     = Практическая упячкология. Продвинутый курс
 | издательство = Наука
 | год          = 2007
 | страниц      = 299
 | 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.
}}
|}

Обратите внимание: для коротких ссылок на источники, оформленные шаблонами {{Tl|Книга}} и {{Tl|Статья}} с непустым параметром <code>год</code>, кроме идентификатора («Иванов» и «Bennet et al.») указывается соответствующий год — без этого ссылки работать не будут.

=== Использование в случае предварительно заданной ref-ссылки ===
Часто в шаблонах — ссылках на некоторые источники, оформленных на основе шаблонов {{Tl|Книга}}, {{Tl|Статья}}, {{Tl|Cite news}} и {{Tl|Cite web}}, уже есть предварительно заданный параметр <code>''ref-ссылка''</code>. В этом случае в текущем шаблоне следует использовать параметр <code>''ref-ссылка''</code> именно в том виде, в каком он задан в шаблонах — ссылках на конкретный источник.

Иногда же в таких шаблонах в значении параметра <code>ref</code> указана конструкция типа {{Param|ref|''ref-ссылка по умолчанию''}}. В этом случае предусмотрено два варианта оформления сносок, когда параметр <code>''ref-ссылка''</code> указывается в шаблоне {{Tl|Sfn}}:
# '''По умолчанию.'''<br>В этом случае в размещаемом в тексте статьи (обычно в разделе «Литература») шаблоне — ссылке на источник не следует дополнительно указывать значение параметра <code>ref</code>, а шаблон {{Tl|Sfn}} следует использовать с ref-ссылкой в том виде, в каком она задана в шаблоне-ссылке на источник: <code>''ref-ссылка по умолчанию''</code>. Параметр <code>''год''</code> в шаблоне {{Tl|Sfn}} следует указывать в соответствии с годом (годами), отображаемым в зависимости от того или иного варианта использования шаблона — ссылки на источник (иногда таких вариантов бывает несколько для одного и того же шаблона — ссылки на источник, особенно в случае многотомных изданий).
# '''Произвольно.'''<br>В этом случае в шаблоне — ссылке на источник следует поставить дополнительную вертикальную черту, после которой указать произвольное (по желанию автора правки) значение параметра: <code>|ref=''произвольная ref-ссылка''</code>, которое и следует использовать в шаблоне {{Tl|Sfn}}. Параметр <code>''год''</code> в шаблоне {{Tl|Sfn}} следует задавать аналогично случаю указания параметра <code>''ref-ссылка''</code> по умолчанию.

Примеры использования шаблонов в этих случаях:
{| class=wikitable
 ! Код
 ! Результат
 |-
 !colspan=2|1. ref-ссылка по умолчанию
 |-
 | <pre style="border:0; padding: 0 1em; white-space:-moz-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word">Дом{{Sfn|Ушаков|1935}}.

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

== Литература ==
* {{Словарь Ушакова|Дом
 | ссылка  = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1
 | том     = 1
 | столбцы = 759
}}</pre>
 |style=padding:1em| Дом{{Sfn|Ушаков|1935}}.

{{Фальшзаголовки|Примечания}}
{{Примечания}}

{{Фальшзаголовки|Литература}}
* {{Словарь Ушакова|Дом
 | ссылка  = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1
 | том     = 1
 | столбцы = 759
}}
 |-
 !colspan=2|2. Произвольная ref-ссылка
 |-
 | <pre style="border:0; padding: 0 1em; white-space:-moz-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word">Дом{{Sfn|Словарь Ушакова|1935}}.

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

== Литература ==
* {{Словарь Ушакова|Дом
 | ссылка  = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1
 | том     = 1
 | столбцы = 759
 | ref     = Словарь Ушакова
}}</pre>
 |style=padding:1em| Дом{{Sfn|Словарь Ушакова|1935}}.

{{Фальшзаголовки|Примечания}}
{{Примечания}}

{{Фальшзаголовки|Литература}}
* {{Словарь Ушакова|Дом
 | ссылка  = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1
 | том     = 1
 | столбцы = 759
 | ref     = Словарь Ушакова
}}
|}

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

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

{| class="wikitable wide"
 ! Код || Результат
 |-valign=top
 |width=50%|<pre style="border:0; padding:0 1em 0 1em; white-space:pre-wrap">
Текст<ref name="Иванов105" /> текст. Ещё текст<ref name="Иванов105" />.

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

== Литература ==
* {{Книга|автор=Иванов И. И. |заглавие=Необъяснимое |год=1956 |ref=Иванов}}
</pre>
 |style=padding:1em|
Текст<ref name="Иванов105" /> текст. Ещё текст<ref name="Иванов105" />.

{{Фальшзаголовки|Примечания}}
{{Примечания|refs=
{{Sfn|Иванов|1956|страницы=105|loc=комментарий|name=Иванов105}}
}}

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

=== Использование шаблона в комбинации с шаблоном-якорем ===
Альтернативный способ привязки короткой ссылки к источнику — использование шаблона {{Tl|Sfn}} в комбинации с шаблоном-[[РуСказки:Ссылка на раздел#Якоря|якорем]] {{Tl|H}}, не зависящим от шаблонов {{Tl|Книга}}, {{Tl|Статья}}, {{Tl|Cite news}} и {{Tl|Cite web}}. Для того чтобы строка или абзац с интересующим фрагментом текста при обращении к нему <span style="background-color:#eaf3ff">выделялась светло-голубым цветом</span> среди других строк (что может быть особо актуальным в случае наличия длинного списка литературы в тех или иных статьях, а также для списков вообще), необходимо задать третий параметр в виде самого интересующего текста в пространстве между элементами синтаксиса <code><nowiki>|3=</nowiki></code> и <code><nowiki>}}</nowiki></code>.
{| class="wikitable wide"
 ! Код || Результат
 |-valign=top
 |width=50%|<pre style="border:0; padding:0 1em 0 1em; white-space:pre-wrap">
Текст{{Sfn|Петров|2000а}}{{sfn|Сидоров|с=123}} текст{{Sfn|Иванов}}. Ещё текст{{Sfn|Петров|2000б|с=321}}.

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

== Литература ==
* {{H|Иванов||''Иванов И. И.'' Мир. Дружба. Жвачка. — {{М.}}: Политиздат.}}
* {{H|Петров|2000а|''Петров П. П.'' Мир и война. — {{М.}}: Искусство, 2000.}}
* {{H|Петров|2000б|''Петров П. П.'' Свобода, равенство и братство. — {{М.}}: Философия, 2000.}}
* {{H|Сидоров|3=''Сидоров С. С.'' Наказание и преступление. — {{СПб.}}: Культура.}}
</pre>

 |style=padding:1em|
Текст{{Sfn|Петров|2000а}}{{Sfn|Сидоров|с=123}} текст{{Sfn|Иванов}}. Ещё текст{{Sfn|Петров|2000б|с=321}}.

{{Фальшзаголовки|Примечания}}
{{Примечания}}

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

== См. также ==
* {{Tl|Sfn0}}
* {{Tl|Arf}}
* {{Tl|Rp}}
* {{Tl|R}}

== Параметры шаблона для визуального редактора ==
<templatedata>
{
	"description": "Короткие сноски на источники в списке примечаний",
	"params": {
		"1": {
			"label": "ref-ссылка",
			"description": "Ссылка на ref-якорь (параметр ref из шаблона-ссылки {{Книга}} и т. п.)",
			"type": "string",
			"required": true,
			"suggested": true
		},
		"2": {
			"label": "год",
			"description": "Если в шаблоне {{Книга}} или {{Статья}} указан параметр год=, то для отсылки к нему в шаблоне {{Sfn}} должен быть указан тот же год, иначе отсылка через {{Sfn}} не будет работать.",
			"type": "number",
			"required": false,
			"suggested": true,
			"example": "1985"
		},
		"loc": {
			"label": "пояснение",
			"description": "Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)",
			"type": "string",
			"required": false
		},
		"quote": {
			"label": "цитата",
			"description": "Дословная цитата из источника",
			"type": "string",
			"required": false
		},
		"p": {
			"label": "page",
			"description": "page — номер страницы иноязычного источника (кроме немецких и польских). Например: 100",
			"type": "number",
			"required": false
		},
		"pp": {
			"label": "pages",
			"description": "pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских). Например: 101—102",
			"type": "string",
			"required": false
		},
		"s": {
			"label": "strona/…",
			"description": "strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника. Например: 101—102",
			"type": "string",
			"required": false
		},
		"S": {
			"label": "Seite(n)",
			"description": "Seite(n) — номер страницы (диапазон страниц) немецкого источника. Например: 101—102",
			"type": "string",
			"required": false
		},
		"страницы": {
			"label": "страницы",
			"description": "номер страницы (диапазон страниц)",
			"type": "string",
			"required": false,
			"aliases": [
				"с"
			],
			"example": "100, 101—102"
		},
		"group": {
			"label": "имя группы",
			"description": "имя группы примечаний",
			"type": "string",
			"required": false,
			"aliases": [
				"g"
			]
		},
		"name": {
			"label": "имя сноски",
			"description": "имя существующего примечания",
			"type": "string",
			"required": false
		},
		"style": {
			"label": "style",
			"description": "оборачивает в тег <span style=>",
			"type": "boolean",
			"required": false
		},
		"стб": {},
		"столбцы": {}
	},
	"paramOrder": [
		"1",
		"2",
		"страницы",
		"loc",
		"quote",
		"p",
		"pp",
		"s",
		"S",
		"group",
		"name",
		"style",
		"стб",
		"столбцы"
	],
	"format": "inline"
}
</templatedata>

<includeonly>
[[Категория:Шаблоны:Сноски]]
</includeonly>