Predefinição:Citar livro/autor

Permanently protected template
Origem: Wikipédia, a enciclopédia livre.
Documentação da predefinição[ver] [editar] [histórico] [purgar]

Descrição

Esta é uma subpredefinição da predefinição {{Citar livro}}, ou seja, é uma predefinição auxiliar. Tem por objetivo principal formatar o nome do único ou principal autor de um livro que foi referenciado com a predefinição {{Citar livro}}.

Parâmetros

nome

O parâmetro nome é o nome — sem o último sobrenome — do único/principal autor do livro. Exemplo: se o nome completo do autor é "João Ubaldo Osório Pimentel Ribeiro", então nome=João Ubaldo Osório Pimentel. Veja como esta subpredefinição se comporta:

  • Código: {{Citar livro/autor |nome=João Ubaldo Osório Pimentel}}
    • Resultado:

sobrenome

O parâmetro sobrenome é o último sobrenome do único/principal autor do livro. Exemplo: se o nome completo do autor é "João Ubaldo Osório Pimentel Ribeiro", então sobrenome=Ribeiro. Veja como esta subpredefinição se comporta:

  • Código: {{Citar livro/autor |sobrenome=Ribeiro}}
    • Resultado:
  • Código: {{Citar livro/autor |nome=João Ubaldo Osório Pimentel |sobrenome=Ribeiro}}
    • Resultado:

artigoautor

O parâmetro artigoautor é o título do artigo da Wikipédia a respeito desse autor, caso esse artigo exista. Deve-se informar somente o título, sem uso de colchetes duplos. Exemplo: artigoautor=João Ubaldo Ribeiro. Veja como esta subpredefinição se comporta:

  • Código: {{Citar livro/autor |nome=João Ubaldo Osório Pimentel |artigoautor=João Ubaldo Ribeiro}}
    • Resultado:
  • Código: {{Citar livro/autor |sobrenome=Ribeiro |artigoautor=João Ubaldo Ribeiro}}
    • Resultado:
  • Código: {{Citar livro/autor |nome=João Ubaldo Osório Pimentel |sobrenome=Ribeiro |artigoautor=João Ubaldo Ribeiro}}
    • Resultado:

ano

O parâmetro ano é o ano de publicação do livro. Esse ano deve ser informado em formato numérico e com quatro algarismos. Exemplo: ano=2009. Veja como esta subpredefinição se comporta:

  • Código: {{Citar livro/autor |nome=João Ubaldo Osório Pimentel |sobrenome=Ribeiro |artigoautor=João Ubaldo Ribeiro |ano=2009}}
    • Resultado:

Como pôde observar, se você passar o parâmetro ano para esta subpredefinição ela não produzirá nenhum resultado visível. No entanto, este parâmetro ano existe porque esta subpredefinição repassa o valor de ano para dentro da subpredefinição {{Citar livro/ref}}, juntamente com o valor do parâmetro sobrenome. Por sua vez, a subpredefinição {{Citar livro/ref}} utiliza esse "sobrenome" e esse "ano" para criar uma âncora de referenciamento e "fornecer" essa âncora de volta para a {{Citar livro/autor}}.

É inclusive por essa razão que no exemplo acima o sobrenome "Ribeiro" e o ano "2009" foram repassados pela "Citar livro/autor" para dentro da "Citar livro/ref", que então criou a âncora Ribeiro2009 bem ali onde o exemplo foi apresentado (na linha "Resultado"). Ou seja: se criarmos uma ligação interna (usando o caractere #) que aponte para Ribeiro2009 e clicarmos sobre esse link, seremos redirecionados ao local em que aquela âncora invisível se encontra. Vamos testar? Basta usar o código [[#Ribeiro2009]] que você obterá #Ribeiro2009. Agora clique sobre esse link e veja o que acontece.

anoharv

O parâmetro anoharv existe para você poder adicionar uma letra modificadora ao ano de publicação do livro. Exemplo: anoharv=a. Em outras palavras: se você declarar ano=2009 e anoharv=a, esta subpredefinição "Citar livro/autor" entenderá que o livro foi publicado em 2009 porém, para fins de indexação e referenciamento (âncoras), o ano é 2009a. Mas por que você faria isso?

Digamos que no interior do texto você esteja utilizando predefinições de referenciamento Harvard para fazer referência (menção) aos livros nos quais se baseou para editar o texto. Em tal caso, eventualmente poderá acontecer de um mesmo autor publicar diferentes livros em um mesmo ano e você ter de mencioná-los na mesma página, porque consultou os três livros e está se baseando nos três para escrever o texto. Exemplo (fictício): digamos que o autor "John Smith" tenha publicado, em 2009, um livro cujo título é "Título 1", mas no mesmo ano de 2009 também tenha publicado, poucos meses depois, outro livro, cujo título é "Título 2", e que no final do mesmo ano tenha ainda publicado um terceiro livro, cujo título é "Título 3". Neste caso, se você leu todos os três livros e deseja mencioná-los numa mesma página usando predefinições de referenciamento Harvard, então de acordo com as regras de referenciamento estilo Harvard (que indexam referências utilizando somente o sobrenome do autor principal e o ano de publicação da obra) você deverá informar que o primeiro livro foi publicado por "Smith" no ano 2009a, que o segundo livro foi publicado por "Smith" no ano 2009b, e ainda que o terceiro livro foi publicado por "Smith" no ano 2009c. Exemplo: o código {{Harvnb |Smith |2009a}}, {{Harvnb |Smith |2009b}} e {{Harvnb |Smith |2009c}} pode ser usado para produzir Smith 2009a, Smith 2009b e Smith 2009c.

Como esta subpredefinição "Citar livro/autor" é usada pela {{Citar livro}} para posicionar âncoras (geradas pela {{Citar livro/ref}}) que permitem às predefinições Harvard "interagir" com a {{Citar livro}} (você clica sobre o link criado por uma dessas predefinições Harvard e esse link aponta para uma âncora que, espera-se, esteja presente em alguma "Citar livro"), é necessário que o ano de publicação, informado na predefinição "Citar livro", seja igual ao informado na predefinição Harvard.

Por esta razão, caso a página editada por você possua predefinições Harvard mencionando, por exemplo, aqueles três livros publicados pelo Smith em 2009, e caso na mesma página você esteja usando três predefinições "Citar livro" — uma para cada livro —, então na primeira "Citar livro" você deverá informar ano=2009 e anoharv=a, na segunda "Citar livro" você deverá informar ano=2009 e anoharv=b, e na terceira "Citar livro" você deverá informar ano=2009 e anoharv=c. O intuito aqui é que você "case" a predefinição Harvard que menciona o livro "2009a" com a predefinição "Citar livro" que informa ano=2009 e anoharv=a, e assim sucessivamente para os outros pares "Harvard/Citar livro".

Como uma imagem vale mais que mil palavras, observe abaixo um exemplo de seção "Bibliografia" mencionando aqueles três livros fictícios que o Smith publicou em 2009:

CÓDIGO

==Bibliografia==
*{{Citar livro/autor |nome=John |sobrenome=Smith |artigoautor=John Smith |ano=2009 |anoharv=a}}
*{{Citar livro/autor |nome=John |sobrenome=Smith |artigoautor=John Smith |ano=2009 |anoharv=b}}
*{{Citar livro/autor |nome=John |sobrenome=Smith |artigoautor=John Smith |ano=2009 |anoharv=c}}
Bibliografia
* * *

Bibliografia


Agora volte lá àquela predefinição Harvard que está mostrando o texto Smith 2009a com um link e clique sobre ele. Você perceberá que o link lhe conduzirá ao livro "2009a" do exemplo acima. Isso ocorre porque a primeira subpredefinição "Citar livro/autor" do exemplo acima repassou os parâmetros sobrenome (cujo valor é Smith), ano (cujo valor é 2009) e anoharv (cujo valor é a) para a subpredefinição "Citar livro/ref", que por sua vez gerou a âncora "Smith2009a" e a "devolveu" ao exemplo acima. Como ali em cima existe essa âncora "Smith2009a", em qualquer parte da página você pode criar uma ligação interna que aponte para #Smith2009a e então clicar sobre essa ligação. No caso daquela {{Harvnb |Smith |2009a}}, ela criou em "cima" de si mesma uma ligação #Smith2009a, e é por isto que ao clicar sobre ela a página foi deslocada até o ponto em que a âncora "Smith2009a" se encontra. Experimente clicar nos outros links #Smith2009a criados neste parágrafo e observe como todos eles apontam para o mesmo local, que é onde se encontra a âncora invisível "Smith2009a", criada com a "colaboração" do parâmetro anoharv.

Observe, ainda, que no exemplo acima o fato de os livros "2009b" e "2009c" terem sido citados nas outras duas predefinições "Citar livro/autor" gerou, em cada uma delas, respectivamente a âncora "Smith2009b" e a âncora "Smith2009c", e é por esta razão que se você retornar àquelas predefinições Harvard e clicar sobre "Smith 2009b" ou "Smith 2009c" você obterá o mesmo resultado que obterá caso clique respectivamente sobre este link #Smith2009b ou sobre este #Smith2009c.

ref

Digamos que você não queira usar predefinições Harvard porém queira, mesmo assim, que um trecho do seu texto contenha um link que aponte para um livro que você referenciou na seção "Bibliografia", por exemplo. Como fazer isso? É aí que surge a utilidade do parâmetro ref.

Neste novo exemplo fictício, vamos assumir que em 2001 o autor Robert Atkins escreveu um livro sobre Nutrição e você agora queira incluir no seu texto um link que aponte simplesmente para #RA (abreviação de "Robert Atkins"). Observe como isso pode ser feito com auxílio do parâmetro ref.

CÓDIGO

O Dr. Atkins escreveu [[#RA|um de seus melhores livros]] no ano de 2001...

==Bibliografia==
*{{Citar livro/autor |nome=Robert |sobrenome=Atkins |artigoautor=Robert Atkins |ano=2001 |ref=RA}}
O Dr. Atkins escreveu um de seus melhores livros no ano de 2001...

Bibliografia
*

O Dr. Atkins escreveu um de seus melhores livros no ano de 2001...
Bibliografia


Percebeu que se você clicar sobre o trecho "um de seus melhores livros" o seu navegador web desloca a página até o ponto em que se encontra a referência para o livro, dentro da seção "Bibliografia"? Isto ocorreu porque o parâmetro ref foi repassado pela "Citar livro/autor" para a subpredefinição "Citar livro/ref", que por sua vez usou esse parâmetro para criar a âncora RA e devolvê-la à "Citar livro/autor", que então posicionou essa âncora junto ao nome do autor. Por isto, ao criar o link #RA em qualquer parte do texto e clicar sobre ele você será redirecionado àquela âncora invisível denominada RA.

refharv

O parâmetro refharv é idêntico ao parâmetro ref, no sentido de que também cria uma âncora com o texto que você informar em refharv. Mas por que dois parâmetros que têm a mesma função? Por que criar duas âncoras? O motivo é simples: o parâmetro refharv foi criado para o caso de você querer criar uma "âncora genérica" para usar com uma predefinição Harvard de âncoras genéricas, como é o caso da {{Harvx}}, e no entanto criar outra âncora genérica para usar no meio do texto, sem auxílio de predefinição Harvard nenhuma. Veja um exemplo:

CÓDIGO

Esta é uma das mais simples e belas poesias de {{Harvx |Ceci |Meireles}}:
{{Citação2 |Cesto de peixes no chão.
Cheio de peixes, o mar.
Cheiro de peixe pelo ar.
E peixes no chão.

Chora a espuma pela areia,
na maré cheia.

As mãos do mar vêm e vão,
as mãos do mar pela areia
onde os peixes estão.

As mãos do mar vêm e vão,
em vão.
Não chegarão
aos peixes do chão.

Por isso chora, na areia,
a espuma da maré cheia.

|[[#autora|Cecília Benevides de Carvalho Meireles]]}}

==Bibliografia==

*{{Citar livro/autor
 |nome=Cecília Benevides de Carvalho
 |sobrenome=Meireles
 |artigoautor=Cecília Meireles
 |ref=autora
 |refharv=Ceci}}
Esta é uma das mais simples e belas poesias de Meireles:
Cesto de peixes no chão.
Cheio de peixes, o mar.
Cheiro de peixe pelo ar.
E peixes no chão.
Chora a espuma pela areia,
na maré cheia.
As mãos do mar vêm e vão,
as mãos do mar pela areia
onde os peixes estão.
As mãos do mar vêm e vão,
em vão.
Não chegarão
aos peixes do chão.
Por isso chora, na areia,
a espuma da maré cheia.
 
Bibliografia
*

Esta é uma das mais simples e belas poesias de Meireles:
Cesto de peixes no chão.

Cheio de peixes, o mar.
Cheiro de peixe pelo ar.
E peixes no chão.

Chora a espuma pela areia,
na maré cheia.
As mãos do mar vêm e vão,
as mãos do mar pela areia
onde os peixes estão.

As mãos do mar vêm e vão,
em vão.

Não chegarão
aos peixes do chão.

Por isso chora, na areia,
a espuma da maré cheia.

 
Bibliografia


Observe no exemplo acima que aquela subpredefinição {{Citar livro/autor}} usou os parâmetros ref e refharv para, com o auxílio da subpredefinição {{Citar livro/ref}}, criar respectivamente as âncoras "autora" e "Ceci", ambas no mesmo local (mesmo ponto da página). Observe, ainda, que a predefinição {{Harvx}} foi usada para criar um link que aponta para #Ceci, ao passo que no rodapé da poesia o texto "Cecília Benevides de Carvalho Meireles" foi posto dentro de um link que aponta para #autora. Experimente deslocar esta página verticalmente e clicar sobre aqueles (ou estes) links "Meireles" e "Cecília Benevides de Carvalho Meireles". Observe o que acontece.

Parâmetros depreciados

O parâmetro autor foi criado unicamente para lidar com os casos pretéritos nos quais os wikipedistas usaram a predefinição {{Citar livro}} declarando o nome completo do autor com este parâmetro, ao invés de usarem os parâmetros nome e sobrenome (exemplo: autor=Fulano Beltrano, ao invés de nome=Fulano e sobrenome=Beltrano). Em outras palavras: este é um parâmetro de manutenção, e consequentemente não deve ser utilizado.

Cabeçalho de TemplateData

As informações a seguir (editar) são definidas com TemplateData. Isso possibilita o seu uso pelo Editor Visual e por outras ferramentas.

Esta é uma subpredefinição da predefinição {{Citar livro}}, ou seja, é uma predefinição auxiliar. Tem por objetivo principal formatar o nome do único ou principal autor de um livro que foi referenciado com a predefinição {{Citar livro}}.

Parâmetros da predefinição[Editar dados da predefinição]

ParâmetroDescriçãoTipoEstado
Nomenome

Nome do único/principal autor do livro, mas sem o último sobrenome. Exemplo: se o nome completo do autor é "João Ubaldo Osório Pimentel Ribeiro", então o valor do parâmetro "nome" será "João Ubaldo Osório Pimentel" (sem as aspas).

Stringrecomendado
Sobrenomesobrenome

Último sobrenome do único/principal autor do livro. Exemplo: se o nome completo do autor é "João Ubaldo Osório Pimentel Ribeiro", então o valor do parâmetro "sobrenome" será "Ribeiro" (sem as aspas).

Stringrecomendado
Artigo do autorartigoautor

Título do artigo da Wikipédia a respeito desse autor, caso esse artigo exista. Deve-se informar somente o título, sem uso de colchetes duplos. Exemplo: João Ubaldo Ribeiro

Nome da páginaopcional
Anoano

Ano de publicação do livro. Esse ano precisa ser informado em formato numérico e com quatro algarismos. Exemplo: 2009

Númeroopcional
Dígito Harvard do anoanoharv

Letra (a, b, c, d, e...) modificadora do ano. Exemplo: b. Neste caso, se "ano" for informado como "2009" e "anoharv" for informado como "b", a predefinição entenderá que a obra foi publicada em 2009 porém, para fins de referenciamento estilo Harvard, o ano é "2009b". Isto é útil para os casos em que uma ou mais predefinições de referenciamento Harvard (como p.ex. as predefinições {{Harv}} e {{Harvnb}}) são usadas, em uma mesma página, para fazer referência a diferentes livros de um mesmo autor publicados no mesmo ano. Exemplo: 3 livros diferentes do mesmo autor de sobrenome "Smith", publicados no ano 2009. Neste caso, de acordo com as regras de referenciamento Harvard, o primeiro livro será do "ano" 2009a, o segundo do "ano" 2009b e o terceiro do "ano" 2009c. Para mais informações, consulte a documentação desta predefinição.

Stringopcional
Âncora de referenciamento genéricoref

Nome da âncora genérica (personalizada) a ser usada para referenciamentos. Exemplo: âncora. Após atribuir "ref=âncora", você poderá criar, em qualquer local dentro da página, um link [[#âncora]], e então esse link automaticamente apontará para o local dentro da página em que esta predefinição foi posta.

Stringopcional
Âncora de referenciamento genérico estilo Harvardrefharv

Faz o mesmo que o parâmetro "ref", porém foi reservado para uso com predefinições de referenciamento estilo Harvard. Por padrão, a predefinição {{Citar livro}} já insere automaticamente âncoras (criadas pela subpredefinição {{Citar livro/ref}}) que funcionarão com predefinições Harvard tais como {{Harv}}, {{Harvnb}}, {{Harvx}} etc. No entanto, "refharv" existe para o caso de se querer criar uma âncora personalizada (individualizada).

Stringopcional

Ver também