Jump to content

Citoid/Citoid inschakelen op uw wiki

From mediawiki.org
This page is a translated version of the page Citoid/Enabling Citoid on your wiki and the translation is 100% complete.
Languages:
Belangrijkste pagina: Citoid

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 2017 wikitext editor . Citoid gebruikt vertalingen door Zotero om een pagina link om te zetten in gedetailleerde informatie.

Stap 1: Het hulpmiddel citation template 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 "Referentie" een of meer lokale sjablonen voor het citeren tonen als aanvulling op de "Eenvoudige" en "Hergebruiken". 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: Controleer of uw wiki citatiesjablonen heeft

Als uw lokale wiki citatiesjablonen heeft, ga dan verder naar stap 2.b. Als dit niet het geval is, moet u er eerst een of meer maken of importeren .

Stap 2.b: Maak een 'citoid' kaartwaarde aan voor elk 'citation' sjabloon 

Belangrijkste pagina: Citoid/Maps TemplateData
De velden ISSN, ISBN, author, editor, ... zijn speciale velden die ook Arrays [] of 2D Arrays [[]] kunnen zijn. Meer details
Click on the "Verwijzingen bewerken" button in the TemplateData editor to add or edit the citoid map JSON.

Omdat Citoid een eigen set velden heeft per documenttype (bijvoorbeeld de journaalnaam is publicationTitle in Citoid, maar journal in w:Template:Cite journal), klik dan op "Nieuwe verwijzing" want er is een koppeling nodig, genaamd citoid in TemplateData van elk citatiesjabloon.

If you prefer using wikitext, edit ‎<templatedata /> (usually inside a /doc or /TemplateData subpage) and add the citoid mapping in the maps object: 

{
	"description": "…",
	"params": {…},
	"paramOrder": […],
	"maps": {
		"citoid": {
			…,
			"publicationTitle": "journal",
			…
		}
	},
	"format": "{{_ |_=_}}"
}

Deze koppeling is een verbinding tussen de velden in Citoid en de velden in het sjabloon. Deze kaart moet de naam citoid hebben, zodat de extensie Citoid ze kan vinden. Er is geen beperking van het aantal kaarten met unieke keys in het object maps. U kunt TemplateData kaarten 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 kaarten. Als de TemplateData echter te oud is, kan het deze niet bevatten.

De meeste actuele kaart objecten die compatibel zijn met de Citoid extensie zijn op de Engelse Wikipedia:

Stap 2.c: Speciaal MediaWiki bericht configureren

U dient een speciaal bericht in de interne MediaWiki namespace te configureren, MediaWiki:Citoid-template-type-map.json. Dit bericht koppelt de 34 interne Citoid types (artwork, book, journalArticle, tvBroadcast, website, ...) 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: w:MediaWiki:Citoid-template-type-map.json

Probleemoplossing

Belangrijkste pagina: Citoid#Troubleshooting_Citoid_VisualEditor_Extension

De nieuwe knop cite wordt niet in de werkbalk getoond 

Werkbalk knop Citoid

Als u het MediaWiki bericht in stap 2.c 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.

Wij konden geen citaat voor u maken.

Als dit bericht voor alle of de meeste citaten voorkomt, probeert u misschien citatiesjablonen in te voeren die geen kaartgegevens hebben. Controleer uw browserconsole, want als dit het geval is, ziet u een waarschuwing met de naam van het sjabloon. 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. Zorg er ook voor dat de lege sjaloongegevens op de sjabloonpagina zelf niet de sjabloongegevens van een vertaalde documentatiepagina overschrijven. Als dat niet helpt kan er een probleem zijn met de kaart zelf. Let op dat als deze fout inconsistent voorkomt, dan kan er gewoon een probleem zijn met de specifieke URL die u probeert te citeren. To check this, try citing the url from the API. If it doesn't work there either, it is not a config issue.


Mijn favoriete site wordt niet door Citoid herkend en bevat alleen basisinformatie 

Belangrijkste pagina: Citoid/Determining if a URL has a translator in Zotero

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

Veel taal sjablonen (pl, it, en) accepteren geen xx-XX stijl taalcodes

Zie T115326 voor de gerelateerde taak. In dit draadje T97256 staat beschreven hoe de verschillende wiki's met deze 'beperking' hebben besloten om te gaan.

Zie ook

Retrieved from "https://www.mediawiki.org/w/index.php?title=Citoid/Enabling_Citoid_on_your_wiki/nl&oldid=7687824"