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:

Once the  configuration message is created, the citation tool will be live for all VisualEditor users on your wiki within a few minutes.
 * 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.
 * Says which label you wish to use for each type of citation.
 * There are a standard four, "web", "book", "news" and "journal", which correspond to  etc.
 * Says which icon you wish to use for each type of citation.
 * There are a standard four, "ref-cite-web", "ref-cite-book", "ref-cite-news" and "ref-cite-journal", which correspond to CSS classes with the icon as a background SVG image called  etc.

Additional types
If you are considering adding an additional type, the development team would really like to talk with you first, to give advice, help create an appropriate icon, and so we can consider whether other wikis might also want this type defined for all wikis.

To add an additional type, you will need to:


 * 1) Decide what type you wish to create
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Create a label for it
 * 4) * For the example, you could make the label name "db" and add a label at   with the value "database". This should be in your wiki's content language. If your wiki uses multiple languages or scripts, you may need to create several of these labels.
 * 5) Create an icon for it
 * 6) * For the example, you could make the icon label "ref-cite-dbase", and create the icon as an SVG file uploaded to commons, create the icon class " " in  and add the icon you want with " " or similar.

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.