Extension:Cite/Cite.php/pt-br

From MediaWiki.org
Jump to navigation Jump to search
Esta página fornece uma documentação geral válida para todas as instalações MediaWiki que usam a extensão. Para usar este recurso veja na Wikipédia Notas de rodapé. Esta página também inclui muitos exemplos.
Manual de extensões do MediaWiki
OOjs UI icon advanced.svg
Cite
Estado da versão: estável
Implementação Tag
Descrição Permite a inserção de notas de rodapé
Autor(es) Ævar Arnfjörð Bjarmasontalk
Última versão atualizações contínuas
MediaWiki 1.13+
PHP 5.3+
Licença Nenhuma licença especificada
Download
Exemplo Wikipédia:Notas de rodapé
Parâmetros
  • $wgAllowCiteGroups
  • $wgCiteCacheReferences
  • $wgCiteEnablePopups
Etiquetas

  • <ref>
  • <references />
Hooks usados
ParserFirstCallInit
Traduzir a extensão Cite/Cite.php, se estiver disponível no translatewiki.net
Verificar uso e matriz de versões
Problemas Tarefas em aberto · Relatar um bug

Cite.php é uma extensão cite que adiciona dois "parser hooks" ao MediaWiki, <ref> e <references>; que funcionarão juntos adicionando citações às páginas.

Onde fazer o download[edit]

Necessário para uso do Cite.php, caso contrário, aparecerá uma página em branco!
Atenção Atenção: O arquivo Cite.i18n.php contém certos caracteres que podem ser convertidos para ? quando você clicar no link acima. Para evitar isso, clique com o botão direito e selecione Salvar como....

Requisitos[edit]

Versão do MediaWiki: 1.6

Esta versão requer pelo menos a versão 1.6 do Mediawiki.

Como instalar[edit]

  1. Localize os arquivos de extensão Cite.php e Cite.i18n.php em um subdiretório Cite dentro de seu diretório de extensões/
  1. Adicione a seguinte linha no arquivo LocalSettings.php: require_once( "{$IP}/extensions/Cite/Cite.php" );
A linha require_once() precisa estar localizada antes da chamada para incluir o arquivo DefaultSettings.php.

Como usar[edit]

O conceito básico da tag <ref> é que ela insere o texto delimitado pelas tags ref como um nota de rodapé numa determinada seção, que é indicada com a tag reservada <references/>. O novo formato não pode ser usado juntamente com o antigo[1] formato - você deve escolher entre um e outro.

Se você esquecer de incluir <references/> no final do artigo, nenhuma das notas de rodapé aparecerá.

Esta página mesmo usa notas de rodapé, como a que está no final deste parágrafo. [2] Se você visualizar o fonte desta página clicando "Editar esta página", você poderá ver um exemplo funcional das notas de rodapé.

Exemplo[edit]

Segundo os cientistas, o Sol é bem grande.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>

A Lua, no entanto, não é tão grande.<ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>

==Notes==
<references/>

Múltiplos usos da mesma nota de rodapé[edit]

Para dar a uma nota de rodapé um indetificador único, use <ref name="name">. Você pode então referir-se à mesma nota de rodapé novamente usando uma tag ref com o mesmo nome. O texto dentro da segunda tag não é utilizado na nota de rodapé, por que o texto já existe na primeira referência. Entretanto você pode copiar a nota de rodapé inteira, ou você pode usar uma tagref vazia como esta: <ref name="name"/>.

No exemplo seguinte, a mesma fonte é citada três vezes.

Este é um exemplo de múltiplas referências da mesma nota de rodapé.<ref name="multiple">Lembre-se que quando se referem a mesma nota de rodapé várias vezes, o texto da primeira referência é usado.</ref>

Tais referências são particularmente úteis ao se citar fontes, se as declarações diferentes vêm da mesma fonte.<ref name="multiple">Este texto é supérfluo, e não vai aparecer em qualquer lugar. Podemos também usar apenas uma tag vazia.</ref>

Uma forma concisa de fazer múltiplas referências é usar tags ref vazias, que têm uma barra no final. Embora isso possa reduzir o trabalho redundante, por favor, esteja ciente de que se um editor futuro remove a primeira referência, isto irá resultar na perda de todas as referências que utilizam as tags ref vazias.<ref name="multiple" />

==Notas==
<references/>

O texto acima fornece o seguinte resultado no artigo (veja também a seção de notas a seguir):

Este é um exemplo de múltiplas referências da mesma nota de rodapé.[3]

Tais referências são particularmente úteis ao se citar fontes, se as declarações diferentes vêm da mesma fonte.[3]

Uma forma concisa de fazer múltiplas referências é usar tags ref vazias, que têm uma barra no final. Embora isso possa reduzir o trabalho redundante, por favor, esteja ciente de que se um editor futuro remove a primeira referência, isto irá resultar na perda de todas as referências que utilizam as tags ref vazias.[3]

<references/>[edit]

Localizar <references/> insere o texto completo de todas as citações pendentes na seqüência definida por <ref>, em qualquer lugar da página. Por exemplo, baseado nas citações acima, o código:

<references/>

produzirá o seguinte resultado:

  1. teste references one
  2. Esta nota de rodapé é usada como um exemplo na seção "Como usar".
  3. 3.0 3.1 3.2 Lembre-se que quando se referem a mesma nota de rodapé várias vezes, o texto da primeira referência é usado. Cite error: Invalid <ref> tag; name "multiple" defined multiple times with different content

Na Wikipédia, as referências são feitas às vezes menores do que o texto normal, usando o código:

<div class="references-small">
<references/>
</div>

Personalização[edit]

Template:Technical/pt-br O formato da saída de <ref> e <references> é quase completamente personalizável através de mensagens do MediaWiki, que podem ser modificadas, por exemplo, através do namespace MediaWiki, dependendo da configuração do wiki.

Para obter uma lista das mensagens que controlam a saída de <ref> e <references> e os valores, se for o caso, que são passados ​​a eles ($1, $2, $3 ...), veja o código no CVS para obter uma lista atualizada de seu conteúdo padrão.

  • cite_reference_link_key_with_num
    1. chave
    2. número
  • cite_reference_link_prefix
  • cite_reference_link_suffix
  • cite_references_link_prefix
  • cite_references_link_suffix
  • cite_reference_link
    1. ID da ref
    2. ID do backlink
    3. contagem para visualizar
  • cite_references_link_one
    • Usado para formatar a lista de fontes que a marcação <references /> exibe, ele configura três coisas: a identificação backlink, a identificação ref, e o texto da nota.
    1. ID do backlink - usado para a criação da ordem numérica da lista de fontes.
    2. ID da ref - usado para ligar de volta para a referência real no texto, este é o lugar onde você pode configurar o símbolo <bold>^</bold>
    3. texto da nota - texto usado acima que descreve a informação da fonte
  • cite_references_link_many
    1. ID do backlink
    2. lista de links
    3. texto da nota
  • cite_references_link_many_format
    1. ID da ref
    2. valor numérico para usar como um backlink
    3. valor personalizado (como definido em cite_references_link_many_format_backlink_labels para se usar como um backlink)
  • cite_references_link_many_format_backlink_labels
  • cite_references_link_many_sep
  • cite_references_link_many_and
  • cite_references_prefix
  • cite_references_suffix

Definir referências para usar ^ e letras como a Wikipédia[edit]

No arquivo Cite.i18n.php começando por volta da linha 47,

'cite_references_link_one' => '<li id="$1">[[#$2|^]] $3</li>', 
'cite_references_link_many' => '<li id="$1">^ $2 $3</li>', 
'cite_references_link_many_format' => '[[#$1|<sup>$3</sup>]]',


O sinal ^ substitui as setas para cima e colocando $ 3 na última linha entre as tags sup/sup corrigem os links w/ a b c ... vice 2.1, 2.2, 2.3, etc ..

Problemas[edit]

Problemas atuais[edit]

Isso não funciona com a versão 1.6.8! Eu finalmente tenho cite.php funcionando com "13660", mas não com versões "13826". Minhas mensagens de erro apareceram no topo da página
Warning: Cannot modify header information - headers already sent by (output started at
/****/wiki/extensions/Cite.i18n.php:399) in /****/OutputPage.php on line 575
Warning: Cannot modify header information - headers already sent by (output started at 
/****/wiki/extensions/Cite.i18n.php:399) in /****/wiki/includes/OutputPage.php on line 576
Sinais ??? aparacem em páginas renderizadas em vez do sinal ↑
Usar <ref> em predefinições quebra a numeração
Problema com o MediaWiki no que diz respeito a que ordem as coisas são analisadas
Usar <ref> dentro de uma predefinição criará corretamente marca de referência numerada, mas ficará faltando a saída de um <reference /> na página que fez a chamada. (exemplo)
É impossível passar argumentos de predefinição para <ref>, e.g. <ref name={{{1}}}>
Problema com o MediaWiki, veja bug 4529
Os links de citação gerados por <ref> e os backlinks gerados por <references> possuem um atributo title vazio (<a href="..." title="">...)
Problema com o MediaWiki, não com esta extensão. O MediaWiki gerará uma saída como <a href="#foo" title="">bar</a> quando dada uma entrada como [[#foo|bar]]
Falta âncoras name= para compatibilidade com versões anteriores (5567)
Os links <a href="#_note-n"> gerados devem ter uma tag name="_ref-n".
Os links <a href="#_ref-n"> gerados devem ter uma tag name="_note-n".
Isto atualmente parece estar funcionando. —72.255.34.142 17:02, 22 de Julho de 2006 (UTC)
Comentar <ref> com marcações HTML <!--…--> esconde a citação, mas a referência ainda aparece na lista
Isto parece ser um erro de interpretação...
O arquivo cite.php não é compatível com ParserFunctions
Enquanto a ligação gerada pode ser excluída com «#ifexist:», a referência ainda aparece na saída de uma tag <reference />.
A substituição da predefinição desrenderiza dentro da tag <ref>.
Conteúdo de tags <ref> não nomeadas primeiramente não é processado​​, mesmo se todas as marcas anteriores com o mesmo nome estejam vazias.
O que causa a página Specialːversion v1.9.2 ficar em branco. Parece que isso causa o problema
'author' => 'Ævar Arnfjörð Bjarmason',
Alterar desta maneira resolve o problema (Desculpem se traduzi errado...)
'author' => 'Evar Arnfjoro Bjarmason',
--ChuckMcB 21:23, 12 March 2007 (UTC)

Críticas[edit]

A principal crítica a respeito do Cite.php é que ele torna a edição de referências muito mais tediosa. Além disso, devido muitos usuários da Wikipedia casuais não estarem familiarizados com as enigmáticas tags Wikitext que eles encontram com o uso de Cite.php, é provável que o efeito líquido do Cite.php é muitas vezes dissuadir novos usuários de fazer edições para referenciar seções. Embora a Wikipédia supostamente tenha seu nome ligado à palavra havaiana "wiki-wiki", que significa "rápido, rápido", o Cite.php não é, indiscutivelmente, nem fácil nem rápido para o usuário médio da Wikipédia.

Uma possível solução seria a seção de referência real conter todas as referências com nomes próprios, em seguida, ao longo do artigo, simplesmente fazer referência pelo nome, em vez da citação integral. Isto também reduziria a confusão sobre vários usos de uma referência com texto diferente, mas apenas mostrando a primeira instância (causando confusão com seções que são deslocadas ao redor, a referência apresentada pode mudar, enquanto o texto, não), ou seja:
Algum texto que necessita de uma ref.{{ref|foo}} 
  Outra frase que utiliza uma ref,{{ref|bar}} 
  seguido por uma outra utilização da primeira ref.{{ref|foo}}
Usar o arquivo cite.php torna a citação de números das páginas mais difícil. Cada referência geralmente cita uma página diferente do livro/jornal/artigo, mas não há nenhuma maneira de indicar um número de página diferente quando se usa uma tag de auto-fechamento. Como tal, todas as tags <ref name="xyz" /> simplesmente se referem à obra como um todo, ao invés de um número de página específica no trabalho. Talvez uma futura revisão do arquivo cite.php poderia permitir que um argumento de número da página a ser passado para a referência assim como <ref name="xyz" page="42-43" />. Isso aumentaria drasticamente a idoneidade das citações, pois elas poderiam então ser verificadas/checadas, e as citações seriam um recurso mais útil.
===Referências===
{{refs
  {{ref|foo|Texto de referência}}
  {{ref|bar|Uma referência diferente}} }}
Embora, isso exigiria duas passagens pelo analisador, simplificaria muito o processo de colocar fontes. Ou seja, se eu estou acrescentando algo a um artigo e quero usar uma fonte que eu sei que já é citada, eu tenho que vasculhar o texto do artigo para saber onde é usado, (que pode ser uma grande dor de cabeça em grandes artigos, especialmente aqueles que têm um monte de referências) em vez de apenas olhar de relance o código para a seção de referências e encontrar o nome.

Outra crítica é que, ao contrário do Footnotes3, atualmente é impossível separar a informação bibliográfica da cópia do artigo.

No entanto, pelo menos, um editor, Ta bu shi da yu, considerou extremamente útil para dividir artigos e mudar o texto com notas de rodapé em todo o artigo. Antes, um parágrafo com uma nota de rodapé precisava ser movido, e várias notas de rodapé na seção Notas mudavam. Isso foi muito difícil de fazer. Com o Cite.php, reorganizar texto e dividir artigos é consideravelmente mais fácil

Problemas anteriores[edit]

A extensão não gerou atributos de ID que poderiam ser uniformemente estilizados com seletores de atributo CSS2
Problema no Cite.php, consulte bug 4579
A utilização de caracteres de vários bytes, dois pontos, espaços e outros valores que precisam ser codificados de acordo com a especificação HTML rompe as ligações internas
problema com o MediaWiki, não esta extensão, consulte bug 4461.
A utilização de <ref> em legendas de imagem quebra a saída XHTML
Problema com o MediaWiki, não esta extensão, consulte bug 1887.

Comparando o estilo ref/nota e o estilo Cite.php[edit]

Eles são realmente muito semelhantes.

  • Para fazer uma nota de rodapé de uso único:
    • Ref/note
      1. {{ref|foo}} no corpo do texto.
      2. # {{note|foo}} texto da nota no lugar apropriado na lista Notas.
    • Cite.php
      1. <ref>texto da nota</ref> no corpo do texto.
      2. (Somente necessário uma vez por artigo)<references/> sob o título das Notas.
  • Para fazer uma nota de rodapé de uso multiplo:
    • Ref/note
      • Com o rigoroso estilo ref/note, isso era impossível, mas uma série de formas alternativas tinham sido criadas, para cujos detalhes, consulte as páginas apropriadas.
    • Cite.php
      1. <ref name=foo>texto da nota</ref> em cada lugar no corpo do texto.
        1. Alternativamente <ref name=foo /> Uma tag de fechamento automático em cada uso após name=foo foi definida.
      2. (Somente necessário uma vez por artigo)<references/> sob o título das Notas; exatamente o mesmo como ao fazer uma nota de uso único.


Outros idiomas: English  • Deutsch • español • français • magyar • italiano • 日本語 • 한국어 • Nederlands • português • português do Brasil