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 e 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 di valori 'citoid' per ogni template di citazione
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. This special mapping creates a map between Citoid's fields and the template's fields. 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. Nota inoltre che se hai recentemente creato TemplateData per la tua wiki copiandolo da un'altra wiki, probabilmente include già le mappe Citoid, quindi puoi saltare questo passaggio dopo averlo verificato. An unlimited number of maps with unique keys are allowed in the maps object. Note that you can only see TemplateData maps in edit mode; they are not visible in the TemplateData table. Also note that if you recently created TemplateData for your wiki by copying it from another wiki, it probably already includes the Citoid maps, so you can just skip this step after verifying.

Gli oggetti mappa più aggiornati che sono compatibili con l'estensione Citoid si trovano sulle versioni beta di Wikipedia.
 * w:Template:Cite news/doc
 * w:Template:Cite journal/doc
 * w:Template:Cite web/doc
 * w:Template:Cite book/TemplateData
 * w:Template:Citation/doc



Passaggio 2.b: Configurazione di un messaggio MediaWiki speciale
Dovrai configurare un MediaWiki: messaggio namespace speciale,. This message maps the 34 native Citoid types (, ,  ,  ,  , etc.) to the appropriate templates (Cite web, Cite book, Cite journal, etc.).

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

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

Risoluzione dei problemi


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. If the new button does not appear in the toolbar, then there may be a problem with 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 template. Se non funziona, allora potrebbe esserci un problema con la mappa stessa. If that doesn't work, then there may be an issue with the map itself.



Il mio sito preferito non è riconosciuto da Citoid e vengono recuperate solo le informazioni base
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. You can see a list of all Zotero translators at https://github.com/zotero/translators. Right now, Zotero best supports English-language sources. 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. You can write your own Zotero translator. Start by looking at an existing translator of a similar website, and by reading the tutorial at Citoid/Creating Zotero translators.



Le date sono formattate in modo diverso sulla mia wiki
Dates with full information (month, year, and day) are in ISO format, which is an international standard. If the community doesn't like the way this looks to the user, it is possible to edit the citation template to format the ISO dates to something that is standard in your language. For instance, you can add logic to the template such that if the date is detected to be in ISO yyyy-mm-dd format, the date is reformatted *to appear* to be dd/mm/yyyy on the page. However, if you do this, the underlying data (i.e. when you edit the wikitext, or the form in VisualEditor) will still remain the same.

Dates with only month and year are in also in ISO (YYYY-MM) but these are not accepted by some citation templates. See.

Many language wiki templates (pl, it, en) don't accept xx-XX style language codes
See for the related task. See the thread at to learn how different wikis decided to workaround this limitation.



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
 * Research:Citoid support for Wikimedia references
 * https://www.zotero.org/support/dev/translators/testing
 * Learn how to write a translator with Sebastian Karcher, Zotero (video, slides, links)
 * Lista di siti con i traduttori Zotero
 * Examples of different itemType URLs
 * James Forrester talks Citoid and Zotero at m:WikiCite 2017