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
Če razmišljate o dodajanju dodatnih tipov, bi se najprej ekipa razvijalcev rada pogovorila z vami, da vam da nasvete, da vam pomaga pri kreaciji ustrezne ikone. Na ta način lahko razmislimo o tem, če bi bil ta tip lahko na volju tudi drugim wikijem.

Za dodajanje dodatnega tipa morate narediti sledeče:


 * 1) Odločite se kateri tip želite ustvariti
 * 2) * V tem primeru, recimo da želite imeti sklic na podatkovno bazo, lahko svoj tip poimenujete "database".
 * 3) Zanj ustvarite oznako
 * 4) * Na primer, ustvarite lahko ime oznake "db" in oznako dodate v   z vrednostjo "database". To morate narediti na vašem wikiju. Če vaš wiki uporablja več jezikov ali skript, boste mogoče morali ustvariti več teh oznak.
 * 5) Zanj ustvarite ikono
 * 6) * Na primer, ustavrite lahko oznako ikone "ref-cite-dbase", in skreirate ikono kot SVG datoteko, ki jo naložite v Zbirko, skreirate razred ikone " " v   in dodate ikono, ki jo želite z " " in podobno.

Zgledi
Zgled definicije sporočil si lahko ogledate na angleški in poljski Wikipediji.

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