Predefinição:Citar livro/ref/Testes

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

Informações preliminares

As tags <cite> e <span>

Primeiramente é necessário saber qual é a função da tag ("etiqueta") <cite> e da tag <span>:

• A "tag de abertura" denominada <cite> informa ao seu navegador web que o texto que vem a seguir é o título ("âncora") de alguma citação (referência informativa).
• Já a "tag de abertura" <span> é multiuso: ela é invisível (o que se registra no interior dela não é exibido no texto da página) e pode ser usada tanto para agrupar elementos quanto para criar uma âncora dentro de um texto. Essa âncora tem um nome (um identificador ou "id") que também funciona como "título" (invisível) da citação, ou seja, como um nome invisível que marca a posição da âncora desse texto, dentro da página. Portanto, a tag <span> pode ser usada dentro do código fonte de páginas da Wikipédia (artigos, listas, páginas de discussão, predefinições etc.) para agrupar diversos elementos dentro de uma única sequência de texto, que será o texto que está "ancorado".

Exemplo de citação e âncora criadas com aquelas duas tags:

CÓDIGO

<cite><span class="citation" id="ATKINS1990">
ATKINS, John. ''Miles to go before I sleep'' (em inglês). Cambridge: Cambridge Press, 1990.
</span></cite>

No exemplo acima:

1. O código ATKINS1990 é o "nome" (identificador) da âncora;
2. O código <span class="citation" id="ATKINS1990"> informa que a âncora ATKINS1990 pertence à "classe das citações", ou seja, que essa âncora está sendo usada para marcar o ponto de início de uma citação;
3. O código ATKINS, John. ''Miles to go before I sleep'' (em inglês). Cambridge: Cambridge Press, 1990. é a citação propriamente dita, o texto que está sendo citado/referenciado;
4. A tag </span> marca o final (o ponto de "fechamento") da tag <span>: é o "fim da âncora";
5. A tag </cite> marca o final (o ponto de "fechamento") da tag <cite>: é o "fim da citação"; e
6. Caso você prefixe o nome da âncora com o caractere # e então ponha isso entre colchetes duplos (assim: [[#ATKINS1990]]), logo perceberá o respectivo surgimento de uma ligação interna que aponta para aquela âncora. Isso ocorre porque a cerquilha (caractere #), quando posta entre colchetes duplos, indica que a palavra posicionada à direita dela é o nome (identificador) de uma âncora, e que portanto a ligação interna deverá apontar para essa âncora.

Experimente clicar sobre a ligação interna #ATKINS1990 e observe que a janela do seu navegador irá se deslocar até a citação que está na janela RESULTADO. Isso ocorre justamente porque é lá que a âncora ATKINS1990 está posicionada. O texto-citação que se encontra destacado é justamente aquele que foi posto entre as tags <span class="citation" id="ATKINS1990"> e </span>: o código id="ATKINS1990" é o responsável por fazer o link #ATKINS1990 funcionar, ao passo que o código class="citation" é o responsável por fazer o fundo do texto da citação ficar com uma cor diferente quando você clica sobre o link #ATKINS1990.

O uso das tags <cite> e <span> não é obrigatório para que ocorra um correto referenciamento de um livro ou de outra obra bibliográfica: quando o navegador lê essas tags ele não recebe delas nenhuma instrução especial que o faça modificar o conteúdo visível da página, e é por isto que tal uso isoladamente não afeta o visual do texto. No entanto, é interessante criar âncoras. Uma das vantagens é poder incluir, em diversas partes de uma mesma página, ligações idênticas, ou seja, que apontam para uma mesma âncora. Exemplo: #ATKINS1990 aponta para aquela mesma âncora do exemplo, e com uso de pipe trick podemos escrever [[#ATKINS1990|isto]], que resulta em isto.

Onde essas tags são usadas

Durante a transclusão da predefinição {{Citar livro}} dentro de alguma página da Wikipédia, essas tags são inseridas no início do ponto de transclusão, assim: <cite><span class="citation" id="X">, em que "X" é o nome da âncora. Além disso, no final da transclusão são inseridas as respectivas tags de fechamento: </span></cite>).

Como o restante da tag <span> é preenchido

Observe que dentro da tag <span> o valor do parâmetro class foi informado (o valor atribuído a esse parâmetro foi "citation", que está entre aspas e indica que o conteúdo será o título de uma citação), porém o valor do parâmetro id não foi informado.

O valor que será atribuído ao parâmetro id dentro daquela tag vai depender da análise que será feita por esta subpredefinição {{Citar livro/ref}}.

Como esta subpredefinição funciona

Durante a transclusão da predefinição {{Citar livro}}, esta subpredefinição avalia se os parâmetros ref e autor foram declarados ou não, lá em {{Citar livro}}, e em caso afirmativo analisa qual valor foi atribuído a cada um desses parâmetros. Com base nessa análise, esta subpredefinição retorna um código de saída que será um número inteiro entre 0 e 4 (inclusive).

Esse código de saída será usado para {{Citar livro}} decidir qual valor irá atribuir ao parâmetro id da tag <span>. Exemplo: se durante a transclusão de {{Citar livro}} esta subpredefinição informar o valor 1, esse valor será usado por {{Citar livro}} para selecionar o texto que foi fornecido ao parâmetro ref (exemplo: ref=Âncora) e daí o código <cite><span class="citation" id=> será substituído por <cite><span class="citation" id="Âncora">

Observe que no exemplo acima o valor 1 foi fornecido pela subpredefinição {{Citar livro/ref}} para a predefinição {{Citar livro}}, que por sua vez está programada para atribuir ao parâmetro id o mesmo valor que o usuário atribuiu ao parâmetro ref: mas isso apenas se {{Citar livro/ref}} informar que o código de saída encontrado foi 1.

A próxima seção explica em qual contexto esta subpredefinição retorna cada um dos possíveis códigos de saída numéricos.

Códigos de saída

Declarar um parâmetro significa atribuir algum valor a ele. Exemplo: ref=harv significa que ao parâmetro ref foi atribuído o valor harv. Veja uma breve descrição do que significam os possíveis códigos de retorno / saída desta subpredefinição, em função dos valores que foram atribuídos (ou não) aos parâmetros ref e autor:

• 0 significa que na predefinição {{Citar livro}} não foram declarados nem o parâmetro ref nem o parâmetro autor. Neste caso, a predefinição {{Citar livro}} não fará nada: o código transcluído continuará sendo <cite><span class="citation" id=>.
• 1 significa que na predefinição {{Citar livro}} o parâmetro ref foi declarado, porém o valor que foi atribuído a ref não foi o texto harv.
• 2 significa que na predefinição {{Citar livro}} o parâmetro ref não foi declarado, porém o parâmetro autor foi declarado (recebeu algum valor).
• 3 significa que na predefinição {{Citar livro}} o parâmetro ref foi declarado recebendo o valor harv, e que além disso o parâmetro autor foi declarado (recebeu algum valor).
• 4 significa que na predefinição {{Citar livro}} o parâmetro ref foi declarado recebendo o valor harv, porém o parâmetro autor não foi declarado.

Comportamento de Citar livro

Como explicado anteriormente, caso o código de saída seja 0 a predefinição {{Citar livro}} manterá o código <cite><span class="citation" id=> inalterado. Nos demais casos, porém, os resultados serão os seguintes (os códigos que estão em negrito são parâmetros da predefinição {{Citar livro}}:

Código de saída	Valor de id	Código correspondente no cabeçalho (topo) da transclusão de {{Citar livro}}
1	ref	<cite><span class="citation" id="ref">
2	sobrenomeano	<cite><span class="citation" id="sobrenomeano">
3	CITEREFsobrenomeano	<cite><span class="citation" id="CITEREFsobrenomeano">
4	CITEREFtítuloano	<cite><span class="citation" id="CITEREFtítuloano">

republica dos estados unidos do brasil+segurança+civilizaçao+pacificaçao+onu+otan.

para sempre construidores jamais destruidores de nada.paz+amor+harmonia

Notas

vencer ou morrer retroceder jamais.paz,amor e harmonia.