VisualEditor/Citation tool/it

Lo strumento citazioni di VisualEditor permete agli utenti di utilizzare i template di citazione della tua wiki all'interno di VisualEditor. Per abilitare lo strumento, ti servono i seguenti: un'installazione funzionante di VisualEditor e Parsoid, template di citazione sulla tua wiki che utilizzano TemplateData per specificare come devono essere invocati e uno speciale messaggio .json per agganciare VisualEditor e i template.

Importare i template citazione
Ti serviranno i template citazione nel database della tua wiki, per utilizzare una qualsiasi funzionalità delle citazioni. Se al momento non hai template citazione nella tua wiki (per esempio nel caso di una nuova installazione) dovrai aggiungerli. Copiarli da un'altra Wikipedia è il modo più facile per farlo. Se hai già i template citazione sulla tua wiki, puoi saltare questi passaggi.

e Extension:TemplateData. La maggior parte dei template citazione su Wikipedia utilizza il linguaggio di programmazione Lua reso disponibile sa Cribunto, e utilizzano l'estensione funzioni parser. L'estensione Cita ti per utilizzare i tag.
 * 1) Installa Extension:Scribunto, Extension:ParserFunctions, Extension:Cite
 * 1) Esporta template citazione da Wikipedia: Manual:Using_content_from_Wikipedia. Esportare Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book è una buona partenza.
 * 2) Carica i template utilizzando la pagina Special:Import sulla tua wiki (per esempio: http://localhost/index.php/Special:Import)

Template data
Ti servirà Extension:TemplateData per far sì che lo strumento di citazione sia in grado di caricare i dati del TemplateData in VisualEditor e ogni template deve avere il proprio TemplateData compilato. Per maggiori informazioni su come definire i TemplateData per le citazioni e per vedere immagini su come una finestra di citazione dovrebbe essere con e senza TemplateData, vedi: Wikipedia:VisualEditor/TemplateData

Definizione dello strumento citazione
Per abilitare lo strumento citazione VisualEditor sulla tua Wiki, devi creare un messaggio speciale sulla tua wiki:. Questo perché ogni wiki è differente e quindi necessita la personalizzazione delle funzionalità che si vogliono utilizzare; per esempio, i nome dei template utilizzati nella tua wiki potrebbero essere differenti da quelli di wiki in altre versioni linguistiche.

Scopo del messaggio di configurazione
Il messaggio:

Una volta che il messaggio di configurazione  è creato, lo strumento citazione sarà disponibile per tutti gli utenti VisualEditor sulla tua wiki in pochi minuti.
 * Informa quali template utilizza la tua wiki per le citazioni standard (puoi nominarne fino a 5).
 * Nota che ogni template deve avere il proprio TemplateData definito o il sistema sarà molto difficile per gli utenti da comprendere. Se la tua wiki non utilizza correntemente i template citazione, è pratica comune copiare i template dalla WIkipedia in inglese.
 * Indica quali etichette vorresti utilizzare per ogni tipo di citazione.
 * Ci sono quattro nomi standard, "web", "book", "news" e "journal" che corrispondono a  "ecc."
 * Indica quale icona vorresti utilizzare per ogni tipo di citazione.
 * Ce ne sono quattro standard, "ref-cite-web", "ref-cite-book", "ref-cite-news" e "ref-cite-journal", che corrispondono alle classi CSS con l'icona come un'immagine di sfondo SVG chiamata  "ecc."

Ulteriori tipi
Se stai pensando di aggiungere ulteriori tipi di citazione, il team di sviluppo preferirebbe prima parlarne con te, darti consigli, creare un'icona appropriata e così può anche essere presa in considerazione la possibilità che anche altre wiki possano volere quel tipo di citazione.

Per aggiungere un ulteriore tipo, dovrai:


 * 1) Decidere quale tipo creare
 * 2) * In questo esempio, supponiamo che volessi aggiungere una citazione per un database che potresti chiamare tipo database.
 * 3) Crea un'etichetta
 * 4) * Per esempio, potresti creare l'etichetta db e aggiungere l'etichetta  con il valore database. Questo dovrebbe essere indicato nella lingua utilizzata dalla tua wiki. Se la tua wiki utilizza più di una lingua o più di un alfabeto, dovrai creare molte etichette.
 * 5) Crea un'icona
 * 6) * Per esempio, potresti creare l'icona etichetta "ref-cite-dbase" e creare un file SVG caricato su commons, creare la classe icona " " nel  e aggiungere l'incona che vuoi con un " " o simile.

Esempi
You can see example definition messages on the English Wikipedia and the Polish Wikipedia.

Troubleshooting
If you navigate to Special:Version and TemplateData is installed, but fields aren't showing up in the citation dialog, you may need to open the citation template for editing, make no changes, and save it again. This is due to a bug where TemplateData which is transcluded (i.e. present in Template:Cite_web/doc instead of directly on Template:Cite_web) is not loaded into the database until the parent template is edited; see.

Please note that the user experience will differ slightly when using your own templates other than the standard 4. For instance, a list of fields won't show up initially in the citation dialog, but you will be able to request a list of all possible fields by clicking a button.