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

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

Citoid è scomparso dal mio wiki
Please report any outage on Phabricator, and see that task for a temporary workaround.

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

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 currently in English. See T132308.

Many language wiki templates (pl, it, en) don't accept xx-XX style language codes
See T115326 for the related task. See the thread at T97256 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