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. Som exempel kanske din wiki inte har en mall för att källreferera extramaterial i DVDfodral, så överväg att använda en mall för böcker eller filmer i detta fall. Du kan använda en generisk mall såsom t.ex. engelskspråkiga wikis Template:Citation som en reservmall för typer där det inte finns en bra mall för den typ av källa du matchar.

Ett exempel på namnrymndssida finns här: Citoid/MediaWiki:Citoid-template-type-map.json.

Felsökning

 * Main: Citoid

Den nya källknappen syns inte i verktygsfältet
När du skapar MediaWikisidan i steg 2.b ska den föregående rullgardinsmenyn för källor (File:VisualEditor_-_Cite_Pulldown.png) ersättas av en ny knapp för Citoidservicen i verktygsfältet. Om den nya knappen inte syns kan ett problem med MediaWiki:Citoid-template-type-map.json föreligga. Om denna sida inte existerar lokalt, eller om JSON-koden på den sidan är felaktig, kommer Citoid inte att fungera. Du kan även behöva förnya din JavaScript cache.

Tomma referenser syns
Tomma referenser är vanligast när du försöker infoga en källmall som inte har någon karta. Detta problem dyker också up om mallen har karta, men datan når inte MediaWikis API. Om kartan finns i MallData-blocket i mallens dokumentation, försök då göra en "tom redigering" på mallen. Om det inte hjälper kan problemet ligga hos kartan.

Min favoritsajt erkänns inte av Citoid och jag får bara enkel information

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

Citoidservicen förlitar sig på den lysande Zoterogemenskapen för mycket av "magin" so Zoteroöversättare måste skrivas för varje webbplats. Du kan se en lista på alla Zoteroöversättare på https://github.com/zotero/translators. I nuläget fungerar Zotero bäst på engelskspråkiga källor. Vi behöver din hjälp med att förbättra täckningen av andra webbplatser. Du kan skriva din egen Zoteroöversättare. Börja med att titta på en befintlig översättare för en liknande webbplats, och läs instruktionerna för utvecklarramverket på https://www.zotero.org/support/dev/translators/framework.

Se även

 * Zoterohandledning
 * Zotero översättningsserver -- xpcshellbaserad Zotero översättningsserver och zoteronode, en övergiven ekvivalent till nodejs
 * Giltiga parameternamn för varje typ
 * Zotero parameterkartor