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 "wijzigingen 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. Start by looking at an existing translator of a similar website, and by reading the tutorial at Citoid/Creating Zotero translators.



Het formaat van de datums wijkt af van dat op mijn wiki
Dates with full information (month, year, and day) are in ISO format, which is an international standard. If the community doesn't like the way this looks to the user, it is possible to edit the citation template to format the ISO dates to something that is standard in your language. For instance, you can add logic to the template such that if the date is detected to be in ISO yyyy-mm-dd format, the date is reformatted *to appear* to be dd/mm/yyyy on the page. However, if you do this, the underlying data (i.e. when you edit the wikitext, or the form in VisualEditor) will still remain the same.

Dates with only month and year are in also in ISO (YYYY-MM) but these are not accepted by some citation templates. Zie.



Veel taal sjablonen (pl, it, en) accepteren geen xx-XX stijl taalcodes
Zie voor de gerelateerde taak. See the thread at to learn how different wikis decided to workaround this limitation.



Zie ook

 * Zotero handleiding
 * Zotero translation server -- xpcshell-based Zotero translation server, and zotero-node, an abandoned nodejs equivalent
 * 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