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

Материал из свободной русской энциклопедии «Традиция»
Перейти к навигации Перейти к поиску

Данный шаблон (arf — сокращение от abbreviated reference, что в переводе с английского значит «сокращенные ссылки») предназначается для простановки коротких сносок на источники, перечисляемые в списке литературы и списке внешних ссылок. В отличие от {{sfn}} не привязан к году издания, а также имеет ряд других особенностей.

Параметры[править код]

{{arf
|1=<!--якорь-->
|2=<!--название-->
|a=
|p=
|lang=
|com1=
|com2=
|vicedot=
}}
обязательные параметры
  • первый неименованный — имя якоря
  • второй неименованный — название источника (видимая часть в сноске)
необязательные параметры
  • a= — автор (например: Иванов М. И. или Frost G. S.)
  • p= — номер страницы или диапазон страниц (например: 77 или 5—6)
  • lang= — код языка для источников не на английском языке (например: ru|de|pl|lat)
  • com1= — комментарий в начале сноски (например: См. или Цит. по:)
  • com2= — комментарий в конце сноски (после номера страницы)
  • vicedot — знак для замены точки в конце названия источника (например: !, ?, )

Одной строкой: {{arf|<!--якорь-->|<!--название-->|a= |p= |lang=}}

Механизм работы[править код]

1. В список литературы или внешних ссылок в начале строки вставляем шаблон {{anc}} с параметром, содержащем название якоря (по вашему желанию). Пример:

  • {{anc|Malyshev}} Малышев А. И. Болезни википедистов. — М.: Медицинская литература, 2012. — 563 с.о книге

2. В тексте статьи создаём обычную сноску, {{arf}} вставляем внутрь <ref></ref>. Пример:

<ref>{{arf|Malyshev|Болезни википедистов|a=Малышев А. И.|p=44|lang=ru}}</ref>

3. В итоге получаем сноску[1]. При нажатии на синюю ссылку нас перекидывает в список литературы с подробной информацией:

  1. Малышев А. И. Болезни википедистов. — С. 44.
  • Davidson H. Motorcycles in my life. — New-York: Harper & co., 1988.о книге
  • Малышев А. И. Болезни википедистов. — М.: Медицинская литература, 2012. — 563 с.о книгеСвойство «Ссылка/Автор» типа «Страница» со значением «Малышев А. И.» содержит недопустимые символы или неполно и может привести к неожиданным результатам при семантическом аннотировании или запросе.
  • Greinemann E. Füttern von Kaninchen. Untersuchungen zur Quellenfrage. — Berlin: Freiburg univ., 1996.о книге

Замечания по использованию[править код]

Название якоря (задаётся шаблоном {{anc}}) лучше выбирать такое, чтобы было сразу понятно, о каком источнике идёт речь. Лучше всего подходит фамилия автора. Кириллицу использовать нежелательно.

Шаблон {{arf}} содержит два обязательных параметра: первый из них должен совпадать с названием якоря, второй является названием источника (обычно это заглавие книги). В конце автоматически ставится точка, если она вам не нужна, добавьте в шаблон параметр vicedot («вместо точки») с нужным знаком. Если название источника очень длинное, то приводится только его начало, а в конец ставится многоточие (vicedot=…).

Значение первого параметра на экране отображено не будет, а значение второго представляет собой видимый текст гиперссылки на источник. Остальные параметры являются необязательными, то есть заполняются только в случае необходимости.

Необязательные параметры (все параметры называются латинскими буквами):

  • p= — указывает конкретный номер или номера страниц. Интервал страниц задаётся тем же параметром p через знак тире (), а не дефиса (-). Для того, чтобы набрать знак тире, нажмите alt+«0151» или вставьте из панели «Быстрая вставка» под окном редактирования).
  • lang=код языка издания: ru для русского, de для немецкого, pl для польского, lat для латыни. Для книг на английском и французском языках параметр указывать не надо (это связано с тем, что в этих языка страницы обозначаются буквой P., заданной по умолчанию). То есть lang нужен для автоматического изменения P. на С. или S. в зависимости от языка источника.
  • a= — автор в формате Фамилия И. О. (сначала фамилия, затем без запятой через пробел инициалы). Значение параметра автоматически выделяется курсивом. Рекомендуется использовать во всех случаях, когда автор известен. Если авторов больше трёх, то после первого пишут и др. (et al. для изданий не на кириллице).
  • com1= — добавляет комментарий в начале сноски. Это параметр полезно использовать для указаний на то, что цитата приводится с чьих-то слов (в форме Цит. по:), или для указания См..
  • com2= — комментарий в свободной форме, добавляемый после ссылки, в том числе после указания номера страницы. В конце автоматически ставится точка.

Так как шаблон не включает в себя <ref></ref> (как это делает {{sfn}}), возможна ничем не отличающаяся от стандартной группировка сносок (например, разделение их на «примечания» и «источники»). В этом случае будет не <ref></ref>, а <ref group="имя группы"></ref>. Повторные сноски также создаются обычным образом: <ref name="имя сноски"></ref>