跳至內容

維基百科討論:HanAssist

頁面內容不支援其他語言。
新增話題
維基百科,自由的百科全書
由Dabao qian在話題在其他wiki上使用上作出的最新留言:27 天前

HanAssist第四版

[編輯]
下列討論已經關閉,請勿修改。如有任何意見,請在合適的討論頁提出,而非再次編輯本討論。

HanAssist是一個wgULS及類似函數的替代品。舊版本文檔請參見Wikipedia:HanAssist。 倉庫地址:https://github.com/diskdance/HanAssist 第四版API本體變化不大,主要是調用方式:

  1. 杜絕了污染全局空間的問題。原先API會暴露到全局空間(mw.libs),現在採用了ResourceLoader的模塊化設計。小工具需要先添加HanAssist的依賴,然後按照如下方式使用:
    const { conv, convByVar, batchConv } = require('ext.gadget.HanAssist'); // 注意大小写
    // 对应wgULS
    conv( { hans: '一天一苹果,医生远离我。', hant: '一天一蘋果,醫生遠離我。' } );
    // 对应wgUVS
    convByVar( { hans: '一天一苹果,医生远离我。', hant: '一天一蘋果,醫生遠離我。' } );
    // 批量处理
    mw.messages.set( batchConv( {
    	'article': { hans: '条目', hant: '條目' },
    	'category': { hans: '分类', hant: '分類' },
    	'categories': { hans: '分类', hant: '分類' },
    	'image': { hans: '文件', hant: '檔案' },
    	'images': { hans: '文件', hant: '檔案' },
    	'minute': '分',
    	'minutes': '分',
    	'second': '秒',
    	'seconds': '秒',
    	'week': '周',
    	'weeks': '周',
    	'search': { hans: '搜索', hant: '搜尋' },
    	'SearchHint': { hans: '搜索包含$1的页面', hant: '搜尋包含$1的頁面' },
    	'web': { hans: '站点', hant: '站點' },
    } ) );
    mw.msg( 'categories' );
    mw.msg( 'SearchHint', 'Apple' );
    
    用戶腳本則需要動態加載:
    mw.loader.using( 'ext.gadget.HanAssist' ).then( ( require ) => {
    	const { conv, convByVar } = require( 'ext.gadget.HanAssist' );
    	// 在此处使用
    } );
    
    其他的加載方式不保證可用。
  2. 函數採用更直觀的命名方式。
  3. 現在在傳入不合法的參數的時候會給出警告信息。

以上。--碟之舞📀💿 2023年7月26日 (三) 10:20 (UTC)回覆

小工具已經部署到中文Beta Cluster,各位可以先試試效果。--碟之舞📀💿 2023年7月26日 (三) 10:22 (UTC)回覆
「其他的加載方式不保證可用。」意味着舊腳本需要維護更新?會有人來做嗎。--YFdyh000(留言) 2023年7月26日 (三) 15:22 (UTC)回覆
不是這個意思。--碟之舞📀💿 2023年7月27日 (四) 03:33 (UTC)回覆
(-)反對,使用v4的載入法將導致該腳本必須以非常糟糕的方式(技術細節:v4載入法必然需要將HanAssist注入ResourceLoader才能使用,變成如果要在無此小工具的站點載入將必須污染ResourceLoader)才能被站外引用,這顯然不是一個合適的作法--SunAfterRain 2023年7月27日 (四) 15:15 (UTC)回覆
@SunAfterRain:已經解決。--碟之舞📀💿 2023年7月28日 (五) 04:38 (UTC)回覆
(+)支持--Taeas(留言) 2023年7月28日 (五) 05:36 (UTC)回覆
上方所述的問題已經解決,如果沒有問題的話能否開始公示?--碟之舞📀💿 2023年8月2日 (三) 13:21 (UTC)回覆
我覺得可以。--Taeas(留言) 2023年8月3日 (四) 02:04 (UTC)回覆
部署方案:
  1. 從中文維基百科測試集群處複製此小工具的原始碼和小工具定義。
  2. 移除site-lib中wgU*S的相關內容,由HanAssist接管,可參考測試集群配置。
  3. 將ext.gadget.HanAssist添加為site-lib的依賴項。
公示7日,2023年8月11日 (五) 03:44 (UTC) 結束,抄送@Xiplus、@安憶
以上。--碟之舞📀💿 2023年8月4日 (五) 03:43 (UTC)回覆
公示結束且期間無異議。--碟之舞📀💿 2023年8月11日 (五) 03:58 (UTC)回覆
MediaWiki_talk:Gadget-HanAssist.js#編輯請求_2023-08-11。--碟之舞📀💿 2023年8月11日 (五) 04:06 (UTC)回覆
@Xiplus、@AnYiLin:見上。--碟之舞📀💿 2023年8月11日 (五) 04:08 (UTC)回覆

本討論已關閉,請勿修改。如有任何意見,請在合適的討論頁提出,而非再次編輯本討論。

在其他wiki上使用

[編輯]

有些wiki項目(例如中文維基教科書)仍然採用老舊的wgU*S作為腳本字詞轉換系統,如果在這些項目上按照文檔中的用法直接跨站加載中文維基百科的HanAssist,則用戶工具就會因為無法改寫wgULS全局變量而報錯退出。針對這種跨維基使用的腳本,目前建議的做法是自行加載SunAfterRain放在元維基的HanAssist分支版本。例如:

function implWrapper( ...args ) {
	if ( typeof mw.loader.impl === 'function' ) {
		return mw.loader.impl( function () {
			return args;
		} );
	}

	return mw.loader.implement.apply( mw.loader, args );
}
async function loadHanAssist() {
	const moduleName = 'userscript.MyGadget.HanAssist';

	if ( mw.loader.getState( 'ext.gadget.HanAssist' ) ) {
		mw.loader.register( moduleName, null, [ 'ext.gadget.HanAssist' ] );

		await mw.loader.using( 'ext.gadget.HanAssist' );

		implWrapper(
			moduleName + '@',
			{
				main: 'index.js',
				files: {
					'index.js': ( require, module ) => {
						module.exports = require( 'ext.gadget.HanAssist' );
					}
				}
			}
		);

		if ( mw.loader.getState( moduleName ) === 'missing' ) {
			mw.loader.state( { [ moduleName ]: 'loaded' } );
		}
	} else {
		mw.loader.register( moduleName, null, [] );

		implWrapper(
			moduleName + '@',
			[ 'https://meta.wikimedia.org/w/index.php?title=User:SunAfterRain/js/HanAssist.js&action=raw&ctype=text/javascript' ]
		);

		await mw.loader.using( moduleName );
	}

	const require = await mw.loader.using( moduleName );

	return require( moduleName );
}
( async () => {
	const { conv } = await loadHanAssist();
	// 在此处使用
} )();

(這裏的內容就當我隨手記的筆記吧)--Dabao qian℡ 2026年10月18日 (日) 19:30 (UTC)回覆

@Dabao qian:千萬別學我去hack mw.loader啊,mw.loader.register、mw.loader.state、mw.loader.impl(及以前的mw.loader.implement)都是private api啊 囧rz……--SunAfterRain 2026年10月19日 (一) 16:28 (UTC)回覆
改成原生fetch就可以確保100%不污染RL以及不使用私有API。--Dabao qian℡ 2026年10月21日 (三) 21:22 (UTC)回覆