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

Il nuovo pulsante cita non appare nella barra strumenti
Quando crei il messaggio MediaWiki come indicato nel passaggio 2.b, il precedente menù cita a tendina (File:VisualEditor_-_Cite_Pulldown.png) dovrebbe essere rimpiazzato dal pulsante per il servizio Citoid nel menù della barra strumenti. Se il nuovo bottone non appare nella barra strumenti, ci potrebbe essere un problema con MediaWiki:Citoid-template-type-map.json. Se questa pagina non esiste localmente, o se il JSON nella pagina non è valido, Citoid non funzionerà. Oppure, basta semplicemente pulire la tua cache JavaScript.

Appare una nota vuota
Le note vuote appaiono maggiormente quando tenti di inserire un template citazione che non ha una mappa dati. Questo problema si presenta anche quando il template ha una mappa dati, ma questa mappa non riesce a recuperare le MediaWiki API. Se l'oggetto mappa è presente nel blocco TemplateData nella documentazione del template, prova a fare un "null edit" nel tempalte. Se non funziona, allora potrebbe esserci un problema con la mappa stessa.

Il mio sito preferito non è riconosciuto da Citoid e vengono recuperate solo le informazioni base

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

Il servizio Citoid si basa sulla brillante community di Zotero per la maggior parte della "mogia", siccome le traduzioni vanno scritte per ogni sito. Puoi vedere una lista di tutte le traduzioni Zotero alla pagina https://github.com/zotero/translators. Al momento, Zotero supporta maggiormente le risorse in lingua inglese. Ci serve il tuo aiuto per migliorare la copertura di altri siti. Puoi scrivere tu stesso la traduzione Zotero. Comincia cercando una traduzione di un sito simile e leggi le istruzioni di sviluppo generali alla pagina https://www.zotero.org/support/dev/translators/framework.

Vedi anche

 * Tutorial Zotero
 * Zotero translation server -- server di traduzione Zotero xpcshell-based e Zotero-node, un equivalente, ma abbandonato, basato sui nodi
 * Nomi validi per i campi per ogni tipo di elemento
 * Zotero field mappings