VisualEditor/Citation tool/pt-br

A ferramenta de citações do Editor Visual permite a usuários utilizar as predefinições de citação de sua wiki através do Editor Visual. Para ativá-la, você deverá fazer o seguinte: uma instalação válida do Editor Visual e Parsoid, predefinições de citação na sua wiki que usam TemplateData para especificar como serão invocados, e uma mensagem .json especial a fim de unir o Editor Visual às predefinições.

Importação de predefinições de citação
Você precisará de predefinições de citação na base de dados da sua wiki para que você possa usar qualquer funcionalidade para citações. Caso você não tenha atualmente predefinições de citação em sua wiki (por exemplo, no caso de uma instalação nova), deverá obtê-las. Copiá-las da Wikipédia é o jeito mais fácil para fazer isso. Caso você já tenha predefinições desse tipo em sua wiki, poderá pular estas etapas.


 * 1) Instale Extension:Scribunto, Extension:ParserFunctions, Extension:Cite, e Extension:TemplateData. A maioria das predefinições de citação da Wikipédia usam a linguagem Lua, a qual Scribunto torna disponível, e elas também usam as funções de parsing da extensão. A extensão Cite permite-lhe usar as tags.
 * 2) Exporte predefinições de citação da Wikipédia: Manual:Using_content_from_Wikipedia. Exportar Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book é uma boa maneira de começar.
 * 3) Envie suas predefinições utilizando a página Special:Import de sua wiki (por exemplo, http://localhost/index.php/Special:Import)

Dados da predefinição
Você precisará de Extension:TemplateData para que a ferramenta de citações possa carregar dados de predefinição dentro dos campos do Editor Visual, e cada predefinição deve ter dados definidos. Para mais informações sobre como definir dados de predefinição para citações, e para ver capturas de tela de como uma janela de citação deve aparentar com ou sem dados definidos, veja: Wikipédia:Editor Visual/TemplateData

Definição da ferramenta de citações
Para habilitar a ferramenta de citações do Editor Visual em sua wiki, precisa criar uma mensagem especial em sua wiki:. Isto se deve ao fato de que cada wiki é diferente, e por isso se precisa definir quais funcionalidades ela deseja usar; por exemplo, os nomes das predefinições usadas na sua wiki podem ser diferentes dos de outras wikis.

Objetivo da mensagem de configuração
A mensagem:

Uma vez que a mensagem de configuração  é criada, a ferramenta de citações será publicada a todos os usuários de Editor Visual em sua wiki dentro de alguns minutos.
 * Diz quais predefinições sua wiki utiliza para citações-padrão (você pode definir até 5).
 * Note que cada predefinição deve ter TemplateData definido ou o sistema não poderá ser facilmente entendido pelos usuários. Se sua wiki não usa atualmente predefinições de citação, é comum copiá-las da Wikipédia em inglês como um bom conjunto geral.
 * Diz qual etiqueta você quer usar a cada tipo de citação.
 * Há quatro etiquetas-padrão, "web", "book" (livro), "news" (notícias) e "journal" (jornal), que correspondem a  etc.
 * Diz qual ícone você quer usar a cada tipo de citação.
 * Há quatro ícones-padrão, "ref-cite-web", "ref-cite-book", "ref-cite-news" e "ref-cite-journal", que correspondem às classes CSS que possuem o ícone como uma imagem de fundo SVG chamada  etc.

Tipos adicionais
Se você considera adicionar um tipo de citação adicional, a equipe de desenvolvimento gostaria muito de falar com você primeiro, para lhe dar alguns conselhos e ajudá-lo a criar um ícone apropriado, e então poderemos considerar se outras wikis podem também querer esse tipo de citação definido a todas as wikis.

Para adicionar um tipo de citação adicional, você deverá:


 * 1) Decidir que tipo você deseja criar
 * 2) * Neste exemplo, digamos que você queira ter uma referência a um banco de dados, e então você chamaria o tipo de database.
 * 3) Criar uma etiqueta para isso
 * 4) * For the example, you could make the label name "db" and add a label at   with the value "database". This should be in your wiki's content language. If your wiki uses multiple languages or scripts, you may need to create several of these labels.
 * 5) Crie um ícone para isso
 * 6) * For the example, you could make the icon label "ref-cite-dbase", and create the icon as an SVG file uploaded to commons, create the icon class " " in  and add the icon you want with " " or similar.

Exemplos
You can see example definition messages on the English Wikipedia and the Polish Wikipedia.

Solução de problemas
If you navigate to Special:Version and TemplateData is installed, but fields aren't showing up in the citation dialog, you may need to open the citation template for editing, make no changes, and save it again. This is due to a bug where TemplateData which is transcluded (i.e. present in Template:Cite_web/doc instead of directly on Template:Cite_web) is not loaded into the database until the parent template is edited; see.

Please note that the user experience will differ slightly when using your own templates other than the standard 4. For instance, a list of fields won't show up initially in the citation dialog, but you will be able to request a list of all possible fields by clicking a button.