VisualEditor/Citation tool

To enable the VisualEditor citation tool on your wiki, you need to create a special 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 == The message : 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. Once the   configuration message is created, the citation tool will be live for all VisualEditor users on your wiki within a few minutes.

== 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: Decide what type you wish to create In this example, say you wished to have a database reference, you could call the type "database". Create a label for it 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. Create an icon for it 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 <tvar|link>" "</> or similar.

== Examples == You can see example definition messages on the en>:en:MediaWiki:Visualeditor-cite-tool-definition.json</>|English Wikipedia and the pl>:pl:MediaWiki:Visualeditor-cite-tool-definition.json</>|Polish Wikipedia.