ProveIt

From mediawiki.org
The ProveIt logo.

ProveIt is a reference manager for Wikipedia and any other MediaWiki wiki. Referencing is a key task in many wikis, but the process is often difficult because the citation templates are complex. ProveIt simplifies the process by adding a smart and simple graphical user interface when editing any article. You deal with the interface, ProveIt deals with the wikitext.

  • ProveIt minimized.
    ProveIt minimized.
  • The reference list.
    The reference list.
  • Editing a reference.
    Editing a reference.
  • Loading a reference via the Citoid service.
    Loading a reference via the Citoid service.
  • After a reference has been loaded via Citoid.
    After a reference has been loaded via Citoid.

Installation[edit]

If your wiki already has ProveIt available as a gadget, simply go to the Gadgets tab in your preferences and enable it. If it's not available and you'd like to have it, first visit Special:Version in your wiki to make sure the following extensions are there:

Then, you can install ProveIt just for you by adding the following code to your common.js in the wiki where you want it available (Wikimedia or not) or to your global.js if you want it available in every Wikimedia wiki: 

/**
 * ProveIt is a reference manager for Wikipedia and any other MediaWiki wiki
 * Documentation at https://www.mediawiki.org/wiki/ProveIt
 *
 * This initialization script sets the configuration options specific to this wiki
 * and then loads the ProveIt code directly from MediaWiki.org
 */
function loadProveIt() {
	mw.config.set( {
		'proveit-tag': 'proveit', // Revision tag defined at Special:Tags (optional)
		'proveit-summary': 'Reference edited with [[mw:ProveIt|ProveIt]]', // Automatic edit summary (optional)
		'proveit-templates': [ // Local citation templates (without namespace)
			'Citation',
			'Cite arXiv',
			'Cite AV media',
			'Cite book',
			'Cite bioRxiv',
			'Cite comic',
			'Cite encyclopedia',
			'Cite episode',
			'Cite interview',
			'Cite journal',
			'Cite magazine',
			'Cite news',
			'Cite paper',
			'Cite press release',
			'Cite report',
			'Cite sign',
			'Cite speech',
			'Cite thesis',
			'Cite tweet',
			'Cite video',
			'Cite video game',
			'Cite web',
		],
		'proveit-namespaces': [ // Supported namespaces, see https://www.mediawiki.org/wiki/Manual:Namespace_constants
			0, // Main namespace
			2, // User namespace
		]
	} );
	mw.loader.load( '//www.mediawiki.org/w/load.php?modules=ext.gadget.ProveIt&only=scripts' );
	mw.loader.load( '//www.mediawiki.org/w/load.php?modules=ext.gadget.ProveIt&only=styles', 'text/css' );
}

// Only load when editing
mw.hook( 'wikipage.editform' ).add( loadProveIt );
mw.hook( 've.activationComplete' ).add( loadProveIt );

If you'd like to make ProveIt available in your wiki as a gadget, first define an entry at MediaWiki:Gadgets-definition (see Extension:Gadgets#Usage for details) and use the above code as the main script (read the code comments to do the necessary adjustments).

Important! If you install ProveIt as a gadget, please add your wiki to the #Tracking table so we can keep it updated.

Template data[edit]

ProveIt is closely integrated with the template data of the citation templates. The more template data you specify, the smarter ProveIt can get. For example:

  • Parameters marked as "required" are shown in bold
  • Parameters marked as "suggested" are visible by default
  • Parameters marked as "optional" are hidden by default
  • Parameters marked as "deprecated" are shown striked
  • Parameters of "date" type show a Today button that inserts the current date
  • Parameters of "content" type show as a text area rather than single-line input field
  • The "format" field determines whether ProveIt will generate references as blocks or inline
  • Parameters are sorted according to their order in the template data

Due to cache issues, ProveIt may take a while to reflect any changes you make to the template data.

Localization[edit]

Visit the translation project at translatewiki.net to help with translations. Your translations will become available automatically to everyone in a few days, when the translatewiki bot merges your changes. Thanks!

Development[edit]

Visit the Phabricator project to report bugs and request features. Clone the Gerrit repository to start contributing (see Gerrit/Tutorial). Once your code gets merged, it will be manually copied to MediaWiki:Gadget-ProveIt.js and MediaWiki:Gadget-ProveIt.css and become live.

Tracking table[edit]

Wikipedia Initialization code Enabled as gadget Revision tag Local documentation
Armenian Yes Yes (by default) Yes No
Assamese Yes Yes (by default) No Yes
Azerbaijani Yes Yes No Yes
Bengali Yes Yes Yes Yes
Bihari Yes Yes No Yes
Bulgarian Yes Yes Yes No
Chinese Yes Yes Yes Yes
Croatian Yes Yes Yes No
English Yes Yes Yes Yes
Estonian Yes Yes Yes Yes
Finnish Yes Yes Yes Yes
French Yes Yes Yes Yes
Greek Yes Yes No No
Gujarati Yes Yes No No
Hindi Yes Yes No Yes
Hungarian Yes Yes No No
Indonesian Yes Yes Yes Yes
Italian Yes Yes Yes Yes
Japanese Yes Yes Yes Yes
Korean Yes Yes Yes Yes
Kannada Yes Yes (by default) No No
Kazakh Yes Yes No Yes
Malay Yes Yes No Yes
Occitan Yes Yes No No
Odia Yes Yes No Yes
Pashto Yes Yes No No
Persian Yes Yes Yes Yes
Polish Yes Yes Yes No
Portuguese Yes Yes Yes No
Punjabi Yes Yes No Yes
Russian Yes Yes Yes Yes
Serbian Yes Yes Yes No
Sindhi Yes Yes No No
Sinhalese Yes Yes No No
Sorani Yes Yes Yes Yes
Spanish Yes Yes Yes Yes
Tamil Yes Yes No Yes
Tulu Yes Yes No No
Turkish Yes Yes No Yes
Urdu Yes Yes No Yes
Uzbek Yes Yes No Yes
Vietnamese Yes Yes Yes No
Yue Chinese Yes Yes No No

See also[edit]

Credits[edit]

Retrieved from "https://www.mediawiki.org/w/index.php?title=ProveIt&oldid=6486937"