查看“︁MediaWiki:Gadget-edit0.js”︁的源代码

// [[en:MediaWiki:Gadget-edittop.js]]

// **********************************************************************
// **                 ***WARNING GLOBAL GADGET FILE***                 **
// **             changes to this file affect many users.             **
// **           please discuss on the talk page before editing         **
// **                                                                  **
// **********************************************************************
// 基于原始代码修改，仅保留中文（zh）、简体中文（zh-hans）和繁体中文（zh-hant）支持。

// 仅在“查看”或“清除缓存”页面，并且是内容命名空间（非特殊页面）时执行
if ($.inArray(mw.config.get('wgAction'), ['view', 'purge']) !== -1 && mw.config.get('wgNamespaceNumber') >= 0) {
    // 当DOM加载完成后执行
    $(function edittop_hook() {
        // 定义不同语言对应的“编辑首段”文本
        var localtitles = {}; // 初始化一个空对象

        // 为所有中文变体设置统一的简体文本
        localtitles.zh = localtitles['zh-hans'] = localtitles['zh-cn'] = localtitles['zh-sg'] = localtitles['zh-my'] = '编辑首段';
        
        // 为所有繁体中文变体设置统一的繁体文本
        localtitles['zh-hant'] = localtitles['zh-hk'] = localtitles['zh-mo'] = localtitles['zh-tw'] = '編輯首段';

        // 找到页面的主要内容区域
        var our_content = $('#content, #mw_content').first();
        
        // 在内容区域中找到第一个非纯链接形式的编辑区块（<span class="mw-editsection">）
        var span1 = our_content.find('span.mw-editsection:not(.plainlinks)').first();
        
        // 如果没有找到这样的编辑区块（例如页面不可编辑），则直接退出函数
        if (!span1.length) return;
        
        // 克隆这个编辑区块
        var span0 = span1.clone();

        // 将克隆出来的编辑区块添加到页面的主标题（h1）后面
        $('#mw_header h1, #content h1').first().append(span0);
        
        // 对克隆区块内的所有链接（<a>标签）进行处理
        span0.find('a').each(function(idx) {
            var a = $(this);
            var href = a.attr('href') || '';
            
            // 设置链接的提示文字（title属性）。优先使用用户当前的语言变体，
            // 如果找不到（理论上不会发生），则回退到默认的'zh'对应的文本。
            var userLang = mw.config.get('wgUserLanguage');
            a.attr('title', localtitles[userLang] || localtitles.zh);

            // 修改链接的目标地址（href属性）
            if (!/&(ve|)section=T/.test(href)) { // 如果链接不是指向嵌入内容的
                // 将链接中的section参数改为0（代表首段），并添加编辑摘要
                a.attr('href', href.replace(/&(ve|)section=\d+/, '&$1section=0&summary=/*%20top%20*/%20'));
            } else if (/&vesection=/.test(href)) { // 如果是指向嵌入内容且使用VE编辑器
                // 构建一个新的、指向当前页面首段的VE编辑链接
                a.attr('href', mw.util.getUrl(mw.config.get('wgPageName')) + '?veaction=edit&vesection=0&summary=/*%20top%20*/%20');
            } else { // 如果是指向嵌入内容但使用传统编辑器
                // 构建一个新的、指向当前页面首段的传统编辑链接
                a.attr('href', mw.util.getUrl(mw.config.get('wgPageName')) + '?action=edit&section=0&summary=/*%20top%20*/%20');
            }
        });
    });
}