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. To enable the tool, you'll need the following: a working installation of VisualEditor and Parsoid, citation templates on your wiki that use TemplateData to specify how they are invoked, and a special  message in order to hook VisualEditor and the templates together.

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.

Vse Wikipedije in ostali WMF wikiji so vse to že instalirali.
 * 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.
 * 1) 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. Recent versions of these templates at the English Wikipedia and some others also require the supporting Lua modules.
 * 2) 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. Copy the code to your wiki and adapt the names to the local context.

"Citation needed" tool
"Citation needed" templates can be configured to show an "Add a citation" button in the editor by configuring  with a   key.

The configuration value lists templates (which can contain multiple titles for redirects) and parameter mappings (currently supported keys are  and  ). The value of these mappings is the name of the parameters in the local template:

See the example definition on English Wikipedia.

Odpravljanje napak
Če greste na Posebno:Različica in imate inštaliran TemplateData, polja pa se neprikazujejo v pogovornem oknu za navajanje, boste mogoče morali odpreti v urejevalskem načinu predlogo za navajanje, nič spremeniti,in jo ponovno shraniti. Ta problem je nastal zaradi hrošča kjer se TemplateData, ki je vključen (tj. vključena v Predloga:Navedi_splet/dok in ne direktno v Predloga:Navedi_splet), ne naloži v bazo podatkov dokler se ne uredi starševska predloga; glejte.

Bodite pozorni na to, da se bo uporabniška izkušnja na vašem wikiju rahlo razlikovala ob uporabi vaših lastnih predlog kot standardnih 4. Na primer, seznam polj se ne bo privzeto prikazal ob startu pogovornega okna za navajanje, lahko pa boste dosegali seznam vseh obstoječih polj s klikom na gumb.