Citoid/Enabling Citoid on your wiki/sv

Citoid är en automatiskt ifylld källgenerator som automatiskt skapar källmallar baserade på URLer eller en akademisk referenskod såsom DOIs, PMIDs eler PMCIDs. Stöd för ISBN har planerats. Den finns i nuläget som en funktion i VisualEditor men kommer i framtiden att vara tillgänglig i wikitextredigeraren. Citoid använder Zotero-översättare för att konvertera en sidlänk till detaljerad information.

Steg 1: Aktivera källmallsverktyget
Citoid-servicen använder källverktyget i VisualEditor. Detta är redan aktiverat på de flesta stora Wikipedias och många mindre projekt. Om källverktyget är aktiverat kommer ""-menyn att lista en eller flera lokala källmallar utöver "" och "". Om källverktyget inte är aktiverat måste du aktivera det innan du fortsätter. Varje källmall måste ha normal MallData för att fungera.

Steg 2: Konfigurera Citoid
Utökningen Citoid måste konfigureras med hjälp av speciella MallData-kartor och en speciell Citoid-specifik sida. Det är viktigt att utföra dessa två steg i ordning!

Steg 2.a: Skapa 'Citoid'-kartors värden för varje källmall
Då Citoid har sina egna parametrar för varje dokumenttyp (t.ex. kallas tidningens namn 'publicationTitle' i Citoid, men tidning i Mall:tidningsref) måste du lägga till speciell MallData för Citoid. Denna speciella MallData skapar en karta mellan parametrar i Citoid och mallparametrar. Om du kallar kartan 'Citoid' kommer utökningen att veta vilken karta att använda. Du kan ha ett obegränsat antal kartor med unika nycklar. Notera att du endast kan se MallData-kartor i redigeringsläge - de syns inte i MallDatatabellen.

De färskaste kartorna som är kompatibla med Citoid finns på betaversionen av Wikipedia:
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_news/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_journal/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_web/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_book/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Citation/doc

Steg 2.b: Konfigurera en speciell MediaWikisida
Du måste konfigurera en speciell MediaWiki: namnrymdssida, MediaWiki:Citoid-template-type-map.json. Denna sida mappar de interna Citoidtyperna (webbplats, bok, tidningsartikel) till lämplig mall (webbref, bokref, tidningsref).

Du bör matcha en lokal källmall till varje Citoidtyp. Om ingen mall finns kommer inte Citoid att fungera. Det är bättre att ha en felaktig matchning än ingen alls. For example, your wiki may not have a special template for citing the liner notes in the packaging for a DVD, so consider using a template designed for a book or a video in that case. You may consider using a generic template, such as en.wiki's Template:Citation, as a catch-all for types if there is no good match for the type of source you are mapping.

A sample namespace message is found here: Citoid/MediaWiki:Citoid-template-type-map.json.

Troubleshooting

 * Main: Citoid

The new cite button does not appear in the toolbar
When you create the MediaWiki message in step 2.b, the previous cite drop-down menu (File:VisualEditor_-_Cite_Pulldown.png) should be replaced by a new button for the citoid service in the toolbar menu. If the new button does not appear in the toolbar, then there may be a problem with MediaWiki:Citoid-template-type-map.json. If this page does not exist locally, or if the JSON on that page is invalid, then citoid will not work. Alternatively, you may need to refresh your JavaScript cache.

Empty references appear
Empty references most commonly appear when you are trying to insert a citation template that has no maps data. This problem also appears if the template has maps data, but that data is not reaching the MediaWiki API. If the maps object is present in TemplateData block in the template's documentation, then try making a "null edit" on the template. If that doesn't work, then there may be an issue with the map itself.

My favourite site isn't recognised by Citoid and only gets basic information

 * Main: Citoid/Determining if a URL has a translator in Zotero

The Citoid service relies on the brilliant Zotero community for much of the "magic", as Zotero translators need to be written for each site. You can see a list of all Zotero translators at https://github.com/zotero/translators. Right now, Zotero best supports English-language sources. We need your help to improve coverage of other sites. You can write your own Zotero translator. Start by looking at an existing translator of a similar website, and by reading the general development framework instructions at https://www.zotero.org/support/dev/translators/framework.