Citoid/Enabling Citoid on your wiki/it

Citoid è un generatore di citazioni pre-compilate che crea automaticamente un template citazione da una risorsa online, basandosi su un URL o su alcuni identificatori accademici come DOI, PMID, PMCID. È stata pianificata l'aggiunta del supporto ISBN. È attualmente disponibile come funzionalità di VisualEditor, ma in futuro sarà disponibile anche per l'editor tradizionale di wikitesto. Citoid utilizza i traduttori Zotero per convertire il link di una pagina in informazioni dettagliate.

Passaggio 1: Abilitare lo strumento template citazione
Il servizio Citoid utilizza lo strumento citazione di VisualEditor. Questo è già abilitato sulle Wikipedia più grandi e su altri progetti più piccoli. Se lo strumento citazione è abilitato, il menù "" elencherà uno o più template di citazione della wiki, in aggiunta a "" e "". Se lo strumento citazione non è abilitato, dovrai abilitarlo prima di procedere. Ogni template di citazione richiede una tabella TemplateData per funzionare.

Passaggio 2: Configurare Citoid
L'estensione Citoid deve essere configurata utilizzando delle speciali mappe TemplateData e un messaggio Citoid-specifico. È importante fare questi passaggi nell'ordine corretto!

Passaggio 2.a: Creare una mappa valori 'Citoid' per ogni template Cita
Siccome Citoid ha il proprio set di campi per ogni tipo di documenti (per esempio, il nome del quitidiano è chiamato 'publicationTitle' in Citoid, ma 'journal' in Template:Cite_journal), è necessario aggiungere TemplateData speciali per Citoid. Il TemplateData speciale crea una mappa tra i campi Citoid e campi template. Chiamare la mappa 'Citoid' permette all'estensione Citoid di sapere quale mappa cercare. È permesso un numero infinito di mappe con chiavi uniche. Nota che puoi solamente vedere la mappa TemplateData in modalità di modifica; non sono visibili nella tabella TemplateData.

Gli oggetti mappa più aggiornati che sono compatibili con l'estensione Citoid si trovano sulle versioni beta di 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

Passaggio 2.b: Configurazione di un messaggio MediaWiki speciale
Dovrai configurare un MediaWiki: messaggio namespace speciale, MediaWiki:Citoid-template-type-map.json. Questo messaggio mappa i tipi Citoid nativi (website, book, journalArticle) al template appropriato (Cite web, Cite book, Cite journal).

Dovresti far corrispondere il template citazione locale ad ogni singolo tipo Citoid. Se nessun template viene fatto corrispondere, Citoid non funzionerà. È meglio avere una corrispondenza sbagliata che non averla affatto. Per esempio, potresti non avere un template speciale per citare le note riportate sulla custodia di un DVD, quindi potresti utilizzare un template creato per un libro o un video in quel caso. Potresti utilizzare un template generico, come Template:Citation di en.wiki, come template da collegare a tutti quei tupi che non hanno una corrispondenza corretta per il tipo di risorsa che stai mappando.

Un messaggio di esempio si può vedere in Citoid/MediaWiki:Citoid-template-type-map.json.

Risoluzione dei problemi

 * Principale: 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.