[[#endnote_{{{1}}}|[{{{2}}}]]]
Эта документация предназначена для шаблонов {{ ref }} , {{ note }} , {{ ref label }} и {{ note label }} . Шаблоны заметок помещают примечания в статью, а шаблоны ссылок размещают помеченные ссылки на примечания, причем метки обычно представляют собой гиперссылки для перехода от ссылки к соответствующей заметке и обратно от примечания к ссылке. Пара шаблонов меток аналогична паре без имени метки , но имеет больше функций.
Ссылки и обратные ссылки идентифицируются внутри путем объединения указанных параметров. Шаблоны принимают ряд безымянных параметров, определяемых их положением. Он также принимает именованный параметр ( noid ), который устарел с момента его появления.
Первый параметр {{ ref }} — это метка, которую необходимо использовать для параметра соответствующего {{ note }} . Метка используется для формирования идентификатора фрагмента для ссылки на сноску и обратной ссылки. Второй параметр {{ref}} — это маркер ссылки на сноску, отображаемый в виде верхнего индекса. Самый простой вариант — сделать эти два одинаковыми, но это не является обязательным требованием. Если второй параметр не указан, маркер представляет собой внешнюю ссылку с надстрочным индексом в форме [ n ].
Ниже показан общий синтаксис каждого шаблона:
{{ref|id|label|noid=noid}}
{{note|id|label|text}}
{{ref label|id|label|backlink|noid=noid}}
{{note label|id|label|backlink|text}}
Описание каждого параметра следующее:
Идентификатор заметки и ее обратная ссылка (обязательно). Это единственный обязательный параметр для пары {{ref}}
и {{note}}
, который можно использовать для добавления простых сносок.
Важное примечание: каждая пара {{ref}}
и {{note}}
, а также каждая пара {{ref label}}
и {{note label}}
должны иметь уникальные идентификаторы. Это применимо, даже если желательны несколько ссылок, указывающих на одну и ту же сноску. ( Правильный метод реализации этой функции – использование параметра label – показан ниже. ) Дублирующиеся идентификаторы генерируют недействительный код, на который веб-браузеры реагируют по-разному. Некоторые браузеры сообщают об ошибках, в то время как другие могут случайным образом сохранять один идентификатор и молча отбрасывать другие. Однако во всех случаях навигация между некоторыми сносками и их основным текстом не работает должным образом. См. раздел Справка:Проверка разметки .
Текст метки, отображаемый там, где вставлены эти шаблоны (обязательно для {{ref label}}
и {{note label}}
). Ниже объясняется поведение конкретного шаблона:
{{ref}}
и метка отображается в верхнем индексе {{ref label}}
; в , метка отображается как жирный текст стандартного размера.{{note label}}
{{note}}
{{ref}}
и метка также имеет гиперссылку {{ref label}}
и {{note}}
помогает перемещаться между встроенным маркером сноски (в тексте) и ее основным текстом. {{note label}}
, однако не прикрепляет гиперссылку к метке, а игнорирует этот параметр, если присутствует параметр обратной ссылки (описанный ниже).{{ref label}}
метка всегда заключена в скобки.Этот параметр является необязательным в {{ref}}
и {{note}}
, поэтому:
{{ref}}
отображает уникальный номер в квадратных скобках, если этот параметр опущен. (См. пример выше.){{note}}
добавляет эту метку к обратной ссылке ( ^), поэтому, если она опущена, отображается только каретка. (См. пример выше.)Нет необходимости включать этот параметр одновременно и в справочную, и в примечательную часть. На самом деле, может возникнуть необходимость сделать обратное. В этом примере показано, как использовать {{ref}}
и {{note}}
связывать несколько маркеров сносок одинакового внешнего вида с одной и той же сноской.
Как объяснялось выше, {{note label}}
не генерирует обратную ссылку из параметра метки . Уникальный параметр {{ref label}}
– {{note label}}
обратная ссылка является дополнительным параметром, который представляет собой идентификатор части и метку части :
{{ref label}}
– {{note label}}
может либо не иметь этот параметр, либо должна иметь его оба.{{ref label}}
– {{note label}}
оба конца должны иметь одинаковое значение обратной ссылки . Кроме того, в любой {{ref label}}
паре {{note label}}
комбинация id и обратной ссылки должна быть уникальной.{{note label}}
, что этот параметр полностью переопределяет параметр метки .Пользователь {{ref label}}
с обратной ссылкой не может подключиться к файлу {{note}}
. Аналогично, файл {{note label}}
с обратной ссылкой не может подключиться к файлу {{ref}}
.
Пример:
Этот параметр ( backlink ) также принимает специальное значение «none» (без кавычек), которое вызывает появление курсора там, где {{note label}}
он помещен.
Во всех предыдущих примерах основной текст части сноски вставлялся за пределы {{note}}
шаблона {{note label}}
. Однако внутри шаблона можно вставить основной текст вместо текстового параметра. Все, что находится внутри текстового параметра, светится, когда пользователь нажимает на знак сноски. В примере ниже попробуйте нажать S и T и увидите разницу.
Поскольку основной текст сноски начинается без разделителя после этой строки, есть предостережение: если основной текст сноски начинается со строчной буквы, первое слово может быть прикреплено к обратной ссылке. (Для получения дополнительной информации см. Help:Wikilinks .)
Устаревший параметр — подавляет обратную ссылку из компонента примечания на ссылку. В случае {{note}}
, активная гиперссылка по-прежнему отображается, хотя и не работает.
Изначально этот параметр предназначался для облегчения проблемы подключения множества тегов ссылок с одинаковым идентификатором к одному тегу заметок с этим идентификатором. Однако он лишь заменяет одну форму неработающего кода другой. Вместо этого рассмотрите возможность использования {{note label}}
, при котором обратные ссылки не создаются, если это не настроено. Для каждого шаблона ссылки с одним и тем же идентификатором всегда должен существовать один и только один шаблон заметки .
Как объяснялось ранее, параметр id для каждой пары {{ref}}
– {{note}}
должен быть уникальным. В следующем примере показано, что происходит, когда две ссылки используют один и тот же идентификатор . Попробуйте перейти от маркированного текста к сноскам и обратно.
Одним из распространенных применений шаблонов ссылок и примечаний является размещение сносок под таблицами, как в следующем примере, взятом из статьи Kent#Economy [раздел]:
Гаджет «Справочные подсказки» не работает с этими шаблонами. Использование тегов ref/note — не единственный способ создания сносок . Cite.php (с которым работает Reference Tooltips) в настоящее время является предпочтительным методом создания сносок, особенно когда количество сносок увеличивается и размер статьи (или области, в которой используются сноски) увеличивается. Конвертер ссылок может конвертировать теги ref/note в новый стиль Cite.php.
В следующих примерах сравниваются два метода, а также показано, как их можно комбинировать:
См. также примеры и пояснения в Wikipedia:Footnote3 .