Просмотр исходного текста страницы Шаблон:Sfn/doc

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

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

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

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

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

{| class=wikitable
 ! Параметр || = || Формат || Пояснение
 |-
 | ''ref-ссылка'' || || <tt>Иванов</tt> || Ссылка ref из шаблона-ссылки ({{t|книга}} и т. п.). Обязательный параметр
 |-
 | ''год'' || || <tt>1985</tt> || Если в шаблоне {{t|книга}} или {{t|статья}} указан параметр <code>год=</code>, то для отсылки к нему в шаблоне {{t|sfn}} должен быть указан тот же год, иначе отсылка через {{t|sfn}} не будет работать
 |-
 | <tt>loc</tt> || = || ''текст'' || Пояснение (например, указание на раздел или главу источника, на таблицу, рисунок, уравнение и т. п.)
 |-
 | <tt>quote</tt> || = || ''текст'' || Дословная цитата из источника. Обрамлять цитату кавычками не следует: шаблон сам подставляет кавычки-лапки
 |-
 | <tt>p</tt> || = || <tt>100</tt> || page — номер страницы иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских)
 |-
 | <tt>pp</tt> ||rowspan=5| = ||rowspan="5" nowrap| <tt>100, 101—102</tt> || pages — диапазон страниц иноязычного источника (кроме немецких, норвежских, польских, словацких, словенских, турецких, хорватских, чешских и шведских)
 |-
 | <tt>S</tt> || Seite(n) — номер страницы (диапазон страниц) немецкого источника
 |-
 | <tt>s</tt> || strona/… — номер страницы (диапазон страниц) норвежского, польского, словацкого, словенского, турецкого, хорватского, чешского или шведского источника
 |-
 | {{abbr|<tt>с</tt>|кириллица|0}} ||rowspan=2| Номер страницы (диапазон страниц) источника
 |-
 | <tt>страницы</tt> 
 |-
 | <tt>g</code> ||rowspan=2| = ||rowspan=2| ''имя группы'' ||rowspan="2"| Аналог атрибута <code>group=</code> в теге <code>&lt;ref&gt;</tt> (подробнее см. в описании шаблона {{t|примечания}})
 |-
 | <tt>group</tt> 
 |-
 | <tt>name</tt> || = || ''имя сноски'' || Аналог атрибута <code>name=</code> в теге <code>&lt;ref&gt;</code> (подробнее см. в описании шаблона {{t|примечания}})
|}

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

Шаблоны {{t|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|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
}}
</pre>
|style=padding:1em|
Текст{{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}} текст.

== Примечания ==
{{примечания|close=1}}{{^|1em}}

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

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

=== Использование в случае предварительно заданной ref-ссылки ===
Часто в шаблонах-ссылках на некоторые источники, оформленных на основе шаблонов {{t|книга}}, {{t|статья}}, {{t|cite news}} и {{t|cite web}}, уже есть предварительно заданный параметр «ref-ссылка». В этом случае в текущем шаблоне следует использовать параметр «ref-ссылка» именно в том виде, в каком он задан в шаблонах-ссылках на конкретный источник.

Иногда в шаблонах-ссылках на конкретные источники, также оформленных на основе шаблонов {{t|книга}}, {{t|статья}}, {{t|cite news}} и {{t|cite web}}, в значении параметра «ref» указана конструкция типа <code><nowiki>{{{ref|</nowiki>{{color|red|<ref-ссылка по умолчанию>}}<nowiki>}}}</nowiki></code>. В этом случае предусмотрено два варианта оформления сносок, когда параметр «<code>ref-ссылка</code>» указывается в шаблоне <code><nowiki>{{sfn}}</nowiki></code>:
: '''А) По умолчанию.'''
:: В этом случае в размещаемом в тексте статьи (обычно, в разделе «Литература») шаблоне-ссылке на источник не следует дополнительно указывать значение параметра «ref», а шаблон <code><nowiki>{{sfn}}</nowiki></code> следует использовать с ref-ссылкой в том виде, в каком она задана в шаблоне-ссылке на источник: «<code>{{color|red|<ref-ссылка по умолчанию>}}</code>». Параметр «год» в шаблоне <code><nowiki>{{sfn}}</nowiki></code> следует указывать в соответствии с годом (годами), отображаемым в зависимости от того или иного варианта использования шаблона-ссылки на источник (иногда таких вариантов бывает несколько для одного и того же шаблона-сылки на источник, особенно в случае многотомных изданий).
: '''Б) Произвольно.'''
:: В этом случае в шаблоне-ссылке на источник следует поставить дополнительную вертикальную черту, после которой указать произвольное (по желанию автора правки) значение параметра «|ref={{color|red|<произвольная ref-ссылка>}}», которое и следует использовать в шаблоне <code><nowiki>{{sfn}}</nowiki></code>. Параметр «год» в шаблоне <code><nowiki>{{sfn}}</nowiki></code> следует задавать аналогично случаю указания параметра «<code>ref-ссылка</code>» по умолчанию.

Примеры использования шаблонов в этих случаях приведены в таблице:
{| class=wikitable
 ! Код
 ! Результат
 |-
 !colspan=2|А) <code><ref-ссылка по умолчанию></code>
 |-
 | <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}}.

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

== Литература ==
* {{словарь Ушакова|Дом
 | ссылка  = http://feb-web.ru/feb/ushakov/ush-abc/05/us175905.htm?cmd=p&istext=1
 | том     = 1
 | столбцы = 759
}}
 |-
 !colspan=2|Б) <code><произвольная ref-ссылка></code>
 |-
 | <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}}.

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

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

=== Использование шаблона в комбинации с шаблоном-якорем ===
Альтернативный способ привязки короткой ссылки к источнику — использование шаблона {{t|sfn}} в комбинации с шаблоном-[[Википедия:Ссылка на раздел#Якоря|якорем]] {{t|h}}, не зависящим от шаблонов {{t|книга}}, {{t|статья}}, {{t|cite news}} и {{t|cite web}}.
{| 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|Петров|2000б|с=321}}.

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

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

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

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

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

== Параметры шаблона для визуального редактора ==
<TemplateData>
{
        "description": "Оформление коротких сносок на источники, уже перечисленные в списке примечаний. См. https://ru.wikipedia.org/wiki/Шаблон:Sfn",
        "params": {
                "1": {
                        "label": "ref-ссылка",
                        "description": "Ссылка на ref-якорь (параметр ref из шаблона-ссылки {{книга}} и т. п.)",
                        "type": "string",
                        "required": true
                },
                "2": {
                        "label": "год",
                        "description": "Если в шаблоне {{книга}} или {{статья}} указан параметр год=, то для отсылки к нему в шаблоне {{sfn}} должен быть указан тот же год, иначе отсылка через {{sfn}} не будет работать. Например: 1985",
                        "type": "number",
                        "required": false
                },
                "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": "номер страницы (диапазон страниц). Например: 100, 101—102",
                        "type": "string",
                        "required": false,
                        "aliases": ["с", "c"]
                },
                "group": {
                        "label": "имя группы",
                        "description": "имя группы примечаний",
                        "type": "string",
                        "required": false,
                        "aliases": ["g"]
                },
                "name": {
                        "label": "имя сноски",
                        "description": "имя существующего примечания",
                        "type": "string",
                        "required": false
                },
                "style": {
                        "label": "style",
                        "description": "оборачивает в тег <span style=>",
                        "type": "string",
                        "required": false
                }
        }
}
</TemplateData>

== См. также ==
* {{t|sfn0}}
* {{t|sfn-1}}
* {{t|arf}}
* {{t|rp}}
* {{t|r}}

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