VisualEditor/Citation tool/ca

L'eina de citació de l'EditorVisual permet als usuaris emprar les plantilles de citació del vostre wiki des de dintre de l'EditorVisual (VisualEditor). Per habilitar l'eina, us caldran aquests elements: una instal·lació en marxa de l'EditorVisual i Parsoid, plantilles de citació al vostre wiki que utilitzin TemplateData per especificar com s'invoquen i un missatge .json especial per enganxar l'EditorVisual amb les plantilles.

Importar les plantilles de citació
Per poder utilitzar les funcions de citació necessitareu tenir plantilles de citació a la base de dades del vostre wiki. Si actualment no en teniu (per exemple, perquè es tracta d'una instal·lació nova), les haureu d'obtenir. La manera més fàcil de fer-ho és copiar-les de la Wikipèdia. Si en canvi ja en teniu, podeu saltar-vos aquests passos.


 * 1) Instal·leu les extensions següents: Extension:Scribunto, Extension:ParserFunctions, Extension:Cite i Extension:TemplateData. La majoria de plantilles de citació de la Wikipèdia utilitzen el llenguatge de programació Lua proporcionat per Scribunto i també les funcions d'analitzador de l'extensió. L'extensió Cite us permet emprar les etiquetes tags.  Totes les Wikipèdies i els altres wikis de WMF ja tenen instal·lat tot això.
 * 2) Exporteu les plantilles de citació des de la Wikipèdia: Manual:Using_content_from_Wikipedia. Podeu començar exportant w:ca:Plantilla:Ref-web, w:ca:Plantilla:Ref-notícia, w:ca:Plantilla:Ref-publicació i w:ca:Plantilla:Ref-llibre. Les versions recents d'aquestes plantilles que hi ha a la Wikipèdia anglesa i d'altres també requereixen els mòduls Lua suplementaris.
 * 3) Pugeu les plantilles mitjançant la pàgina Special:Import del vostre wiki (per exemple, http://localhost/index.php/Special:Import).

Dades de plantilla
Perquè l'eina de citació pugui pujar les dades de plantilla als camps de l'EditorVisual, necessitareu l' Extension:TemplateData i que cada plantilla tingui definides les dades de plantilla. Si voleu més informació sobre com es defineixen les dades de plantilla per a les citacions i veure captures de pantalla de l'aspecte que ha de tenir una finestra de citació amb les dades de plantilla definides i sense, mireu Wikipedia:VisualEditor/TemplateData.

Definició de l'eina de citació
Per habilitar l'eina de citació de l'EditorVisual al vostre wiki, heu de crear un missatge especial al vostre wiki:. El motiu és que cada wiki és diferent i per tant necessita personalitzar quines característiques vol utilitzar; per exemple, els noms de les plantilles emprades en el vostre wiki podrien ser diferents dels d'altres wikis.

Propòsit del missatge de configuració
The message:

Once the  configuration message is created, the citation tool will be live for all VisualEditor users on your wiki within a few minutes.
 * Says which templates your wiki uses for standard citations (you can state up to 5).
 * Note that each template must have TemplateData 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.
 * Says which label you wish to use for each type of citation.
 * There are a standard four, "web", "book", "news" and "journal", which correspond to  etc.
 * 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.

Additional types
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.

To add an additional type, you will need to:


 * 1) Decide what type you wish to create
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Create a label for it
 * 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) Create an icon for it
 * 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.

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

Troubleshooting
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.