VisualEditor/Citation tool/sl

VisualEditorjevo orodje za navajanje dovoljuje uporabnikom uporabljati vaše wiki predloge za navajanje znotraj VisualEditorja. Za omogočanje orodja, morate narediti sledeče: delujoča instalacija VisualEditorja in Parsoida, predloge za navajanje na vašem wikiju, ki za svoje delovanje uporabljajo TemplateData in posebno.json sporočilo, ki poveže skupaj VisualEditor in predlogo.

Uvažanje predlog za navajanje
V vaši bazi podatkov potrebujete vaše predloge, tako da lahko uporabljate katerokoli funkcijo navajanja. Če trenutno nimate predlog za navajanje na vašem wikiju (na primer, v primeru nove instalacije), jih boste morali narediti. To najlažje naredite tako, da jih skopirate iz Wikipedije. Če na vašem wikiju že imate predloge za navajane, te korake lahko preskočite.


 * 1) Inštlirajte Extension:Scribunto, Extension:ParserFunctions, Extension:Cite in Extension:TemplateData. Večina predlog za navajanje v Wikipediji uporablja programski jezik Lua, ki ga omogoča Scribunto, in prav tako uporabljajo razširitve parserskih funkcij. Razširitev Cite vam dovoljuje uporabo označevalcev.
 * 2) Izvozite predloge za navajanje iz wikipedije: Manual:Using_content_from_Wikipedia. Najbolje je, da začnete z izvozom Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book.
 * 3) Naložite vaše predloge z uporabo Posebno:Uvoz na vašem wikiju (na primer, http://localhost/index.php/Special:Import)

Template data
Da bo orodje za navajanje lahko naložilo podatke predloge v polja VisualEditorja boste potrebovali Extension:TemplateData, in vsaka predloga mora imeti definirane podatke predloge. Za več informacij kako definirati podatke predloge za navajanje in za zaslonske posnetke oken za navajanje (z in brez definiranih podatkov predloge), glejte: Wikipedija:VisualEditor/TemplateData

Definicija orodja za navajanje
Da na vašem wikiju omogočite VisualEditor orodje za navajanje, morate na vašem wikiju ustvariti posebno sporočilo:. To morate storiti zato, ker je vsak wiki drugačen in morate določiti katere funkcije želite uporabljati; na primer, imena predlog se lahko na vašem wikiju razlikujejo od drugih wikijev.

Namen konfiguracijskega sporočila
Sporočilo:

Ko ste skreirali  konfiguracijsko sporočilo, bo orodje za navajanje v nekaj minutah postalo delujoče za vse VisualEditor uporabnike na vašem wikiju.
 * Pove katere predloge vaša wiki uporablja za standardizirano navajanje (navedete lahko do 5 predlog).
 * Bodite pozorni, da mora vsaka predloga vsebovati TemplateData, drugače bo sistem za uporabnike težko razumljiv. Če vaša wiki trenutno ne vsebuje predlog za navajanje, je najbolje da jih skopirate iz angleške Wikipedije (kot osnovni nabor).
 * Pove katere oznake želite uporabiti za vsak tip navedka.
 * Obstajajo standardne štiri, "web", "book", "news" in "journal", ki ustrezajo  itd.
 * Pove katere ikone želite uporabiti pri vsakem tipu navedka.
 * Obstajajo standardne štiri, "ref-cite-web", "ref-cite-book", "ref-cite-news" in "ref-cite-journal", ki ustrezajo razredom CSS classes z ikono SVG slike ozadja imenovao  itd.

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

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