Citoid/Abilitare Citoid sulla tua wiki
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ù "Cita" elencherà uno o più template di citazione della wiki, in aggiunta a "Base" e "Riusa". 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!
Step 2.a: Check your wiki has citation templates
If your local wiki has citation templates, proceed to step 2.b. If it does not, you'll need to create or import some first.
Passaggio 2.a: Creare una mappa di valori 'citoid' per ogni template di citazione
[]
oppure un 2D Array [[]]
nella mappa citoid. Special:MyLanguage/Citoid/Maps TemplateData#Available fields and field structure/Più dettagli
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.
If you prefer using wikitext, edit <templatedata />
(usually inside a /doc
or /TemplateData
subpage) and add the citoid
mapping in the maps
object:
{
"description": "…",
"params": {…},
"paramOrder": […],
"maps": {
"citoid": {
…,
"publicationTitle": "journal",
…
}
},
"format": "{{_ |_=_}}"
}
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.
If you recently created TemplateData for your wiki by copying it from English Wikipedia, it probably already includes the Citoid maps.
However if the TemplateData is too old, it may not contain it.
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
.
This message maps the 34 native Citoid types (artwork
, book
, journalArticle
, tvBroadcast
, website
, 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.
Non siamo riusciti a creare una citazione per te.
If this message occurs for every or most citations, then you may be trying to insert citation templates that have no maps data. Check your browser console as you will see a warning with the name of the template if this is the case. 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. Also ensure that blank template data on the template page itself isn't over-writing the template data from a transcluded documentation page. If that doesn't work, then there may be an issue with the map itself. Note that if this error occurs inconsistently, then there may just be a problem with the particular url you're trying to cite. To check this, try citing the url from the API. If it doesn't work there either, it is not a config issue.
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 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