Шаблон:Harvc

Дакументацыя шаблонаглядзець правіць гісторыя абнавіць

Гэты шаблон рэалізаваны на аснове Lua з выкарыстаннем кода з модуля Harvc.

Гэты шаблон ужывае стылі:

Module:Citation/CS1/styles.css

Гэты шаблон з’яўляецца гібрыдам цытавання, які спалучае ў сабе рысы поўных формаў (cs1 і cs2), а таксама кароткіх формаў (сямействы шаблонаў {{sfn}} і {{harv}}). Ягоная мэта — даць рэдактарам інструмент для спасылак на канкрэтны матэрыял (артыкул) або раздзел у межах большай працы, калі такіх спасылак патрабуецца шмат. Важна: {{harvc}} не з’яўляецца заменай для паўнавартасна аформленага цытавання крыніцы.

Кароткія шаблоны {{sfn}} і {{harv}} часта выкарыстоўваюцца для стварэння сувязі паміж раздзелам заўваг артыкула і поўнымі шаблонамі цытавання (cs1|2) у раздзеле бібліяграфіі:

{{harv}} → {{cite book}} або: {{sfn}} → {{cite book}}

Крыніцы нярэдка маюць некалькі аўтараў. Калі неабходна спаслацца на розныя матэрыялы (уклады) у адной і той жа кнізе, паўтор усіх бібліяграфічных звестак у некалькіх поўных шаблонах прыводзіць да загрувашчвання раздзела спасылак. Шаблон {{harvc}} распрацаваны для таго, каб утрымліваць толькі тыя дэталі, што патрэбны для ідэнтыфікацыі канкрэтнага матэрыялу, і звязваць яго з поўным цытаваннем асноўнай працы, дзе сабраны ўсе астатнія звесткі:

{{harv}} → {{harvc}} → {{cite book}} або: {{sfn}} → {{harvc}} → {{cite book}}

Выкарыстанне

Мінімальная форма:

{{harvc |last=прозвішча аўтара ўкладу |year=год выдання |c=загаловак укладу |in=прозвішча рэдактара/аўтара крыніцы}}

Параметры

{{harvc}} стварае якар CITEREF на аснове прозвішчаў аўтараў (ад аднаго да чатырох) укладу або раздзела (|lastn=) і значэння ў |year=. Гэта дазваляе {{harvc}} быць мэтай спасылкі, створанай шаблонамі сямейства {{sfn}} або {{harv}}. На аснове |inn= і |year= шаблон {{harvc}} стварае спасылку CITEREF, падобную на тыя, што ствараюцца шаблонамі {{harvnb}} і {{sfn}}. Калі адзін і той жа аўтар цытуецца ў целе артыкула праз <ref>Шаблон:Tnl</ref> для больш чым аднаго раздзела ў адной і той жа працы, гэта прыводзіць да дублявання якараў і выклікае памылку разметкі (lint error) у Special:LintErrors/duplicate-ids; гэтага можна пазбегнуць, прызначыўшы ўнікальныя параметры |id=, напрыклад, |id=yyyya, |id=yyyyb, але захаваўшы параметр |year=.

|anchor-year= – неабавязковы, выкарыстоўваецца для аўтара(ў) з больш чым адным укладам у працу; патрабуе ўдакладняльніка CITEREF; гл. Прыклады.

|author-link= – неабавязковы, назва існага артыкула ў Вікіпедыі пра першага аўтара ўкладу — не вэб-сайт аўтара; не рабіце вікі-спасылку; сінонім: |author-link1=

|author-linkn= – неабавязковы, назва існага артыкула ў Вікіпедыі пра аўтара ўкладуn; выбірайце n, каб яно супадала з n у |lastn=

|author-mask=m – неабавязковы, замяняе імя першага аўтара ўкладу на m (звычайна 2) доўгіх працяжнікаў; сінонім: |author-mask1=

|author-maskn=m – неабавязковы, замяняе імя аўтара ўкладуn на m доўгіх працяжнікаў; выбірайце n, каб яно супадала з |lastn=

|author-maskn=<тэкст> – неабавязковы, замяняе імя аўтара ўкладуn на <тэкст>

|c= – абавязковы, назва раздзела або ўкладу; адлюстроўваецца ў двукоссях прамым шрыфтам; сінонімы: |chapter=, |contribution=

|display-authors= – неабавязковы, вызначае, як {{harvc}} адлюстроўвае спіс аўтараў укладу; ігнаруецца, калі |name-list-style=harv:

|display-authors= – калі параметр пусты або прапушчаны, адлюстроўвае імёны ўсіх аўтараў укладу ў фармаце прозвішча/імя

|display-authors=n – адлюстроўвае n імёнаў аўтараў у фармаце прозвішча/імя; дадае et al. (і інш.), калі n менш за колькасць аўтараў, уключаных у шаблон

|display-authors=etal – адлюстроўвае імёны ўсіх аўтараў у фармаце прозвішча/імя і дадае et al.

|first= – неабавязковы, імя першага аўтара ўкладу; сінонім: |first1=

|firstn= – неабавязковы, імя аўтара ўкладуn; n пачынаецца з 2 і павялічваецца на 1 для кожнага дадатковага |firstn=

|in= – абавязковы, прозвішча першага рэдактара або аўтара працы, якая ўключае ўклад; сінонім: |in1=

|in2= – неабавязковы, прозвішча другога рэдактара або аўтара

|in3= – неабавязковы, прозвішча трэцяга рэдактара або аўтара

|in4= – неабавязковы, прозвішча чацвёртага рэдактара або аўтара

|last= – абавязковы, прозвішча першага аўтара; сінонім: |last1=

|lastn= – неабавязковы, прозвішча аўтара ўкладуn; n пачынаецца з 2 і павялічваецца на 1 для кожнага дадатковага |lastn=;

|loc= – неабавязковы, іншы ідэнтыфікатар месца, адлюстроўваецца пасля |p= або |pp=

|mode= – кіруе адлюстраваннем для адпаведнасці суседнім зноскам у стылі CS1 або CS2; па змаўчанні выкарыстоўваецца стыль CS1

|mode=cs2 – імітуе стыль {{citation}} (раздзяляльнікі-коскі, без знака прыпынку ў канцы, статычны тэкст не з вялікай літары)

|name-list-style= – неабавязковы, кіруе стылем адлюстравання спіса імёнаў аўтараў укладу

|name-list-style=harv – імітуе фармат {{sfn}} або {{harv}} (ад аднаго да чатырох прозвішчаў); перавызначае |display-authors=

|name-list-style=amp – устаўляе знак & () паміж імёнамі двух апошніх аўтараў укладу

|nb= – неабавязковы, калі ўстаноўлена значэнне yes, дае каманду {{harvc}} адлюстроўваць спасылку на крыніцу без дужак вакол года; такі ж фармат, як і той, што ствараецца шаблонам {{harvnb}}

|p= – неабавязковы, нумар адной старонкі, дзе знаходзіцца цытаваны матэрыял; сінонім: |page=

|pp= – неабавязковы, нумары некалькіх старонак, дыяпазоны старонак і г.д., дзе знаходзіцца цытаваны матэрыял; сінонім: |pages=

|ps= – неабавязковы, усталёўвае канчатковы знак прыпынку; па змаўчанні — кропка; перавызначае |mode=cs2; сінонім: |postscript=

|ps=none – адлюстроўвае вынік без канчатковага знака прыпынку

|url= – неабавязковы, URL-адрас у інтэрнэце, дзе можна знайсці тэкст укладу; сінонімы: |chapter-url, |contribution-url

|url-access= – неабавязковы, выкарыстоўваецца, калі URL спасылаецца на крыніцу з патрабаваннем рэгістрацыі або платным доступам; устаўляе значок доступу cs1|2; прымальныя значэнні: limited, registration, subscription

|year= – абавязковы, год публікацыі працы, якая ўключае ўклад

Прыклады

Базавы прыклад

Без {{harvc}}	З {{harvc}}
Doe, John (1990). Chapter 1. In Moe, Mary (рэд.). The Book of Knowledge. University Press. Poe, Jane (1990). Chapter 2. In Moe, Mary (рэд.). The Book of Knowledge. University Press. Roe, Robert (1990). Chapter 3. In Moe, Mary (рэд.). The Book of Knowledge. University Press.	Moe, Mary, рэд. (1990). The Book of Knowledge. University Press. Doe, John. "Chapter 1". In Moe (1990). Poe, Jane. "Chapter 2". In Moe (1990). Roe, Robert. "Chapter 3". In Moe (1990).

Разметка


* {{cite book |last=Doe |first=John |year=1990 |chapter=Chapter 1 |editor-last=Moe |editor-first=Mary |title=The Book of Knowledge |publisher=University Press}}
* {{cite book |last=Poe |first=Jane |year=1990 |chapter=Chapter 2 |editor-last=Moe |editor-first=Mary |title=The Book of Knowledge |publisher=University Press}}
* {{cite book |last=Roe |first=Robert |year=1990 |chapter=Chapter 3 |editor-last=Moe |editor-first=Mary |title=The Book of Knowledge |publisher=University Press}}


* {{cite book |editor-last=Moe |editor-first=Mary |year=1990 |title=The Book of Knowledge |publisher=University Press}}
** {{harvc |last=Doe |first=John |c=Chapter 1 |in=Moe |year=1990}}
** {{harvc |last=Poe |first=Jane |c=Chapter 2 |in=Moe |year=1990}}
** {{harvc |last=Roe |first=Robert |c=Chapter 3 |in=Moe |year=1990}}

Падрабязны прыклад

Калі артыкул Вікіпедыі спасылаецца на працу, якая змяшчае некалькі раздзелаў розных аўтараў, бібліяграфіі і раздзелы са зноскамі могуць выглядаць даволі загрувашчанымі:

George, Ernest J.; Read, Ralph A.; Johnson, R. W.; Ferber, A. E. (1957). Shelterbelts and Windbreaks. In Stefferud, Alfred (рэд.). Soil: The Yearbook of Agriculture 1957. United States Department of Agriculture. OCLC 704186906.
Harper, V. L.; Frank, Bernard; McQuilkin, W. E. (1957). Forest Practices and Productivity. In Stefferud, Alfred (рэд.). Soil: The Yearbook of Agriculture 1957. United States Department of Agriculture. OCLC 704186906.
Stout, P. R.; Johnson, C. M. (1957). Trace Elements. In Stefferud, Alfred (рэд.). Soil: The Yearbook of Agriculture 1957. United States Department of Agriculture. OCLC 704186906.
Wadleigh, C. H. (1957). Growth of Plants. In Stefferud, Alfred (рэд.). Soil: The Yearbook of Agriculture 1957. United States Department of Agriculture. OCLC 704186906.

Па меры павелічэння спіса ён становіцца ўсё больш загрувашчаным праз неабавязковае паўтарэнне дэталяў поўных бібліяграфічных апісанняў. З дапамогай {{harvc}} рэдактары могуць рабіць спасылкі на больш кароткія, менш падрабязныя апісанні ўкладаў, выкарыстоўваючы стандартныя рэалізацыі шаблонаў {{sfn}} і {{harv}} (а таксама абгорнутыя ў тэгі <ref>...</ref> з {{harvnb}}). {{harvc}} таксама можа быць абгорнуты ў тэгі <ref>...</ref>, каб стаць часткай раздзела са зноскамі ў артыкуле. Глядзіце поўны прыклад ніжэй.

Пазбяганне цыклічных спасылак

Часам можа ўзнікнуць неабходнасць працытаваць уклад рэдактара або аўтара крыніцы такім чынам, што параметры ад |last1= да |last4= супадаюць з параметрамі ад |in1= да |in4= , напрыклад, прадмову рэдактара. Такія зноскі могуць, у залежнасці ад размяшчэння, прывесці да таго, што спасылкі сямействаў {{sfn}} або {{harv}} будуць спасылацца непасрэдна на апісанне крыніцы, а не на шаблон {{harvc}}, або выклікаць цыклічныя спасылкі (калі {{harvc}} спасылаецца сам на сябе, таму што ягоны ідэнтыфікатар якара CITEREF супадае з ідэнтыфікатарам якара CITEREF цытаты). Калі параметр |id= зададзены, {{harvc}} будзе выкарыстоўваць яго як ідэнтыфікатар якара; калі |id= не зададзены, {{harvc}} выдасць паведамленне пра памылку, калі значэнні ад |last1= да |last4= супадаюць са значэннямі ад |in1= да |in4=.

Напрыклад, каб спаслацца на прадмову рэдактара з тэксту артыкула, стварыце вікі-спасылку ўнутры тэгаў <ref>...</ref>:

<ref>[[#Stefferud preface|Stefferud 1957]]</ref>

Напішыце шаблон {{harvc}} з параметрам |id=Stefferud preface

{{harvc |last=Stefferud |first=A.|year=1957 |id=Stefferud preface |c=Preface |url=https://archive.org/stream/yoa1957#page/n7/mode/1up |in=Stefferud}}

Шаблон:Markupv

Яшчэ раз звярніце ўвагу, што параметр ignore-err=yes служыць проста для таго, каб схаваць памылкі, якія ўзнікаюць пры ўбудоўванні гэтага шаблона, напрыклад, у дакументацыі. У іншых выпадках яго выкарыстоўваць не варта.

Больш за адзін уклад

Бываюць выпадкі, калі аўтар або аўтары робяць больш за адзін уклад у працу. Калі гэта адбываецца, неабходна ліквідаваць неадназначнасць спасылак CITEREF з шаблонаў {{harv}} або {{sfn}} на ідэнтыфікатар CITEREF адпаведнага шаблона {{harvc}}.

{{harv|Author|YYYYa}} → {{harvc|Author|Contribution 1|YYYYa}} → {{citation|...}}}

{{harv|Author|YYYYb}} → {{harvc|Author|Contribution 2|YYYYb}} ↑

У гэтым прыкладзе аўтар David Hunt (Дэвід Хант) напісаў два дадаткі да працы Christmas Cacti: The Genus Schlumbergera and Its Hybrids.

Ёсць два шаблоны {{harvnb}}, для якіх ліквідавана неадназначнасць:

{{harvnb |Hunt |1995a}} → Hunt 1995a

{{harvnb |Hunt |1995b}} → Hunt 1995b

Яны спасылаюцца на два шаблоны {{harvc}}, якія выкарыстоўваюць |anchor-year= для свайго ідэнтыфікатара CITEREF і для даты ў адлюстраванні {{harvc}} як візуальную падказку для чытачоў:

Разметка

Выканае як

{{harvnb |Hunt |1995a}}; {{harvnb |Hunt |1995b}}.

<!-- ==References== --> {{fake heading|sub=3|References}}
* {{Citation |last=McMillan |first=AJS |last2=Horobin |first2=JF |year=1995 |title=Christmas Cacti: The Genus ''Schlumbergera'' and Its Hybrids |edition=p/b |publication-place=Sherbourne, UK |publisher=David Hunt |isbn=978-0-9517234-6-3}}
** {{harvc |in=McMillan |in2=Horobin |last=Hunt |first=David |c=Appendix I Names of the species |year=1995 |anchor-year=1995a |mode=cs2 |nb=yes |ignore-err=yes}}
** {{harvc |in=McMillan |in2=Horobin |last=Hunt |first=David |c=Appendix III Excerpts from a Brazilian diary |year=1995 |anchor-year=1995b |mode=cs2 |nb=yes |ignore-err=yes}}

Hunt 1995a; Hunt 1995b.

References

McMillan, AJS; Horobin, JF (1995), Christmas Cacti: The Genus Schlumbergera and Its Hybrids (p/b ed.), Sherbourne, UK: David Hunt, ISBN 978-0-9517234-6-3
- Hunt, David (1995a), "Appendix I Names of the species", in McMillan & Horobin 1995
- Hunt, David (1995b), "Appendix III Excerpts from a Brazilian diary", in McMillan & Horobin 1995

Калізія з іншай працай

Паколькі праграмнае забеспячэнне MediaWiki выкарыстоўвае ідэнтыфікатар CITEREF для спасылкі з шаблонаў {{harv}} або {{sfn}} на адпаведны мэтавы якар адпаведнага шаблона {{harvc}} (або поўнага бібліяграфічнага апісання), ідэнтыфікатары CITEREF павінны быць унікальнымі на ўсёй старонцы^{[заўв 1]}. Паколькі ідэнтыфікатар CITEREF звычайна складаецца з 'CITEREF' + LastName (прозвішча аўтара(ў)) + Year (год), гэта можа выклікаць праблемы ў двух выпадках. Першы выпадак быў апісаны вышэй. Іншы выпадак — гэта калізія з іншай працай, які апісаны тут.

Бываюць выпадкі, калі аўтар, якога вы хочаце працытаваць з дапамогай {{harvc}}, зрабіў уклад толькі ў адзін раздзел працы, але гэты ж аўтар таксама напісаў зусім іншую працу ў тым жа годзе. Цытаванне абедзвюх прац звычайным спосабам выклікала б калізію ідэнтыфікатараў CITEREF на старонцы і прывяло б да паведамлення аб памылцы. Ёсць два спосабы вырашэння гэтай праблемы: адзін прадугледжвае дадатковы параметр у шаблоне {{harvc}}, іншы спосаб прадугледжвае дадатковы параметр у поўным апісанні іншай працы.

Першы спосаб — дадаць параметр |anchor-year= у апісанне раздзела {{harvc}}, як ужо было апісана вышэй для выпадку з двума раздзеламі аднаго аўтара. Гэта прысвоіць сімвал унікальнасці частцы Year (год) ідэнтыфікатара CITEREF, такім чынам адрозніваючы яго ад ідэнтыфікатара CITEREF іншай працы таго ж года таго ж аўтара.

Іншы спосаб — дадаць параметр |ref= у шаблон {{cite book}} (або іншае поўнае апісанне) іншай працы таго ж года гэтага аўтара, пазначыўшы іншы ідэнтыфікатар у якасці значэння ref. Глядзіце Шаблон:Cite book#Якар для атрымання дадатковай інфармацыі аб выкарыстанні |ref= для ўказання мэтавага якара для зноскі, а таксама глядзіце {{harvid}} пра тое, як пазначыць значэнне параметра ref.

Паведамленні аб памылках

{{harvc}} выдае наступныя паведамленні аб памылках:

harvc: аўтар адсутнічае ў спісе крыніц.

параметры спіса крыніц |in1=, |in2=, |in3= і |in4= фармуюць спасылку CITEREF шаблона на поўнае апісанне. Усе яны не з’яўляюцца абавязковымі, але павінны выкарыстоўвацца па парадку без пропускаў у нумарацыі.

harvc: няправільны |anchor-year=.

пры выкарыстанні |anchor-year= павінен быць трох- або чатырохзначным лікам і павінен мець удакладняльнік CITEREF у ніжнім рэгістры. Калі крыніца не мае вызначанага года, выкарыстоўвайце |anchor-year=n.d.l або |anchor-year=ndl з удакладняльнікам CITEREF у ніжнім рэгістры.

harvc: няправільны |display-authors=.

значэнне, прысвоенае |display-authors=, павінна быць лікам, большым за 0, або ключавым словам etal

harvc: няправільны |year=.

|year= з’яўляецца неад’емнай часткай якара і спасылкі CITEREF шаблона. Значэнне |year= павінна быць трох- або чатырохзначным лікам з неабавязковым удакладняльнікам CITEREF у ніжнім рэгістры. Калі крыніца не мае вызначанага года, выкарыстоўвайце |year=n.d. або |year=nd.

harvc: адсутнічае |year=.

|year= адсутнічае; гэты параметр з’яўляецца абавязковым.

harvc: няма аўтараў у спісе аўтараў укладу.

гэта паведамленне аб памылцы азначае, што {{harvc}} не можа знайсці ніводнага з параметраў |last=, |last1=, |author= або |author1= з прысвоеным значэннем і таму не можа стварыць прыдатны якар CITEREF. Дадайце хаця б адзін з пералічаных параметраў.

harvc: адсутнічае абавязковы ўклад.

гэта паведамленне аб памылцы азначае, што {{harvc}} не можа знайсці ніводнага з параметраў |c=, |chapter= або |contribution= з прысвоеным значэннем

harvc: адсутнічае абавязковы параметр |id=.

гэта паведамленне аб памылцы выдаецца, калі ідэнтыфікатар якара CITEREF шаблона {{harvc}} канфліктуе з ідэнтыфікатарам якара CITEREF поўнага бібліяграфічнага апісання. Гл. Прыклады

harvc: неадпаведнасць |year= / |anchor-year=.

частка года ў |anchor-year=YYYYl павінна супадаць з годам, пазначаным у |year=YYYY

Дадатковую інфармацыю аб памылках тыпу no target («няма мэты») і іншых памылках катэгорыі можна знайсці на старонцы Катэгорыя:Вікіпедыя:Памылкі адсутнасці якара для шаблонаў Harv і Sfn.

Заўвагі

↑ Калі ідэнтыфікатары CITEREF не з’яўляюцца ўнікальнымі на старонцы, вы ўбачыце чырвонае паведамленне аб памылцы, Harv/sfn error: multiple targets (n): <ідэнтыфікатар якара> у раздзеле зносак на старонцы, калі толькі ў вас не адключаны паведамленні аб памылках ад Module:Footnotes.

Дакументацыя вышэй уключана з Шаблон:Harvc/Дакументацыя.
Эксперыментаваць можна на старонках пясочніцы і тэст-кейсаў гэтага шаблона.
Дадавайце катэгорыі на падстаронку /Дакументацыя. Падстаронкі гэтага шаблона.

[1] Калі ідэнтыфікатары CITEREF не з’яўляюцца ўнікальнымі на старонцы, вы ўбачыце чырвонае паведамленне аб памылцы, Harv/sfn error: multiple targets (n): <ідэнтыфікатар якара> у раздзеле зносак на старонцы, калі толькі ў вас не адключаны паведамленні аб памылках ад Module:Footnotes.

[заўв 1]