Шаблон harv («Harvard citation») создает краткую цитату в форме « (Smith 2007, p. 22) » для использования внутри пояснительных примечаний . Иногда он используется в пространстве имен проекта для эссе . Его можно использовать в сносках, но не в основном тексте любой статьи. С 2020 года встроенные скобочные ссылки устарели в Википедии . Любое использование скобочных ссылок в основном тексте статьи можно преобразовать в сноски .
{{ harv }} предназначен для создания сокращенных сносок , стиля цитирования, который объединяет короткую ссылку с указанием автора и даты в сноске с полной ссылкой в разделе ссылок в конце статьи (см. пример ниже). Этот стиль цитирования используется для уменьшения беспорядка в окне редактирования и для объединения нескольких ссылок на один и тот же источник.
Распространенные проблемы и известные способы их решения приведены в разделе «Возможные проблемы» ниже.
Есть несколько других шаблонов, которые предназначены для использования с сокращенными сносками. Они немного отличаются тем, как они форматируют ссылку автора-даты и насколько автоматизирована их функциональность. Полный список этих связанных шаблонов приведен ниже.
Обратите внимание, что использование (или даже неиспользование) этих шаблонов является элементом «стиля» цитирования, и добавление или удаление их в статьях с установленным стилем должно соответствовать этому стилю. См. WP:CITEVAR .
Также обратите внимание, что встроенное использование этих шаблонов, т. е. использование {{ harv }} без <ref>...</ref>тегов вокруг него, было объявлено устаревшим в сентябре 2020 г. См. также WP:PAREN .
harv генерирует краткую цитату в стиле «автор-дата» на основе следующих параметров:
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
<ref>{{harv | <last1*> | <last2> | <last3> | <last4> | <year*> | p= <page> | loc= <location> }}</ref>с
2012a|p=– конкретная страница, на которую есть ссылка в источнике (псевдоним: |page= )|pp=– разделенный запятыми список отдельных страниц и/или диапазонов страниц, на которые имеются ссылки в источнике (псевдоним: |pages= )|loc=– расположение в исходном коде, когда |p=и |pp=неуместны; могут использоваться для дополнения |p=и |pp=; информации, такой как номер раздела или рисунка.Типичное использование показано в примере ниже. Текст и сноска связаны двунаправленной ссылкой — нажатие на верхний индекс переносит читателя к сноске, нажатие на номер сноски возвращает его к верхнему индексу. Нажатие на краткую цитату переносит его к полной цитате в разделе ссылок.
Шаблон harv помещается внутри <ref>...</ref>тегов для создания сокращенных сносок . (Использование harv вне <ref>...</ref>тегов было объявлено устаревшим в сентябре 2020 г. ).
Необходимо указать фамилии первых четырех авторов (или всех авторов, если их меньше четырех; используйте значения от или ), а затем год публикации (от или ). Авторы после четвертого должны быть опущены, иначе возникнет ошибка.|lastN=|authorN=|year=|date=
В разделе «Возможные проблемы» ниже описываются способы решения различных распространенных проблем, таких как большое количество авторов, отсутствие имени автора, несколько работ в одном году, несколько авторов с одинаковой фамилией и другие.
Необязательные параметры |p=, |pp=и |loc=могут использоваться для указания местоположения в источнике, например, номеров страниц. Для отдельных страниц используйте |p=; для нескольких страниц (например, диапазонов) используйте |pp=. Использование |p=для нескольких страниц или |pp=для отдельных страниц может вызвать ошибки цитирования . |loc=может использоваться для указания местоположения в источнике другим способом, например, номеров разделов или глав. Параметры |page=и |pages=существуют как псевдонимы для |p=и |pp=соответственно.
Необязательный параметр |postscript=или |ps=может использоваться для изменения текста, который отображается в конце примечания в списке литературы. (См. § Добавление дополнительных комментариев или цитат и § Отсутствие заключительного периода ниже.) Постскриптум действителен только в первый раз, когда он используется для определенного автора, года и места.{{sfn}}
Недоступно в и подобных шаблонах.{{sfn}}
Необязательный параметр |ref=используется для создания необычно именованной ссылки из краткой цитаты в полную цитату. Этот параметр обычно не нужен, и его чаще используют или в разделе ссылок. Если указать , гиперссылка не создается. Однако, если ссылка не нужна, всегда можно просто использовать обычный текст вместо шаблона. Параметр является псевдонимом для .{{sfnRef}}{{harvid}}|ref=none|Ref=|ref=
Шаблоны или могут быть использованы для добавления цитат или дополнительных комментариев в сноску. Примеры приведены ниже.{{harvnb}}{{harvtxt}}
Nota bene : В прошлом|ps=для хранения этой дополнительной информации рекомендовалось использовать , но для этой цели он не подходит. Два или более{{sfn}}шаблонов с одинаковыми авторами, одним годом и одной страницей, но разными,|ps=приведут к ошибке Cite: The named reference ... was defined multiple times with different content message. Это сообщение появляется, потому что имена{{sfn}}создаваемых ссылок будут одинаковыми, но содержимое между<ref name="FOOTNOTE...">тегом и</ref>тегом будет разным. Обходной путь — преобразовать один или несколько шаблонов{{sfn}}вобернутыетегами.{{harvnb}}<ref>...</ref>
Если доступна конкретная ссылка на страницу или раздел, к местоположению или номеру страницы можно добавить URL-адрес .
Иногда пояснительная сноска требует цитаты. Шаблоны типа {{ sfn }} не могут быть напрямую вставлены между <ref>...</ref>тегами, поскольку будет выдано следующее сообщение: Ошибка цитирования ссылается на отсутствующую группу .
Шаблоны {{ efn }} и {{ notelist }} можно использовать для создания отдельных пояснительных сносок из коротких цитат, как показано в первом примере. Статья, которая широко использует эту технику, — Chinese Room .
Также можно использовать волшебное слово {{#tag:ref|...}} , и шаблон {{ sfn }} будет работать правильно внутри сноски, как показано во втором примере.
Иногда возникает необходимость создать два или более отдельных списков встроенных сносок. Например, некоторые генеалогические древа содержатся в шаблонах, они транслируются в несколько биографий и имеют собственные автономные цитаты (см. Шаблон: генеалогическое древо Хьюстона и статью Маргарет Ли Хьюстон ).
Чтобы облегчить это, в то время как на главной странице используется стандартный подсчет сносок 1,2,3, для генеалогических древ обычно используется шаблон efn с набором параметров группы, например (нижнегреческий). Шаблоны efn являются текстовыми шаблонами, чтобы связать часть или все содержимое шаблона efn с шаблоном длинной цитаты, таким как место или внутри шаблона efn.{{efn-lg}}{{cite book}}{{harvnb}}{{harv}}
Если необходимо процитировать более одной работы одного автора, опубликованной в одном и том же году , стандартным способом устранения неоднозначности таких работ является добавление буквенного суффикса после элемента года шаблона {{sfn}}(например, {{sfn|Smith|2006a}}и {{sfn|Smith|2006b}}). Обязательно добавьте букву устранения неоднозначности к соответствующей полной цитате (например, {{cite book|...|last=Smith|date=2006b}}).
При {{sfn}}использовании с шаблонами Citation Style 1 можно добавить букву суффикса года для всех принятых форматов даты, за исключением начального числового формата года ( ГГГГ-ММ-ДД ). Необязательно включать и (см. исключение ниже). Если включены оба, используется для соответствия привязки устаревшим ссылкам.{{citation}}|date=|date=|year=|year=CITEREF
|date=2013a: простые даты только года|date=Jan 2013bили |date=Winter 2013b: месяц или сезон и даты года|date=9 November 2013bили |date=November 9, 2013b: полные даты|date=June–July 2013cили |date=Winter–Spring 2013c: диапазоны месяцев или сезонов и даты года|date=c. 2013d: даты около года|date=2024–2025eили |date=Summer 2024–25e: диапазоны лет|date=n.d.f: без даты (nd)|date=2013g-11-09|year=2013g. Если месяц и день также должны быть частью цитаты, необходимо указать оба параметра: |date=2013-11-09 |year=2013x. В этом случае |date=используется для отображения цитаты и метаданных, а также |year=для устранения неоднозначности ссылок.Вышеуказанное решение для добавления буквенного суффикса после элемента года также работает для нескольких авторов с одинаковой фамилией. Например, и Ричард Бушмен , и Клаудия Лаупер Бушмен опубликовали книги в 2006 году. Чтобы различать эти две книги, первой можно присвоить год «2006a», а второй — «2006b».
Если авторов больше четырех, то шаблон требует фамилии первых четырех авторов (значение в |last=или |author=). Перечисление большего количества авторов не поддерживается. Также можно использовать в шаблоне цитирования, что позволяет сделать более лаконичную цитату в тексте статьи.|ref={{harvid}}
В некоторых источниках нет ни одного автора с фамилией, например, в журнальной статье или отчете государственного учреждения. Нет единого мнения (в Википедии или среди стилей цитирования) о том, как форматировать ссылки автор-дата для работ, у которых нет конкретного автора. Вот несколько вариантов:
Статья должна последовательно придерживаться одного из этих стилей. Использование в шаблоне цитирования может справиться с этими случаями.|ref={{harvid}}
Можно сопоставить либо , |date=либо |year=шаблона цитаты — логика шаблона может извлечь год из полной даты. Если параметр даты не является полной датой, извлечение не удастся. Если ссылка не работает, можно также задать оба параметра |date=и |year=. Шаблон отобразит дату и будет использовать год для привязки. Эти два примера показывают, что год успешно извлекается из полной даты.
Шаблон {{ cite comic }} использует параметр |ref=для создания якоря для шаблонов цитирования Гарварда. Это можно задать с помощью , , или напрямую с помощью CITEREF с конкатенацией плюс параметры, переданные в шаблон цитирования Гарварда.{{sfnRef}}{{harvid}}#CITEREF
Семейство шаблонов Citation Style Vancouver использует параметр для создания|harvid= якоря для шаблонов цитирования Harvard. Это должно быть установлено для конкатенации параметров, переданных в шаблон цитирования Harvard.
В нескольких очень редких случаях шаблоны цитирования могут не создавать якорь. Либо (1) цитирование отформатировано с помощью шаблона, который не поддерживает |ref=параметр, либо (2) источник вообще не может быть описан с помощью наших шаблонов цитирования. В этих случаях можно использовать для создания якоря. (По состоянию на ноябрь 2010 года было всего около 100 статей, которым требуется эта техника.) Также возможно, что (3) местные редакторы предпочтут не использовать шаблоны цитирования. В этом случае важно обсудить, что местные редакторы хотели бы сделать с плохими ссылками. Всегда можно просто удалить или , оставив простой текст без ссылок.{{wikicite}}{{harv}}{{sfn}}
Для достижения того же эффекта можно использовать <cite>, но это может быть несовместимо с HTML 5 .
Использование |ps=nonein удаляет конечную точку. Сравните два примера. Подавление точки по умолчанию (точки) обеспечивает согласованность со стилем цитирования 2 , созданным , который не использует конечную точку (точку) при отображении полных цитат. Постскриптум эффективен только в первый раз, когда используется для определенного автора, года и местоположения. Пустое значение также подавляет конечную пунктуацию, но рекомендуется для того, чтобы было ясно, что редактор не хотел использовать конечную пунктуацию. {{sfn}}{{Citation}}{{sfn}}|ps=|ps=none
Если статья использует этот шаблон, и ничего не происходит при нажатии на выделенную викиссылку из цитирования в стиле Гарварда на полное цитирование внизу страницы, есть несколько возможных решений. Если:
{{citation not found}}{{sfn}}{{harv}}|date=поле и нет |year=поля, но формат поля |date=необычный. Решение : Попробуйте исправить дату. Если ссылка все еще не работает, добавьте |year=в шаблон цитирования. (Ничего страшного, если есть и то, и другое.)|ref={{harvid}}|harvid=установлен правильно (см. ниже).|ref=(См. Wikipedia:Шаблоны ссылок и якоря ссылок ). Решение : Рассмотрите возможность изменения шаблона для поддержки |ref=. В качестве альтернативы якорь можно создать с помощью .{{wikicite|id={{harvid|args}}|reference={{citation}}}}{{cite *}}{{cite *}}|ref={{cite *}}{{harv}}{{wikicite}}<cite>...</cite>span для создания якоря. Решение : удалите cite span (они устарели) и продолжайте следовать рекомендации выше.{{wikicite}}|id={{harvid}}{{wikicite}}[[#Reference-Smith2006|Smith (2006)]]:|ref=(См. Wikipedia:Шаблоны цитирования и привязки ссылок ). Решение : Проверьте, что |ref=установлен соответствующий идентификатор.{{wikicite|ref=id|reference=citation}}Шаблоны, в которых есть неработающие вики-ссылки, использующие эти шаблоны, добавляются в категорию Категория:Все статьи с неработающими ссылками на цитаты .
Когда шаблон краткого цитирования ссылается на полное цитирование, которое отображается шаблоном, оборачивающим шаблон CS1, например (который оборачивает ), может отображаться ошибка отсутствия цели, даже если шаблон краткого цитирования действителен и ссылка работает. Это «ложноположительная» ошибка. Сообщение об ошибке можно подавить , добавив в шаблон или добавив шаблон {{ Sfn whitelist }} с идентификатором(ами) якоря в статью. Если вы тестируете изменения в Special:ExpandTemplates и сообщение об ошибке не может быть подавлено, попробуйте вместо этого протестировать в песочнице или на подстранице пользователя.{{cite DNB}}{{cite encyclopedia}}|ignore-err=yes
Если вы встраиваете шаблон Harv в ссылку, определенную списком , вы можете получить ложноположительную ошибку «отсутствует ключ» , которая выглядит следующим образом:
Это ложноположительный результат: ссылки, определенные списком, не работают правильно, когда ссылки вложены . Это связано с давней ошибкой в программном обеспечении mediawiki (см. phab:T22707). Обходной путь возможен с помощью {{ sfnlink }} .
Известны дополнительные ошибки, связанные с встраиванием сносок в ссылки, определенные списком. Одна из них заключается в том, что имя ссылки, указанное в сообщении об ошибке, будет идентифицировать неправильную ссылку, определенную списком, в первом ложноположительном сообщении об ошибке на странице; это отслеживается в T26600.
Существует несколько шаблонов, используемых для создания кратких цитат; они различаются использованием и расположением скобок, разделителем перед страницей или местоположением, а также наличием конечной точки:
Полные цитаты можно создавать вручную или по шаблонам:
{{citation}}Все эти шаблоны имеют одинаковые параметры и базовую функциональность. На этой странице описываются все шаблоны, за исключением параметров и ; см. страницы документации. Редакторы, редактирующие один из этих шаблонов, должны вносить параллельные изменения в другие версии.{{sfnm}}{{harvs}}
{{sfn}}или{{harvnb}}Шаблон внутри span можно использовать для создания сокращенной сноски , которая связана с полной цитатой внизу статьи. Шаблон (без использования ) имеет тот же эффект, автоматически добавляет точку после номера страницы и автоматически объединяет идентичные сноски.{{harvnb}}<ref>{{sfn}}<ref>
{{harvtxt}}Шаблон можно использовать для привязки внутритекстовой ссылки к полной цитате внизу страницы.{{harvtxt}}
{{harvnb}}или{{sfnm}}Шаблон можно использовать для объединения ссылок . Также создает объединенные ссылки.{{harvnb}}{{sfnm}}
Обратите внимание, что это не подходит для связанных ссылок; используйте или .{{sfn}}{{harvnb}}{{sfnm}}
{{harv}}Шаблон создает ссылку в скобках со ссылкой на полную цитату. Ее следует использовать только в сносках или на внутренних страницах. Использование ссылок в скобках в тексте статей было объявлено устаревшим сообществом Википедии с 2022 года. Такое использование не было объявлено устаревшим на внутренних страницах, таких как документация Википедии, страницы пользователей или википроекты, хотя редко встречается практическое применение вместо использования обычных сносок-цитат .{{harv}}
{{harvid}}или{{harvs}}Более экзотические цитаты Гарварда могут быть созданы с использованием шаблона, например, несколько статей одного автора, с использованием как имени, так и фамилии, ссылки на статьи об авторе и т. д. Любые необычные ссылки также могут быть созданы с использованием параметров идиомы link name . ( {{ citeref }} является оболочкой для {{ harvid }}, что упрощает последовательное создание таких внутренних ссылок в небольших надстрочных [n] или текстовых стилях меток.){{harvs}}[[#{{harvid|}}|]]
Некоторые статьи используют этот идиомный [[#CITEREFидентификатор | имя ссылки]] . См. примечания по деталям реализации ниже.
{{harvcol}}{{harvcolnb}}{{harvcoltxt}}Шаблоны , , и используют двоеточие для указания номера(ов) страницы(ок) или местоположения.{{harvcol}}{{harvcolnb}}{{harvcoltxt}}
Шаблон заключает год в скобки. Сравните два примера.{{sfnp}}
Аналогично, чтобы имитировать цитирование в стиле 1 , шаблон заключает год в скобки.{{harvp}}
Эти шаблоны используют два элемента: викиссылку в теле статьи и якорь в справочном разделе статьи. Нажатие на викиссылку перемещает страницу на якорь.
Наиболее распространенными шаблонами цитирования являются Citation Style 1 или Citation Style 2. По умолчанию Module:Citation/CS1 создает якорь <a name="CITEREF"> , за которым следует объединение следующих параметров:
Это охватывает наиболее распространенные шаблоны. Информация обо всех шаблонах доступна на Wikipedia:Citation templates and reference anchors .
Предпочтительно использовать параметр даты вместо параметра года в шаблонах цитирования.
Шаблоны цитирования Гарварда создают викиссылку на якорь. Например, создает ссылку и создает якорь .{{Harv|Smith|2006|p=25}}#CITEREFSmith2006{{Citation|last=Smith|first=John|date=27 January 2006|title=My Life}}CITEREFSmith2006
Несколько статей создают пользовательский идентификатор, используя CITEREF, либо вместо шаблона цитирования Гарварда (например [[#CITEREFSmith2006|(2006)]]), либо как значение |ref=в шаблоне цитирования. Пользовательский идентификатор должен соответствовать следующим правилам:
":31337"(знак препинания плюс цифра), но проигнорирует "31337"(исключительно цифры)."Nguyen 2010"предпочтительнее имен типа ":31337".":0"или "NYT".A–Z, a–z, цифры 0–9и символы !$%&()*,-.:;<@[]^_`{|}~. То есть все печатные символы ASCII, за исключением #"'/=<>?\пробела.name="John Smith". Но имена ссылок, заключенные в кавычки, не могут включать знак «меньше» ( <) или символ двойной прямой кавычки ( "), которые, однако, могут быть включены путем экранирования как <и "соответственно.|ref=поле необходимо заменить на подчеркивания."); фигурные или другие кавычки будут обрабатываться как часть имени ссылки.Примеры:
Где cite_name — это имя, например, издателя.
Чтобы избежать иногда сложного для запоминания синтаксиса для ссылок на якоря CITEREF, можно использовать {{ citeref }} для создания внутренних вики-ссылок с небольшими надстрочными надписями (например, [n] ) или простыми текстовыми надписями для таких якорей. Его можно использовать внутри других ссылок.
Обратите внимание, что CITEREFпрефикс необходим для гаджета всплывающих подсказок ( MediaWiki:Gadget-ReferenceTooltips.js ), чтобы определить, что ссылка ведет на цитату.
Шаблон создает именованную сноску , так что идентичные сноски автоматически объединяются. Имя сноски начинается с , за которым следует конкатенация аргументов . Например: этот вызов шаблона должен иметь точно такую же функциональность, как , который, в свою очередь, имеет ту же функциональность, что и .{{sfn}}FOOTNOTE{{sfn}}{{sfn|Smith|2006|p=26}}<ref name="FOOTNOTESmith200626">{{Harvnb}}</ref><ref name="FOOTNOTESmith200626">[[#CITEREFSmith2006|Smith (2006)]], p. 26</ref>
Имя ссылки становится более сложным, когда параметр страницы (p) включает URL, например , который после определения может быть вызван с помощью . Поэтому "p=" и символы |,:,.,/,?,=; удаляются из URL.{{sfn|Joyce|1903|p=213}}<ref name="FOOTNOTEJoyce1903[httpsarchiveorgdetailsaconcisehistory00joycgoogpagen226 213]" />
Вызов был заменен для ускорения загрузки.{{harvnb}}
Категория:Страницы, использующие sfn с неизвестными параметрами (0)
Этот шаблон создает короткую ссылку с указанием автора и даты с однонаправленной ссылкой на первый соответствующий шаблон ссылки на той же странице.