mediawiki-extensions-CiteTh.../Cite.php

<?php
if ( ! defined( 'MEDIAWIKI' ) )
	die();
/**#@+
 * A parser extension that adds two tags, <ref> and <references> for adding
 * citations to pages
 *
 * @addtogroup Extensions
 *
 * @link http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Documentation
 *
 * @bug 4579
 *
 * @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
 * @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason
 * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
 */

if ( defined( 'MW_SUPPORTS_PARSERFIRSTCALLINIT' ) ) {
	$wgHooks['ParserFirstCallInit'][] = 'wfCite';
} else {
	$wgExtensionFunctions[] = 'wfCite';
}

$wgExtensionCredits['parserhook'][] = array(
	'path' => __FILE__,
	'name' => 'Cite',
	'author' => 'Ævar Arnfjörð Bjarmason',
	'descriptionmsg' => 'cite_desc',
	'url' => 'http://www.mediawiki.org/wiki/Extension:Cite/Cite.php'
);
$wgParserTestFiles[] = dirname( __FILE__ ) . "/citeParserTests.txt";
$wgExtensionMessagesFiles['Cite'] = dirname( __FILE__ ) . "/Cite.i18n.php";
$wgAutoloadClasses['Cite'] = dirname( __FILE__ ) . "/Cite_body.php";
$wgSpecialPageGroups['Cite'] = 'pagetools';

define( 'CITE_DEFAULT_GROUP', '');
/**
 * The emergency shut-off switch.  Override in local settings to disable
 * groups; or remove all references from this file to enable unconditionally
 */
$wgAllowCiteGroups = true; 

/**
 * An emergency optimisation measure for caching cite <references /> output.
 */
$wgCiteCacheReferences = false;

function wfCite() {
	new Cite;
	return true;
}

/**#@-*/
* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`<?php`
			`if ( ! defined( 'MEDIAWIKI' ) )`
Revert to 1.13, fixes bug which caused first item to fail to render. 2006-01-27 10:14:45 +00:00			`die();`
* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`/**#@+`
* Updated documentation * Updated the link to the online documentation, now on meta 2005-12-25 19:39:22 +00:00			`* A parser extension that adds two tags, <ref> and <references> for adding`
			`* citations to pages`
			`*`
Use Doxygen @addtogroup instead of phpdoc @package && @subpackage This is like r19502 but for extensions. 2007-01-20 15:10:35 +00:00			`* @addtogroup Extensions`
* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`*`
* Updated link to documentation, now at mediawiki.org not meta * Removed links to HTML <cite> element, confusing 2009-07-10 13:51:26 +00:00			`* @link http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Documentation`
* Updated documentation * Updated the link to the online documentation, now on meta 2005-12-25 19:39:22 +00:00			`*`
* (bug 4579) changing the default _ref and _note id's so that they can be styled with CSS2 attribute selectors * Documentation 2006-01-12 15:14:46 +00:00			`* @bug 4579`
			`*`
* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`* @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>`
			`* @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason`
			`* @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later`
			`*/`

Update a bunch of extensions to avoid unstubbing $wgParser early for setHook() on current MW versions. 2008-06-06 20:38:04 +00:00			`if ( defined( 'MW_SUPPORTS_PARSERFIRSTCALLINIT' ) ) {`
			`$wgHooks['ParserFirstCallInit'][] = 'wfCite';`
			`} else {`
			`$wgExtensionFunctions[] = 'wfCite';`
			`}`

* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`$wgExtensionCredits['parserhook'][] = array(`
Follows up r49890, adding file location itself to obtaining the revision number shown in the Special:Version 2009-04-27 03:15:19 +00:00			`'path' => __FILE__,`
* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`'name' => 'Cite',`
			`'author' => 'Ævar Arnfjörð Bjarmason',`
* (bug 10365) Localization of Special:Version Extension descriptions can be localized by adding the new keyword 'descriptionmsg' to $wgExtensionCredits with a message name. See the Cite extension as example. Patches for other extensions will follow in the next days. 2008-01-31 14:38:12 +00:00			`'descriptionmsg' => 'cite_desc',`
revert r28306, r28308, r28309, r28312 2007-12-16 18:45:23 +00:00			`'url' => 'http://www.mediawiki.org/wiki/Extension:Cite/Cite.php'`
* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`);`
Revert "Follow up on r43982. Reduce dirname(__FILE__) calls in core and extensions." Uses $dir in extension files, and assumes that it remains unchanged in require_once( 'maintenance/commandLine.inc' ). In fact, it is likely that '$dir' will be set when setting up command-line, as some extensions will use the same var. Recommended fix: Use $CentralAuth_dir, $EmailPage_dir, etc. 2008-11-30 03:15:22 +00:00			`$wgParserTestFiles[] = dirname( __FILE__ ) . "/citeParserTests.txt";`
			`$wgExtensionMessagesFiles['Cite'] = dirname( __FILE__ ) . "/Cite.i18n.php";`
			`$wgAutoloadClasses['Cite'] = dirname( __FILE__ ) . "/Cite_body.php";`
* adding to proper group on Special:SpecialPages 2008-07-12 01:15:55 +00:00			`$wgSpecialPageGroups['Cite'] = 'pagetools';`
Revert to 1.13, fixes bug which caused first item to fail to render. 2006-01-27 10:14:45 +00:00
add group option, initialize structures when we start group, clear them when finished 2008-03-21 15:25:26 +00:00			`define( 'CITE_DEFAULT_GROUP', '');`
			`/**`
			`* The emergency shut-off switch. Override in local settings to disable`
			`* groups; or remove all references from this file to enable unconditionally`
			`*/`
			`$wgAllowCiteGroups = true;`

Improve Cite references caching by making it dependent on a config setting, which defaults to off. This way, we can still use it as emergency optimisation if the need arises. 2009-02-12 18:02:27 +00:00			`/**`
			`* An emergency optimisation measure for caching cite <references /> output.`
			`*/`
			`$wgCiteCacheReferences = false;`

Cite Internationalisation (en + he) 2006-07-15 14:00:29 +00:00			`function wfCite() {`
* <li><cite id=..> => <li id=..> in 'cite_references_link_one' and 'cite_references_link_', only direct references should be wrapped in <cite> and since that probably won't apply to everything users put here I'm removing it * Documentation, marked functions as static where applicable * Using ~ as a regexp delimiter instead of #, ��var like better.. * Killed PersistentObject 2006-01-07 09:24:48 +00:00			`new Cite;`
Update a bunch of extensions to avoid unstubbing $wgParser early for setHook() on current MW versions. 2008-06-06 20:38:04 +00:00			`return true;`
* Extension that adds <ref> and <references/> tags 2005-12-21 01:08:25 +00:00			`}`
revert r28306, r28308, r28309, r28312 2007-12-16 18:45:23 +00:00
			`/*#@-/`