Как нетрудно прочесть на сайте MediaWiki, нынешняя линейка стабильных версий (1.16.x) поставляется со встроенною библиотекою jQuery, код которой лежит по адресу
Предлагаю встать на точку зрения
Первотолчком такого стремления является естественное и почти неизбежное осознание того, как неудобна та необязательность появления jQuery в коде страниц, которая настроена по умолчанию. Всякий
function editZeroSection(){
var body = document.getElementById('bodyContent')
if (!body) return
var h2s = body.getElementsByTagName('H2')
var h2 = h2s[0]
if (!h2) return
if (h2.parentNode.id == 'toctitle') h2 = h2s[1]
if (!h2) return
var span = h2.firstChild
if (!span || span.className != 'editsection') return
var zero = span.cloneNode(true)
body.insertBefore(zero, body.firstChild)
var a = zero.getElementsByTagName('a')[0]
if (a.href.indexOf('§ion=T') == -1 ) a.title = a.title.replace(/:.*$/,': 0')
else a.title = 'Править секцию: 0'
a.setAttribute('href', wgScript + '?title='+encodeURIComponent(wgPageName) + '&action=edit§ion=0')
}
Любому поклоннику jQuery хорошо известно, как эта библиотека напрочь избавила бы авторов функции от необходимости прибегать Предположим,
// Include jQuery
function wfIncludeJQuery() {
global $wgOut;
$wgOut->includeJQuery();
}
$wgExtensionFunctions[] = 'wfIncludeJQuery';
Администраторы вики, обладая правами править страницу «MediaWiki:Common.js», начали переписывать тамошние функции на jQuery, Во-первых, при знакомстве с историей jQuery непременно вскроется,
Во-вторых, едва покончив с переводом существующих скриптов
$(function(){
$.localScroll({
hash: true,
onAfter: function(target){
location = '#' + ( target.id || target.name );
}
});
});
Для вики на движке MediaWiki, с его автоматическими оглавлениями статей, такое улучшение поведения неоценимо.Мы видим: на этом этапе ход событий неумолимо подталкивает
Достижимо ли такое размещение в техническом отношении? Да, вполне достижимо; для него достаточно только убрать из файла «LocalSettings.php» тот код с вызовом метода
Задача о сочинении такого кода расширения MediaWiki, который подключил бы «MediaWiki:jQuery.js» к каждой странице вики, давно решена мною — ответ её (код его) выглядит следующим образом (включая лицензию MIT):
<?php
/*
* jQuery.php - Adds jQuery script to the <head> . . . </head>
* @author Mithgol the Webmaster
* @version 0.2
* @copyright Copyright (C) 2010 Mithgol the Webmaster
* @license The MIT License - http://www.opensource.org/licenses/mit-license.php
* ---------------------------------------------------------------------------------------
* Copyright (c) 2010 Mithgol the Webmaster
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do
* so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
* -----------------------------------------------------------------------
* Version notes:
* version 0.2:
* erase MediaWiki's internal jQuery call, which lacks plugins
* version 0.1:
* initial release
* -----------------------------------------------------------------------
*/
# Confirm MW environment
if (defined('MEDIAWIKI')) {
# Credits
$wgExtensionCredits['other'][] = array(
'name' => 'jQuery',
'author' => 'Mithgol the Webmaster',
'url' => 'http://traditio.ru/wiki/JQuery_%D0%B4%D0%BB%D1%8F_MediaWiki',
'description' => 'Adds jQuery to the list of scripts (HEAD element).',
'version' => '0.2'
);
function jQueryMyHook( &$output, &$skin ) {
$output->mScripts = "\t\t".
'<script type="text/javascript" src="/w/index.php?title=MediaWiki:jQuery.js&action=raw&ctype=text/javascript"></script>'.
"\n" . preg_replace('/<script src="\/w\/skins\/common\/jquery\.min\.js\?\d+"><\/script>/', '<!-- jQuery double, erased -->', $output->mScripts);
return true;
}
$wgHooks['BeforePageDisplay'][] = 'jQueryMyHook';
} # End MW Environment wrapper
?>
Обратите внимание, что выкусыватель файла При наполнении файла «MediaWiki:jQuery.js» уместно обеспечить обратную совместимость
/* По меньшей мере два скрипта MediaWiki:
* 1) /skins/common/edit.js
* 2) /skins/common/preview.js
* полагаются на то, что jQuery можно вызвать переменною $j.
* Так не разочаруем же их:
*/
$j=$;
Очевидно, надеюсь, что этот синоним должен создаваться после кода самóй библиотеки jQuery.Вышеприведённое расширение внедрено в русской