VisualEditor/Citation tool/nl

Het hulpmiddel voor het citeren in de VisualEditor staat gebruikers toe om uw wiki's sjablonen voor het citeren te gebruiken in de VisualEditor. Om het hulpmiddel in te schakelen heeft u het volgende nodig: een werkende installatie van VisualEditor en, sjablonen op uw wiki voor het citeren die  gebruiken om aan te geven hoe ze aangeroepen worden en een speciaal   bericht om de hook VisualEditor en de sjablonen samen te koppelen.



Sjablonen voor het citeren importeren
U heeft sjablonen om te citeren in uw wiki's database nodig om de functies van het citeren te kunnen gebruiken. U kunt ze bijvoorbeeld bij een nieuwe installatie kopiëren van Wikipedia. Als u deze sjablonen al heeft, dan kunt u deze stappen overslaan.


 * 1) Installeer Scribunto, ParserFunctions, Cite en TemplateData. De meeste sjablonen om te citeren op Wikipedia gebruiken de programmeertaal Lua die  Scribunto beschikbaar maakt, ze gebruiken ook deextensie parserfuncties. Met de extensie Cite kunt u de tags  gebruiken.  Bij alle Wikipedia's en andere WMF wiki's zijn deze zaken al geïnstalleerd.
 * 2) Exporteer 'citation' sjablonen van Wikipedia: . Exporteer Cite web, Cite news, Cite hournal, Cite book is een goede plek om te starten. Recente versies van deze sjablonen op de Engelse en andere Wikipedia's hebben ook ondersteuning van Lua modules nodig.
 * 3) Upload de sjablonen via de Special:Import pagina op uw wiki (bijvoorbeeld: http://localhost/index.php/Special:Import).



Sjabloongegevens
U heeft Extension:TemplateData nodig voor het hulpmiddel om te citeren, het laadt de sjabloongegevens in de velden van VisualEditor. Van elk sjabloon moeten de sjabloongegevens zijn gedefinieerd. Hier staan voorbeelden van het scherm om te citeren met/zonder die gegevens en een uitleg: VisualEditor/TemplateData



Definitie hulpmiddel citeren
Om het hulpmiddel in te schakelen dient u een configuratie-bericht aan te maken:. Omdat elke wiki verschilt is er een configuratie van de functies van het hulpmiddel nodig. Zo kunnen de namen van de gebruikte sjablonen per wiki verschillen.



Doel van het bericht voor configuratie
Het configuratie-bericht:


 * Geeft aan welke (maximaal 5) sjablonen uw wiki gebruikt voor het citeren.
 * Elk sjabloon moet TemplateData hebben gedefinieerd, anders wordt het systeem moeilijker te begrijpen voor de gebruikers. Als uw systeem nog geen sjablonen gebruikt voor het citeren, dan worden meestal die van de Engelse Wikipedia gekopieerd.
 * Geeft per citaattype aan welk label u wenst te gebruiken.
 * Er zijn er standaard vier, "web", "boek", "nieuws" en "journaal", die overeenkomen met  enz.
 * Geeft per citaattype het icoon aan dat u wilt gebruiken.
 * 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.



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

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



Hulpmiddel "Citeren nodig"
"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.

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