Этот шаблон можно использовать для создания вики-ссылок на существующие цитаты, определенные в той же статье с помощью шаблонов цитирования CS1/CS2 (и многих других). Он использует (частичную) повторную реализацию создания привязки, выполненную {{ SfnRef }}, чтобы упростить создание ссылок на сноски в согласованном формате. По умолчанию ссылки будут оформлены в виде небольших надстрочных меток (например, [n] ), аналогичных тем, которые создаются тегами Mediawiki <ref>...</ref>
, но возможны и простые текстовые ссылки.
Типичное использование — внутри |quote=
, если цитата относится к другим работам, определенным как цитаты в той же статье, но шаблон также может использоваться во многих других местах внутри и за пределами шаблонов цитирования, в том числе в других параметрах.
Хотя можно создавать прямые конвейерные ссылки, такие как [[#CITEREF<name-list><year><disambiguator>|<label>]]
, использование шаблона предпочтительнее, поскольку он скрывает от пользователя внутренние детали формирования привязки CITEREF. Поскольку шаблон можно централизованно обновлять, его легче поддерживать в будущем, чем повсюду корректировать жестко запрограммированные ссылки. Кроме того, в случае надстрочных меток шаблон обеспечивает единообразный внешний вид и безопасное кодирование, которое можно использовать внутри цитат, без необходимости запоминать пользователем синтаксис HTML и т. д. для достижения эффекта.
По умолчанию шаблон поддерживает от 1 до 4 параметров имени автора (согласно {{ SfnRef }}), за которыми следует 1 параметр даты (также согласно {{ SfnRef }}) для составления придатка, CITEREF
чтобы соответствовать внутренней привязке, созданной шаблон цитирования, на который должна указывать эта ссылка. Последний безымянный параметр — это текст метки, который должен отображаться как текст ссылки, например «a», «b», «c» и т. д. Хотя это не влияет на функциональность, убедитесь, что эти метки не конфликтуют с другими метками. используется для цитат или примечаний в одной и той же статье, чтобы избежать путаницы для пользователей (то есть, если уже используются строчные буквы или арабские цифры, вы можете, например, использовать вместо них заглавные буквы или римские цифры). Кроме того, поскольку последовательность меток в статье может измениться при добавлении дополнительных ссылок или изменении порядка цитирования, может быть полезно использовать схему нумерации, относящуюся к цитированию (например, (повторно) начинать с «А» в каждой новой статье). цитирование) вместо необходимости часто перенумеровывать схему абсолютных имен для всей статьи (например, начиная с «А» в первой ссылке на citeref в статье).
Если указан только один параметр, текст метки будет таким же.
Необязательный именованный параметр |style=plain
можно использовать для переключения стиля отображения с надстрочных меток по умолчанию на простой текст.
Используя необязательные параметры |ref=
или |id=
, шаблон можно использовать для других стилей имен привязок для поддержки особых случаев.
Чтобы избежать висячих ссылок, пожалуйста, проверяйте ссылки, нажимая на них после создания и при изменении имени или даты автора/редактора в соответствующих цитатах. (Будущая версия шаблона может автоматически обнаруживать висячие ссылки и выдавать сообщения об ошибках, см. раздел Обсуждение модуля:Сноски/Архив 1#отчеты о неработающих ссылках harv и Обсуждение справки:Стиль цитирования 1/Архив 66#make ref=harv по умолчанию для CS1 . )
Примеры ссылочных определений: [1] [2]
Пример 1:
Example text{{citeref|Author2|2018|a}}
:Пример 2:
Example {{citeref|Author1|2017|text|style=plain}}
:Используя параметры |ref=
или |id=
, шаблон также можно использовать для создания ссылок в соответствии с двумя другими стилями именования привязок. Если один из них указан, это переопределит схему именования привязки Гарварда по умолчанию на {{ SfnRef }}, и шаблон будет принимать только один безымянный параметр (для текста метки ссылки). Если заданы оба параметра, |id=
будут игнорироваться: [3] [4]
|ref=
может использоваться для ссылки на привязки совершенно произвольного стиля (например, для переопределения схемы harv по умолчанию, если в определенных случаях она оказывается слишком сложной для соблюдения). Значения «harv» и «none» зарезервированы и не должны использоваться .|id=
работает аналогично, но к имени привязки автоматически добавляется префикс «Reference-». ( Подробности см. в {{ wikicite }}.)Пример 3:
Example text{{citeref|b|ref=Author-2020}}
:Пример 4:
Example {{citeref|text|ref=Author-2020|style=plain}}
:Пример 5:
Example text{{citeref|c|id=Example}}
:Пример 6:
Example {{citeref|text|id=Example|style=plain}}
:Нет особого смысла комбинировать |ref=
или |id=
с, |style=plain
поскольку синтаксис более сложен, чем у конвейерной ссылки, такой как [[#anchor-name|label]]
, однако это поддерживается в тех случаях, когда из соображений обслуживания желательно использовать тот же стиль ссылки (то есть связывание через citeref). в статье, а не смешивать разные методы и синтаксисы.
{{reflist|refs=
<ref name="Example_Ref_1">{{cite book |title=Title1 |author=Author1 |date=2017 |quote=Quote1 referring to another citation via CITEREF.{{citeref|Author2|2018|A}}}}</ref>
<ref name="Example_Ref_2">{{cite book |title=Title2 |author=Author2 |date=2018 |quote=Quote2 referring to {{citeref|Author1|2017|another citation|style=plain}} via CITEREF.}}</ref>
<ref name="Example_Ref_3">{{anchor|Reference-Example}}{{cite book |title=Title3 |author=Author3 |date=2019 |quote=Quote3 referring to another citation via CITEREF.{{citeref|Author4|2020|B}}}}</ref>
<ref name="Example_Ref_4">{{anchor|Author-2020}}{{cite book |title=Title4 |author=Author4 |date=2020 |quote=Quote4 referring to {{citeref|Author3|2019|another citation|style=plain}} via CITEREF.}}</ref>
}}
Quote1 ссылается на другую цитату через CITEREF. [А]
Quote2 ссылается на другую цитату через CITEREF.
Quote3 ссылается на другую цитату через CITEREF. [Б]
Quote4 ссылается на другую цитату через CITEREF.