wikishia:RefToolbar
RefToolbar refers to a series of JavaScript/jQuery scripts that help editors add citation templates to articles. It works in conjunction with the MediaWiki extension WikiEditor. The Reftoolbar implementation is scattered across several scripts (see, for example, this, this or this prefix search). The newest version, RefToolbar 2.0 is turned on by default for new users.
Originally an opt-in Wikipedia Gadget, Reftoolbar was moved to a site-wide script on February 25, 2011, and to an opt-out gadget on April 2014.[1][2] It comes in three versions, depending on the settings at Preferences → Editing → Editor.
Versions
The default for all users, logged in or not, is refToolbar 2.0b.
Each version has its advantages. What differs is the activating widget, the number and type of cite templates offered, whether or not the edit box is deactivated, and the quality of the dialog. Click on the version number for more information about each refToolbar implementation.
Enable enhanced... | Enable wizards... | RefToolbar version |
RefToolbar style | Script |
---|---|---|---|---|
Off | Off On |
RefToolbar 1.0 | File:RefToolbar 1.0.png Cite icon on right |
MediaWiki:RefToolbarLegacy.js |
On | Off | RefToolbar 2.0a | File:RefToolbar 2.0a.png {{}} icon in middle |
MediaWiki:RefToolbarNoDialogs.js |
On | RefToolbar 2.0b | 50% Cite button on right |
MediaWiki:RefToolbar.js |
Table headings are abbreviations of the names seen at Preferences → Editing:
- Enable enhanced... will say Enable the editing toolbar.
- Enable wizards... says ⧼wikieditor-toolbar-dialogs-preference⧽.
The RefToolbar style column indicates the widget that activates the cite mechanism.
Visual editor
If your toolbar looks like this:
Then you are using the rich-text visual editor. It also has a Cite button, with an auto-filling citoid service, but that one is NOT RefToolbar. We know, it is highly confusing....
If you want to learn how to use that Cite menu, please refer to the Visual Editor user guide.
Related scripts
- MediaWiki:Gadgets-definition — this defines the module "ext.gadget.refToolbar" (loaded for everybody), responsible by loading the appropriated components of the RefToolbar, such as the module "ext.gadget.refToolbarBase"
- MediaWiki:Gadget-refToolbar.js — this is the main script that generates the editing window and is where RefToolbar gets included
- MediaWiki:Gadget-refToolbarBase.js — common variables and functions for all scripts
- MediaWiki:RefToolbarMessages-en.js — English UI translations
- MediaWiki:RefToolbarMessages-de.js — German UI translations
- MediaWiki:RefToolbarConfig.js
- toollabs:reftoolbar/lookup.php Provides the autofill capability used to auto-complete forms based on ISBN, DOI, and PMID values. (source code)
You can also do a "subpages with prefix searches" to find other related pages, in particular MediaWiki and Wikipedia namespace searches are useful.
Dependency graph
Error: Image is invalid or non-existent.
This image file is found at commons:File:Wikipedia reftoolbar dependency graph.svg.
See also
- User:Odie5533/SnipManager
- Help:Edit toolbar
- WP:CITETOOL contains a list of citation related tools