Шаблон:Sfn/doc

Файл:OOjs UI icon alert-yellow.svg

Этот шаблон используется на многих страницах, поэтому изменения в нём будут заметны многим. Пожалуйста, протестируйте любые изменения в песочнице или на вашей личной подстранице. Рассмотрите возможность обсуждения изменений на странице обсуждения или форуме перед их внесением.
Узнать число включений.

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

Источники в разделах «Литература» или «Ссылки» оформляются специальными шаблонами ({{Книга}}, {{Статья}}, {{Публикация}}, периодика — {{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|Иванов|Петров|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.
}}

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

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

Примечания

Литература

Иванов И. И. Введение в практическую упячкологию. — Наука, 1985. — 165 с.
Иванов И. И., Петров П. П. Практическая упячкология. Продвинутый курс. — Наука, 2007. — 299 с.
Шаблон:Статья

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

Использование с параметром 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 Шаблон:Sfn-текст.

Литература

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

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

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

Код

Результат

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

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

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

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

Примечания

Литература

См. также[править код]

{{Sfn0}}
{{Arf}}
{{Rp}}
{{R}}

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

Короткие сноски на источники в списке примечаний

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

[_b430f853f79287f3-1] Шаблон:Sfn-текст.

[_32b5ea1ea4ea223b-2] 2,0 ^2,1 Шаблон:Sfn-текст.

[_389e6a9857b6a822-3] Шаблон:Sfn-текст.

[_f8488c9f43b9ef95-4] Шаблон:Sfn-текст.

[_fef43248149d6218-5] 5,0 ^5,1 Шаблон:Sfn-текст.

[_3d2fcbfd9ce30999-6] Шаблон:Sfn-текст.

[_c6041922aad776a1-7] Шаблон:Sfn-текст.

[_944cf5b6a2cdd55d-8] Шаблон:Sfn-текст.

[_ced4d3e7af885105-9] Шаблон:Sfn-текст.

[Иванов105-10] 1,0 ^1,1 Шаблон:Sfn-текст.

[_1fb87cc53a7290b3-11] Шаблон:Sfn-текст.

[_9468734904be869f-12] Шаблон:Sfn-текст.

[_620169fcff6260c0-13] Шаблон:Sfn-текст.

[_f405a4e35051ca0a-14] Шаблон:Sfn-текст.

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[1]

[1]

[1]

[1]

[2]

[3]

[4]