Citoid/Enabling Citoid on your wiki/nl

Citoid is een automatisch gevulde generator voor het citeren die automatisch een sjabloon daarvoor aanmaakt van online bronnen gebaseerd op een URL en enkele academische referentie identifiers zoals DOIs, PMIDs, PMCIDs en ISBNs. Het is nu beschikbaar als een VisualEditor functie, en in de. Citoid gebruikt vertalingen door Zotero om een pagina link om te zetten in gedetailleerde informatie.







Stap 1: Het hulpmiddel citation inschakelen
De service Citoid gebruikt het hulpmiddel VisualEditor's Citation. Dit is al ingeschakeld op de meeste grote Wikipedia's en veel kleinere projecten. Als het is ingeschakeld dan zal het menu "" een of meer lokale sjablonen voor het citeren tonen als aanvulling op de "" en "". Als het niet is ingeschakeld dan moet u het eerst inschakelen, door de stappen in Citation hulpmiddel definitie te doorlopen. Een dergelijk sjabloon heeft de normale TemplateData nodig om te kunnen werken.



Stap 2: Citoid configureren
De extensie Citoid moet zijn geconfigureerd met gebruik van speciale TemplateData kaarten en een speciaal Citoid-specifiek bericht. Doe deze twee stappen in deze volgorde!



Stap 2.a: Maak een 'citoid' kaartwaarde aan voor elk 'citation' sjabloon
Omdat Citoid een eigen set velden heeft per documenttype (bijvoorbeeld 'journal' is 'publicationTitle' in Citoid, maar 'journal' in Template:Cite_journal), is er een koppeling nodig, genaamd 'citoid' in het  object van de TemplateData per citeer sjabloon. Deze koppeling is een verbinding tussen de velden in Citoid en de velden in het sjabloon. Deze 'map' moet de naam 'citoid' hebben, zodat de extensie Citoid ze kan vinden. Er is geen beperking van het aantal maps met unieke keys in het maps object. U kunt TemplateData maps alleen in de bewerkmode zien; ze staan niet zichtbaar in de tabel TemplateData. Als u recent TemplateData voor uw wiki heeft aangemaakt door het van een andere wiki te kopiëren dan bevat het waarschijnlijk Citoid maps, u kunt dan deze stap na het controleren overslaan.

De meeste actuele map objecten die compatibel zijn met de Citoid extensie zijn op de Engelse Wikipedia:
 * w:Template:Cite news/doc
 * w:Template:Cite journal/doc
 * w:Template:Cite web/doc
 * w:Template:Cite book/TemplateData
 * w:Template:Citation/doc



Stap 2.b: Speciaal MediaWiki bericht configureren
U dient een speciaal MediaWiki: namespace bericht te configureren,. Dit bericht koppelt de 34 interne Citoid types (, ,  ,  ,  , ...) aan de goede sjablonen (Cite web, Cite book, Cite journal, ...).

Er dient een lokaal sjabloon aan elk Citoid-type te worden gekoppeld, anders werkt Citoid niet. Een slechte match is beter dan geen match. Uw wiki kan bijvoorbeeld geen speciaal sjabloon hebben voor regelnotities op het hoesje van een DVD, gebruik daar dan maar een sjabloon voor een boek of een video voor. U kunt ook een algemeen sjabloon overwegen zoals en.wiki's Template:Citation, iets dan voor alle types dient waar geen maatwerk sjabloon voor is.

Een voorbeeld staat op de Engelse Wikipedia: https://en.wikipedia.org/wiki/MediaWiki:Citoid-template-type-map.json.

Probleemoplossing


Citoid is van mijn wiki verdwenen
U kunt een storing melden op Phabricator, daar ziet u ook een tijdelijke oplossing.



De nieuwe knop cite wordt niet in de werkbalk getoond


Als u het MediaWiki bericht in stap 2.b aanmaakt, moet het vorige cite dropdown menu (File:VisualEditor_-_Cite_Pulldown.png) worden vervangen door een nieuwe knop voor de citoid service in het menu in de werkbalk. Als de nieuwe knop niet in de werkbalk komt te staan kan er een probleem zijn met het bestand MediaWiki:Citoid-template-type-map.json. Als deze pagina lokaal niet bestaat of als de JSON op die pagina ongeldig is, dan zal citoid niet werken. Mogelijk moet u uw JavaScript cache verversen.



Er worden lege referenties getoond
Een lege referentie wordt meestal veroorzaakt bij het proberen een sjabloon voor citeren in te voegen dat geen koppelingsgegevens bevat. Het kan ook optreden als die gegevens er wel zijn maar de gegevens niet bij de MediaWiki API terecht komen. Als het object maps aanwezig is in het blok TemplateData in de documentatie van het sjabloon, probeer dan een "wijziging zonder aanpassing" te doen van het sjabloon. Dus inlezen sjabloon in editor en zonder wijziging opslaan. Als dat niet helpt kan er een probleem zijn met de koppelingen zelf.



Mijn favoriete site wordt niet door Citoid herkend en bevat alleen basisinformatie
De Citoid service vertrouwt op de briljante Zotero gemeenschap voor het meeste van de "magie van Citiod", er moeten Zotero vertalers geschreven zijn voor elke site. U lijst met Zotero vertalers: https://github.com/zotero/translators. Op dit moment ondersteunt Zotero het beste Engelstalige bronnen. U kunnen uw hulp gebruiken bij een betere dekking van andere sites. U kunt uw eigen Zotero vertaler schrijven. Begin met het zoeken naar een bestaande vertaler op een vergelijkbare website en door het lezen van deze handleiding (tutorial).



Het formaat van de datums wijkt af van dat op mijn wiki
Datums zijn in het ISO formaat, dat is een internationale standaard. Als uw gemeenschap een ander formaat wilt hebben, dan kunt u het citation sjabloon bewerken om dit ISO datumformaat aan te passen naar de standaard in uw taal. U kunt bijvoorbeeld het sjabloon een datum die in het ISO yyyy-mm-dd formaat is, laten omzetten in een weergave op de pagina in het formaat dd/mm/yyyy. De onderliggende datum (bijvoorbeeld bij het wijzigen van de wikitext of in de VisualEditor) blijft echter hetzelfde.

Datum met alleen een maand en jaar zijn in het formaat ISO (YYYY-MM) maar dit formaat wordt niet door alle sjablonen voor citeren geaccepteerd. Zie.



Veel taal sjablonen (pl, it, en) accepteren geen xx-XX stijl taalcodes
Zie voor de gerelateerde taak. In dit draadje staat beschreven hoe de verschillende wiki's met deze 'beperking' hebben besloten om te gaan.



Zie ook

 * Zotero handleiding
 * Zotero translation server -- xpcshell-based Zotero vertaalserver en zotero-node, een niet meer ondersteunde versie met nodejs
 * Geldige veldnamen per itemtype
 * Zotero veldkoppelingen
 * Citoid ondersteuning voor Wikimedia referenties
 * https://www.zotero.org/support/dev/translators/testing
 * Leer een vertaler te maken door Sebastian Karcher, Zotero (video, dia's, links)
 * Lijst van websites met Zotero vertalers
 * Voorbeelden met verschillende itemType URL's
 * James Forrester talks Citoid and Zotero at m:WikiCite 2017