Эта документация предназначена для шаблонов {{ ref }} , {{ note }} , {{ ref label }} и {{ note label }} . Шаблоны заметок помещают заметки в статью, а шаблоны ссылок помещают помеченные ссылки на заметки, при этом метки обычно являются гиперссылками для навигации от ссылки к соответствующей заметке и обратно от заметки к ссылке. Пара шаблонов меток похожа на пару без имени метки , но с большим количеством функций.
Ссылки и обратные ссылки идентифицируются внутренне путем объединения указанных параметров. Шаблоны принимают ряд неименованных параметров, идентифицированных по их положению. Он также принимает именованный параметр (с именем noid ), который устарел с момента его введения.
Первый параметр {{ ref }} — это метка, которая должна использоваться для параметра соответствующего {{ note }} . Метка используется для формирования идентификатора фрагмента для ссылки на сноску и обратной ссылки. Второй параметр {{ref}} — это маркер ссылки на сноску, показанный как верхний индекс. Самый простой выбор — сделать эти два параметра одинаковыми, но это не обязательно. Если второй параметр не указан, маркер представляет собой внешнюю ссылку с верхним индексом в форме [ n ].
Ниже показан общий синтаксис каждого шаблона:
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
{{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 одновременно. Фактически, может возникнуть необходимость сделать наоборот. Этот пример показывает, как использовать {{ref}}и {{note}}связывать несколько маркеров сносок одинакового вида с одной и той же сноской.
Как объяснялось выше, {{note label}}не генерирует обратную ссылку из параметра label . Уникальный параметр {{ref label}}– {{note label}}, backlink является дополнительным параметром, который является идентификатором и меткой части :
{{ref label}}пара {{note label}}может либо отказаться от этого параметра, либо должна иметь его обе.{{ref label}}– {{note label}}оба конца должны иметь одинаковое значение обратной ссылки . Кроме того, в любой паре {{ref label}}– {{note label}}комбинация id и обратной ссылки должна быть уникальной.{{note label}}, что этот параметр полностью переопределяет параметр метки .A {{ref label}}с обратной ссылкой не может подключиться к {{note}}. Аналогично, a {{note label}}с обратной ссылкой не может подключиться к {{ref}}.
Пример:
Этот параметр ( backlink ) также принимает специальное значение «none» (без кавычек), что приводит к появлению курсора в месте {{note label}}размещения.
Во всех предыдущих примерах основной текст сноски был вставлен вне {{note}}шаблона {{note label}}. Однако основной текст можно вставить внутрь шаблона вместо текстового параметра. Все, что помещено внутрь текстового параметра, светится, когда пользователь нажимает на знак сноски. В примере ниже попробуйте нажать на S и T и увидеть разницу.
Поскольку основной текст сноски начинается без разделителя после этой строки, есть одно предостережение: если основной текст сноски начинается со строчной буквы, первое слово может быть прикреплено к обратной ссылке. (Дополнительную информацию см. в разделе Help:Wikilinks .)
Устаревший параметр – подавляет обратную ссылку из компонента заметки на ссылку. В случае {{note}}активная гиперссылка все равно отображается, хотя она и не работает.
Этот параметр изначально предназначался для решения проблемы соединения множества тегов ссылок с одинаковым идентификатором с одним тегом заметки с этим идентификатором. Однако он заменяет только одну форму сломанного кода другой. Рассмотрите возможность использования {{note label}}вместо этого , который не генерирует никаких обратных ссылок, если не настроен для этого. Всегда должен быть один и только один шаблон заметки для каждого шаблона ссылок с одинаковым идентификатором .
Как объяснялось ранее, параметр id для каждой пары {{ref}}– {{note}}должен быть уникальным. Следующий пример показывает, что происходит, когда два ref используют один и тот же id . Попробуйте перейти от маркированного текста к сноскам и обратно.
Одним из распространенных применений шаблонов ссылок и примечаний является размещение сносок под таблицами, как в следующем примере, взятом из статьи Kent#Economy [раздел]:
Гаджет Reference Tooltips не работает с этими шаблонами. Использование тегов ref/note — не единственный способ создания сносок . Cite.php (с которым Reference Tooltips работает) в настоящее время является предпочтительным методом создания сносок, особенно когда увеличивается количество сносок и размер статьи (или области, в которой используются сноски). Ref converter может преобразовывать теги ref/note в новый стиль Cite.php.
В следующих примерах сравниваются два метода, а также показано, как их можно комбинировать:
См. также примеры и пояснения в Википедии:Footnote3 .