Шаблон: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] текст.

Примечания

править
  1. Иванов, 1985
  2. а б Иванов, 1985, с. 13
  3. Иванов, 1985, таблица 5
  4. а б Bennet et al, 1813
  5. Bennet et al, 1813: «This is a very important result!»
  6. 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     = Словарь Ушакова
}}
Дом[1].

Примечания

править

Литература

править

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

править

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

Код Результат
Текст{{sfn|Петров|2000}}{{sfn|Сидоров|с=123}} текст.

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

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

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

Примечания

править

Литература

править

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

править

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

Параметры шаблона[Править данные шаблона]

ПараметрОписаниеТипСтатус
ref-ссылка1

Ссылка на ref-якорь (параметр ref из шаблона-ссылки {{книга}} и т. п.)

Строковый (без форматирования)обязательный
год2

Если в шаблоне {{книга}} или {{статья}} указан параметр год=, то для отсылки к нему в шаблоне {{sfn}} должен быть указан тот же год, иначе отсылка через {{sfn}} не будет работать. Например: 1985

Числонеобязательный
пояснениеloc

Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)

Строковый (без форматирования)необязательный
цитатаquote

Дословная цитата из источника

Строковый (без форматирования)необязательный
pagep

page — номер страницы иноязычного источника (кроме немецких и польских). Например: 100

Числонеобязательный
pagespp

pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских). Например: 101—102

Строковый (без форматирования)необязательный
strona/…s

strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника. Например: 101—102

Строковый (без форматирования)необязательный
Seite(n)S

Seite(n) — номер страницы (диапазон страниц) немецкого источника. Например: 101—102

Строковый (без форматирования)необязательный
страницыстраницы с c

номер страницы (диапазон страниц). Например: 100, 101—102

Строковый (без форматирования)необязательный
имя группыgroup g

имя группы примечаний

Строковый (без форматирования)необязательный
имя сноскиname

имя существующего примечания

Строковый (без форматирования)необязательный
stylestyle

оборачивает в тег <span style=>

Строковый (без форматирования)необязательный

См. также

править