rappaurio-sae501_502/app/node_modules/cejs/application/net/wiki

<!-- The first line is blank due to BOM -->
= CeJS MediaWiki module =
MediaWiki 自動化作業程式庫，主要用於編寫[[維基百科:機器人]]。


== Usage in [https://www.mediawiki.org/wiki/Manual:Interface/JavaScript mediawiki user script] (User:Example/common.js) ==
<pre><code>
if (!window.CeL) {
	window.CeL = { initializer: function() { CeL.run('application.net.wiki', CeL_initialization); } };
	mw.loader.load('https://kanasimi.github.io/CeJS/ce.js');
}
function CeL_initialization() {
	/** {Array} parsed page content */
	const parsed = CeL.wiki.parser('{{tl|t}}');
	parsed.each('template', function(token) { console.log(token.name); });

	const wiki = CeL.wiki.mw_web_session;
	// wiki.page('Wikipedia:Sandbox').edit(function(page_data) { return CeL.wiki.content_of(page_data) + '\ntest'; });
}
</code></pre>
(At 2021, The JavaScript parser of MediaWiki loader cannot read ECMAScript 2016 syntax.)

Also refer to [https://kanasimi.github.io/CeJS/_test%20suite/wikitext_parser.html the wikitext parser examples].

; Append parameter to template:
<pre><code>
const wiki = CeL.wiki.mw_web_session;
wiki.page(mw.config.get('wgPageName')).edit(function(page_data) {
	/** {Array} parsed page content */
	const parsed = CeL.wiki.parser(page_data).parse();
	parsed.each('Template:Artwork', function(token) {
		token.push('wikidata=Q27964733');
	});
	return parsed.toString();
}, {
	summary: 'test edit'
}).run(function() {
	location.reload();
});
</code></pre>

== Operation mechanism 運作機制 ==
Main initial point: [[../wiki.js]]

; Essential 必要: [[../wiki.js]] → [[namespace.js]] → [[parser.js]], [[query.js]], [[page.js]], [[Flow.js]], [[list.js]], [[edit.js]], [[task.js]]
; Optional 可選功能: [[data.js]], [[admin.js]], [[cache.js]], [[Toolforge.js]]
; Change with wikiproject page contents 隨各 wikiproject 頁面內容變化之功能: [[template_functions.js]], [[featured_content.js]]

More examples: 使用範例可參照：
<!--
const util = require('util'); new util.promisify(CeL.wiki)(...)
-->
* [https://github.com/kanasimi/wikiapi JavaScript MediaWiki API for ECMAScript 2017+] / [https://github.com/kanasimi/wikiapi/blob/master/wikiapi.js wikiapi.js]
* [https://github.com/kanasimi/wikibot Wikipedia bots demo] / [https://github.com/kanasimi/wikibot/blob/master/wiki%20loader.js wiki loader.js]
* [[/_test suite/test.js|test.js]]
* [https://kanasimi.github.io/CeJS/_test%20suite/wikitext_parser.html Wikitext parser examples. Wikitext 解析器使用例子]


== History ==
{| class="wikitable"
|+ History 沿革
! Date !! Modify
|-
| 2015/1/1 || Starting to write codes.

開始撰寫模組程式碼。
|-
| 2019/10/11 || 分拆至 wiki/*.js
|-
| 2020/5/24 || 分拆 wiki.js。基本功能僅需要 `CeL.run('application.net.wiki')`。
|}


== See also ==
* [https://www.mediawiki.org/w/api.php MediaWiki API help]