Predefinição:Harvc

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Esta predefinição é um híbrido de citação que tem características de formato longo cs1 e cs2, de formato curto {{sfn}} e das famílias de predefinições {{harv}}. Seu objetivo é fornecer um método que permita que os editores se refiram a uma contribuição ou capítulo em uma obra maior quando mais do que algumas dessas referências são necessárias. {{harvc}} não substitui uma citação devidamente construída.

As predefinições de formato curto {{sfn}} e {{harv}} são frequentemente usados para vincular a seção de referências de um artigo a um modelo cs 1/2 de formato longo em uma seção de bibliografia:

{{harv}} → {{citar livro}}

Não é incomum que uma fonte tenha vários contribuintes. Quando é necessário fazer referência a várias contribuições na mesma fonte, repetir todos os detalhes bibliográficos em vários modelos de citação de formato longo aumenta a confusão de seções de referências. {{harvc}} destina-se a conter apenas os detalhes necessários para identificar uma contribuição e link para a citação longa da obra anexa, onde todos os detalhes bibliográficos podem ser encontrados

{{harv}} → {{harvc}} → {{citar livro}}

Uso

A forma mínima é:

{{harvc |last=nome contribuidor |year=ano publicação |c=título contribuição |in=editor fonte/nome autor}}

De acordo com os comentários em Módulo:Harvc, as mensagens de erro mensagens de erro trocadas Hawk error: Sem destino: podem ser produzidas quando a predefinição está aninhado em outras predefinições, como nas páginas de documentação. O parâmetro não documentado, |ignore-err=yes, pode ser adicionado para evitar isso.

Parâmetros

{{harvc}} cria a âncora com o código CITEREF de uma até quatro autores de contribuições ou capítulos (|últimon=) e o valor em |year=. Isso permite que {{harvc}} a ser o destino na família de predefinições do link criado em {{sfn}} ou {{harv}}. De |inn= e |ano=, {{harvc}} cria o link CITEREF similar ao criados por {{harvnb}} e {{sfn}}

|anchor-year= – facultativo, para utilização do(S) autor (es) com mais do que uma contribuição para o trabalho; requer citeref disambiguator; ver Exemplos]

|author-link= – opcional, título do artigo existente da Wikipedia sobre o primeiro colaborador—não o site do colaborador; não faça wikilink; alias: |author-link1=

|author-linkn= –opcional, título do artigo existente na Wikipédia sobre o colaboradorn; escolhe n para igualar n em |lastn=

|author-mask=m – opcional, substitui o nome do primeiro colaborador por m (geralmente 2) traços em; alias: |author-mask1=

|author-maskn=m – opcional, substitui o nome do contribuidorn com m em dashes; escolha n para igualar n em |lastn=

|author-maskn=<text> – opcional, substitui o nome do contribuidorn com <text>

|c= – obrigatório, o título do capítulo ou a contribuição; traduzido entre aspas em letra vertical; pseudónimos: |chapter=, |contribution=

|display-authors= – opcional, define como {{harvc}} mostra a lista de contribuidores; ignorado quando |name-list-style=harv:

|display-authors= – quando vazio ou omitido, exibe todos os nomes dos colaboradores no último / primeiro formato

|display-authors=n – mostra nomes de contribuidor n com formato último/primeiro; adiciona et al. quando n é inferior ao número de contribuidores incluídos no modelo

|display-authors=etal – apresenta todos os nomes dos colaboradores no último / primeiro formato e acrescenta et al.

|first= – facultativo, nome próprio ou nome próprio do primeiro colaborador; alias: |first1=

|firstn= – opcional, primeiro ou último nome do contribuidorn; n começa com 2 e aumenta por 1 para cada |firstn= adicional

|id= – necessário quando |last1=-|last4= são o mesmo que |in1=-|in4=; de outra maneira opcional.

|in= – obrigatório, apelido ou apelido do primeiro editor ou autor da obra que inclui a contribuição; aliases: |in1=

Exemplos

Exemplo básico

Sem {{harvc}}	Com {{harvc}}
Doe, John (1990). «Chapter 1». In: Moe, Mary. The Book of Knowledge. [S.l.]: University Press  Poe, Jane (1990). «Chapter 2». In: Moe, Mary. The Book of Knowledge. [S.l.]: University Press  Roe, Robert (1990). «Chapter 3». In: Moe, Mary. The Book of Knowledge. [S.l.]: University Press	Moe, Mary, ed. (1990). The Book of Knowledge. [S.l.]: University Press  Doe, John. "Chapter 1". In Moe (1990). Poe, Jane. "Chapter 2". In Moe (1990). Roe, Robert. "Chapter 3". In Moe (1990).

Markup

* {{citar livro |último=Doe |primeiro=John |ano=1990 |capítulo=Chapter 1 |editor-sobrenome=Moe |editor-nome=Mary |título=The Book of Knowledge |publicado=University Press}} * {{citar livro |último=Poe |primeiro=Jane |ano=1990 |capítulo=Chapter 2 |editor-sobrenome=Moe |editor-nome=Mary |título=The Book of Knowledge |publicado=University Press}} * {{citar livro |último=Roe |primeiro=Robert |ano=1990 |capítulo=Chapter 3 |editor-sobrenome=Moe |editor-nome=Mary |título=The Book of Knowledge |publicado=University Press}}

* {{citar livro |editor-sobrenome=Moe |editor-nome=Mary |ano=1990 |título=The Book of Knowledge |publicado=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}}

Exempo detalhado

Quando um artigo da Wikipedia faz referência a uma obra que contém vários capítulos de diferentes autores, bibliografias e seções de referência podem parecer bastante desordenadas:

• 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. [S.l.]: 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. [S.l.]: 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. [S.l.]: United States Department of Agriculture. OCLC 704186906 
• Wadleigh, C. H. (1957). «Growth of Plants». In: Stefferud, Alfred. Soil: The Yearbook of Agriculture 1957. [S.l.]: United States Department of Agriculture. OCLC 704186906 

À medida que a lista cresce, o olhar torna-se mais confuso com os detalhes desnecessariamente repetidos de citações completas. Com {{harvc}} os editores podem vincular as citações de contribuição mais curtas e menos detalhadas usando implementações padrão de modelos {{sfn}} e modelos {{harv}} (e também encapsulados em tags <ref>...</ref> com {{harvnb}}). {{harvc}} também pode ser encapsulado em <ref>...</ref> tags para que se torne parte da seção de referências do artigo. Veja o exemplo completo abaixo.

Evitar referências circulares

Por vezes, pode ser necessário citar uma contribuição do editor ou do autor de uma fonte de modo a que |last1= até |last4= sejam iguais a |in1= até |in4=, prefácio de um editor, por exemplo. Essas citações podem, dependendo do posicionamento, fazer com que as referências da família {{sfn}} ou {{harv}} se vinculem diretamente à citação em vez de ao modelo {{harvc}}, ou causar links circulares ({{harvc}} vinculando a si mesmo porque seu identificador CITEREF de âncora é o mesmo que o identificador CITEREF de âncora da citação). Se |id= é o conjunto {{harvc}} irá usá-lo como uma âncora identificador; se |id= não está definido, {{harvc}} irá emitir uma mensagem de erro quando |last1= através |last4= são as mesmas |in1= através |in4=.

Por exemplo, para fazer referência ao prefácio de um editor a partir do texto do artigo, crie um wikilink dentro das tags <ref>...</ref> :

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

Write a {{harvc}} template with |id=Stefferud preface

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

Exemplo completo:

Marcação

First information.{{sfn|George|Read|Johnson|Ferber|1957}} Second.<ref>{{harvnb|Stout|Johnson|1957}}</ref> Three thru five.<ref>{{harvnb|Stout|Johnson|1957}}</ref><ref>{{harvc|last=Benson|first=Ezra Taft|year=1957|chapter=Foreword|url=//archive.org/stream/yoa1957#page/n5/mode/1up|in=Stefferud|p=vi |loc=§2 |ignore-err=yes}}</ref>{{sfn|Wadleigh|1957}} Sixth.<ref>[[#Stefferud preface|Stefferud 1957]]</ref> <!-- ==Notes== --> {{fake heading|sub=3|Notas}} {{reflist}} <!-- ==References== --> {{fake heading|sub=3|Referências}} * {{citar livro |título=Soil: The Yearbook of Agriculture 1957 |editor-sobrenome=Stefferud |editor-nome=Alfred |ano=1957 |publicado=United States Department of Agriculture |url=//archive.org/stream/yoa1957 |oclc=704186906 }} ** {{harvc |last=George |first=Ernest J. |last2=Read |last3=Johnson |last4=Ferber |year=1957 |contribution=Shelterbelts and Windbreaks |url=//archive.org/stream/yoa1957#page/n785/mode/1up |in=Stefferud |ignore-err=yes}} ** {{harvc |last=Harper |first=V. L. |last2=Frank |last3=McQuilkin |year=1957 |contribution=Forest Practices |url=//archive.org/stream/yoa1957#page/n803/mode/1up |in=Stefferud |ignore-err=yes}} ** {{harvc |last=Stefferud |first=A.|year=1957 |id=Stefferud preface |c=Preface |url=//archive.org/stream/yoa1957#page/n7/mode/1up |in=Stefferud |ignore-err=yes}} ** {{harvc |last=Stout |first=P. R. |last2=Johnson |year=1957 |c=Trace Elements |url=//archive.org/stream/yoa1957#page/n167/mode/1up |in=Stefferud |ignore-err=yes}} ** {{harvc |last=Wadleigh |first=C. H.|year=1957 |c=Growth of Plants |url=//archive.org/stream/yoa1957#page/n57/mode/1up |in=Stefferud |ignore-err=yes}}

Renderização

First information. Second. Three thru five. Sixth. Notas Referências Stefferud, Alfred, ed. (1957). Soil: The Yearbook of Agriculture 1957. [S.l.]: United States Department of Agriculture. OCLC 704186906  George, Ernest J.; Read; Johnson; Ferber. "Shelterbelts and Windbreaks". In Stefferud (1957). Harper, V. L.; Frank; McQuilkin. "Forest Practices". In Stefferud (1957). Stefferud, A. Preface. In Stefferud (1957). Stout, P. R.; Johnson. "Trace Elements". In Stefferud (1957). Wadleigh, C. H. "Growth of Plants". In Stefferud (1957).

Observe novamente que o parâmetro ignore-err=yes é simplesmente para suprimir erros que ocorrem quando este modelo é incorporado, como na documentação. Não deve ser utilizado de outra forma.

Mais de uma contribuição

Há momentos em que um autor ou autores terão contribuído mais de uma vez para uma obra. Quando isso ocorre, é necessário desambiguar os links CITEREF dos modelos {{harv}} ou {{sfn}} para o ID CITEREF do modelo {{harvc}} apropriado.

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

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

Neste exemplo, o autor David Hunt contribuiu com dois apêndices para Christmas Cacti: The Genus Schlumbergera and Its Hybrids.

Existem duas predefinições {{harvnb}} que estão desambiguados:

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

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

Estes são dois links que usam |anchor-year= para sua referência de referência e para a data na renderização {{subst:harvc}} como um auxílio visual para os leitores:

Marcação	Renderiza como
{{harvnb |Hunt |1995a}}; {{harvnb |Hunt |1995b}}. <!-- ==References== --> {{fake heading|sub=3|Referências}} * {{Citation |último=McMillan |primeiro=AJS |último2=Horobin |primeiro2=JF |ano=1995 |título=Christmas Cacti: The Genus ''Schlumbergera'' and Its Hybrids |edição=p/b |publication-place=Sherbourne, UK |publicado=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. Referências McMillan, AJS; Horobin, JF (1995), Christmas Cacti: The Genus Schlumbergera and Its Hybrids, ISBN 978-0-9517234-6-3 p/b ed. , Sherbourne, UK: David Hunt  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