Ajuda:Eina per a referències

Vídeo de mostra d'ús de l'eina

RefToolbar és una eina per a facilitar la inserció de referències des de la caixa d'edició i citar-les en les pàgines de Viquipèdia mitjançant plantilles de referències. L'eina està escrita en JavaScript, instal·lada com a extensió del MediaWiki.

Versions

Hi ha dues versions, segons la configuració personal a Preferències → Caixa d'edició → Característiques beta: Habilita la barra d'edició

Habilita la barra d'edició	Versió	Mostra de la barra d'edició (en anglès)
	1.0	Icona "Cite" a la dreta
	2.0	Opció "Cita ref" a la dreta

Utilització

A continuació es descriu el format de la versió 2.0.

Plantilles

Barra d'edició

Després d'activar l'opció "Cita ref" en la barra d'edició, apareix una nova barra. A l'esquerra hi ha un menú desplegable amb les diferents plantilles disponibles segons el tipus d'obra de referència.

Caixa de diàleg

En escollir-ne una s'obre una caixa de diàleg amb un formulari pels camps d'aquesta plantilla. Els botons al final de la caixa són per inserir la referència a l'article, mostrar més camps opcionals, previsualitzar la referència, cancel·lar el formulari o reiniciar-lo. Clicant la icona afegirà la data actual en el camp adjacent. Clicant la icona intentarà completar els camps a partir de l'identificador proporcionat: ISBN, DOI o PMID.

Referències amb nom donat

Clicant la icona de l'opció "Referència amb nom donat" s'obrirà una caixa de diàleg mostrant totes les referències de l'article que tenen un nom donat. Escollint-ne una mostrarà el text wiki de la referència amb l'opció de previsualitzar-la. Amb el botó "Insereix" afegirà la referència amb el seu nom (<ref name=Nom />) en la darrera posició del cursor a l'article.

Comprovació d'errors

Per a comprovar si hi ha errors en les referències de l'article, cliqueu la icona de l'opció "Comprova errors" i seleccioneu el tipus d'error a comprovar. El resultat de la comprovació es mostrarà en una nova caixa sota del camp "Resum" de la caixa d'edició.

Notes tècniques

L'eina es pot desactivar a Preferències → Ginys → Ginys d'edició → refToolbar

Scripts relacionats:

• MediaWiki:Gadget-refToolbar.js, giny que activa la versió corresponent a la configuració personal.
  • MediaWiki:RefToolbarLegacy.js, versió 1.0
  • en:MediaWiki:RefToolbar.js, versió 2.0
    • MediaWiki:RefToolbarConfig.js, configuració del formulari
    • MediaWiki:RefToolbarMessages-en.js, traducció dels missatges en català (per un problema de configuració provisionalment estan posats en la versió en anglès que surt per defecte)
    • en:MediaWiki:Gadget-refToolbarBase.js, variables i funcions comunes
• toollabs:reftoolbar/lookup.php, eina que autocompleta determinats camps a partir dels valors d'identificadors com ISBN, DOI o PMID.

Els scripts utilitzen la llibreria jQuery que està documentada a http://docs.jquery.com. També utilitza alguns mòduls de l'extensió WikiEditor que estan documentats a mw:Extension:WikiEditor/Toolbar customization.