VisualEditor/Citation tool/eu

The VisualEditor citation tool allows users to use your wiki's citation templates from within VisualEditor. To enable the tool, you'll need the following: a working installation of VisualEditor and, citation templates on your wiki that use to specify how they are invoked, and a special   message in order to hook VisualEditor and the templates together.



Aipamen txantiloiak inportatu
You'll need citation templates in your wiki's database in order to use any citation features. If you do not currently have citation templates on your wiki (for example, in the case of a new installation) you'll need to get them. Copying them from Wikipedia is the easiest way to do this. If you already have citation templates on your wiki, you can skip these steps.

Most citation templates on Wikipedia use the programming language Lua which Scribunto makes available, and they also use the extension's parser functions. The Cite extension allows you to use the tags. All Wikipedias and other WMF wikis already have all of these things installed. Recent versions of these templates at the English Wikipedia and some others also require the supporting Lua modules.
 * 1) Instalatu Extension:Scribunto, Extension:ParserFunctions, Extension:Cite, eta Extension:TemplateData. Wikipediako aipamen txantiloi gehienak Lua programazio lengoaia erabiltzen dute, Scribuntok erabilgarri egiten duena; baita ere hedapenaren parser funtzioak erabiltzen dituzte. Cite hedapenak baimena ematen dute etiketak erabiltzeko.
 * 1) Export citation templates from Wikipedia: . Exporting w:Template:Cite web, w:Template:Cite news, w:Template:Cite journal, w:Template:Cite book is a good place to start.
 * 1) Igo zure txantiloiak Berezi hau  erabiliz: zure wikiko inportazio orria (adibidez, http://localhost/index.php/Special:Import)

Template data
You'll need for the citation tool to be able to load the template data into the fields in VisualEditor and each template must have template data defined. For more information on how to define template data for citations, and to see screenshots of how a citation window should look with and without template data defined, see: Wikipedia:VisualEditor/TemplateData



Aipamen-tresnaren definizioa
To enable the VisualEditor citation tool on your wiki, you need to create a special configuration message on your wiki:. This is because each wiki is different and so needs to customise which features it wants to use; for example, the names of the templates used on your wiki might be different from those of other wikis.

Purpose of the configuration message
Mezua:


 * Says which templates your wiki uses for standard citations (you can state up to 5).
 * Kontuan izan txantiloi bakoitzak TemplateData izan behar duela defined or the system will be very difficult for users to understand. If your wiki does not currently use citation templates, it is common to copy the templates from the English Wikipedia as a good general set.
 * Esan zein etiketa mota nahi duzun aipamen mota bakoitzeko.
 * Badira lau estandar, 'web', 'liburu', 'albisteak' eta 'egunkari',  eta abarri dagozkienak.
 * Says which icon you wish to use for each type of citation.
 * There are a standard four, "ref-cite-web", "ref-cite-book", "ref-cite-news" and "ref-cite-journal", which correspond to CSS classes with the icon as a background SVG image called  etc.

Once the  configuration message is created, the citation tool will be live for all VisualEditor users on your wiki within a few minutes.



Mota gehigarriak
If you are considering adding an additional type, the development team would really like to talk with you first, to give advice, help create an appropriate icon, and so we can consider whether other wikis might also want this type defined for all wikis.

Beste mota bat gehitu nahi baduzu, zera egin beharko duzu:


 * 1) Erabaki zein motakoa sortu nahi duzun
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Sortu etiketa bat horretarako
 * 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) Sortu ikono bat horretarako
 * 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.

Adibideak
You can see example definition messages on the English Wikipedia, Polish Wikipedia, French Wikipedia, Italian Wikipedia. Copy the code to your wiki and adapt the names to the local context.

Template type mapping
In addition to, you also need to create   to specify which types of citations map to which templates. You can see an example on the English Wikipedia.

"Citation needed" tool
"Citation needed" templates can be configured to show an "Add a citation" button in the editor by configuring  with a   key.

The configuration value lists templates (which can contain multiple titles for redirects) and parameter mappings. Currently supported keys are:
 * - shows the reason a citation is needed in the context item
 * - shows the date "citation needed" template was added in the context item
 * - text which has been wrapped by the template, and which should be unwrapped when a citation is added

The value of these mappings is the name of the parameter(s) in the local template:

See the example definition on English Wikipedia.

Arazoak konpondu
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.