维基百科讨论:HanAssist

本頁是以往討論的存檔。請勿編輯本頁。若您想發起新討論或重啟現有討論，請在當前討論頁進行。

HanAssist第四版

本主題或以下段落文字，移動自Wikipedia:互助客栈/技术。执行者：Jimmy-bot（留言） 2023年8月23日 (三) 08:14 (UTC)。

部署已完成。--碟之舞📀💿 2023年8月13日 (日) 02:29 (UTC)

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

HanAssist是一个wgULS及类似函数的替代品。旧版本文档请参见Wikipedia:HanAssist。

仓库地址：https://github.com/diskdance/HanAssist

第四版API本体变化不大，主要是调用方式：

杜绝了污染全局空间的问题。原先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' );
	// 在此处使用
} );

其他的加载方式不保证可用。

函数采用更直观的命名方式。
现在在传入不合法的参数的时候会给出警告信息。

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

小工具已经部署到中文Beta Cluster，各位可以先试试效果。--碟之舞📀💿 2023年7月26日 (三) 10:22 (UTC)

“其他的加载方式不保证可用。”意味着旧脚本需要维护更新？会有人来做吗。--YF dyh000（留言） 2023年7月26日 (三) 15:22 (UTC)

不是这个意思。--碟之舞📀💿 2023年7月27日 (四) 03:33 (UTC)

(－)反对，使用v4的載入法將導致該腳本必須以非常糟糕的方式（技術細節：v4載入法必然需要將HanAssist注入ResourceLoader才能使用，變成如果要在無此小工具的站點載入將必須汙染ResourceLoader）才能被站外引用，這顯然不是一個合適的作法--Sun After Rain 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)

部署方案：