模板:Special wikitext

模板文档[查看] [编辑] [历史] [清除缓存]

本系列工具主要目的是在不支援显示标记模板或介面文字之特殊页面中补上标记模板或介面文字，以令标记维护模板或提删流程得以顺利进行。

本模板为Module:Special wikitext、Module:Module wikitext和MediaWiki:Gadget-SpecialWikitext.js的模板调用，目的是为了验证相关程式码行为的一致性、除错、维护以及测试相关功能之用。

详细结果请参考本模板的测试样例：Template:Special wikitext/testcases。

功能

系列工具的功能：

功能			实现方式
0	内容模型	名字空间
插入Wikitext	JS、 JSON、 CSS	User、MediaWiki	内嵌至MediaWiki:Clearyourcache
		其他名字空间	AJAX：当前版本内容送交API:parse
	模板样式、 纯文字及其他	任何
	Lua	Module	内嵌至MediaWiki:Scribunto-doc-page-does-not-exist
预览功能
	JS、 JSON、 CSS、 模板样式、 纯文字及其他	任何	AJAX：编辑框内容送交API:parse
已删内容预览
	Lua	Module	AJAX：使用模板沙盒参数解析Lua
检视差异或历史版本 （含修订版本删除）	任何符合_addText模式的页面		AJAX：历史版本送交API:parse

• 各内容模型插入Wikitext的方式：

内容模型		插入Wikitext的语法		内容模型	插入Wikitext的语法
JSON	Array模式	[... {"_addText":"<wikitext>"}, ...]		JavaScript	_addText="<wikitext>";
	Object模式	{... "_addText":"<wikitext>", ...}		Lua	require('Module:Module wikitext')._addText('<wikitext>')
CSS		._addText{ content:"<wikitext>"; }		通用模式 （JSON除外）	/* _addText : "<wikitext>" */

※技术限制1：由于以上主要是在介面层面上显示内容，故某些情形下页面分类可能会无法正常运作。目前已知页面分类无法正常运作的页面内容模型包括JSON及纯文字。

※技术限制2：-{}-模式的繁简转换无法在介面层面上生效，请考虑使用{{Lan}}做繁简转换。

{{Special wikitext}}模板的功能：

功能	你所输入的	你所看到的
嵌入包含特殊页面中的_addText	{{Special wikitext  |preview=preview  |Special wikitext/testcase.js }}
嵌入包含一个特殊页面	嵌入Module:Module_wikitext/testcase： {{Special wikitext  |Module:Module wikitext/testcase }}	local p = {} local wikitext = require('Module:Module wikitext') wikitext._addText('{{#if:{{CheckPage|Module:Module wikitext/testcase}}|{{Sample}}}}') wikitext._addText('{{ambox|issue=[[Module:Module wikitext/testcase]]}}') wikitext._addText('{{#if:{{CheckPage|Module:Module wikitext/testcase}}|<div style="display:none;">}}') return p
	嵌入Template:Special wikitext/testcase.json： {{Special wikitext  |Special wikitext/testcase.json }}	{ "key": "value", "_addText": "{{#if:{{CheckPage|Template:Special wikitext/testcase.json}}|{{Sample}}}}{{ambox|issue=[[Template:Special wikitext/testcase.json]]}}" }
	嵌入Template:Special wikitext/testcase.js： {{Special wikitext  |Special wikitext/testcase.js }}	var _addText="{{#if:{{CheckPage|Template:Special wikitext/testcase.js}}|{{Sample}}}}{{ambox|issue=[[Template:Special wikitext/testcase.js]]}}";
	对比一般的嵌入方式 Template:Special wikitext/testcase.js： {{ Special wikitext/testcase.js }}	var _addText="";
标记触发预览	{{Special wikitext  |preview=js  |Special wikitext/testcase.js }}	var _addText="{{#if:{{CheckPage|Template:Special wikitext/testcase.js}}|{{Sample}}}}{{ambox|issue=[[Template:Special wikitext/testcase.js]]}}";
展示某个页面的原始码	{{Special wikitext  |lang=wikitext  |Ifsubst }}	{{ {{{|safesubst:}}}#ifeq:{{ {{{|safesubst:}}}NAMESPACE}}{{{nosubst|}}}|{{NAMESPACE}} |{{{no|{{{2|}}}}}} |{{{yes|{{{1|}}}}}} }}<noinclude> {{Documentation}} </noinclude>

特殊页面编辑提示

Special Wikitext模块也可以给Special命名空间的页面提供Wikitext页顶提示。

Special Wikitext模块会给有定义于Template:Editnotices/Page/Special:的特殊页面显示页顶提示，但判定条件是以该特殊页面的全英文名称进行判断。

例如要给Special:Blankpage/SpecialWikitextSandbox这个特殊页面添加页顶提示，可以依照Template:Editnotices方式给这个特殊页面添加页顶提示（注意：大小写敏感）

首先先确定该页面的英文全名（包含命名空间前缀Special:页面名称和子页面名称）。由于Special命名空间无法编辑，因此无法使用在页面放置{{FULLPAGENAME}}的方式得到，不过可以用网页的开发者模式，在主控台执行以下指令来得到全英文的页面名称：

[['wgCanonicalNamespace','wgCanonicalSpecialPageName'].map(i=>mw.config.get(i)).join(':')].concat((mw.config.get('wgTitle')||'').split('/').slice(1)).join('/')

接著将得到的英语特殊页面名称来建立Template:Editnotices/Page的子页面

以Special:Blankpage/SpecialWikitextSandbox为例，该指令码输出

Special:Blankpage/SpecialWikitextSandbox（注意：大小写敏感）

来建立页面，也就是在Template:Editnotices/Page/Special:Blankpage/SpecialWikitextSandbox页面填入内容，就会自动于Special:Blankpage/SpecialWikitextSandbox页顶显示

可用以下语法另其只在目标页面显示：

{{#ifeq:{{ROOTPAGENAME}}|Editnotices
|<!--在 [[Template:Editnotices/Page]] 頁顯示的內容-->
|<!--在目標頁面顯示的內容-->
}}

参考范例Template:Editnotices/Page/Special:Blankpage/SpecialWikitextSandbox/SD、Special:Blankpage/SpecialWikitextSandbox/SD。

参数说明

参数1：

要处理的特殊页面名称。若省略此参数则须提供原始码src参数。

参数src：

要处理的特殊页面内容模型之原始码。若输入了此参数则参数1将会无效。

参数preview：

决定特殊页面的展示模式。

模式名称	代码	功能
完整模式	preview=wiki、wikitext	同时展示_addText与特殊页面原始码
代码模式	preview=code	仅展示特殊页面原始码
预览模式	preview=preview	仅展示_addText
小工具预览模式	preview=js、ajax	展示特殊页面原始码，并向小工具请求发送预览。
预设模式	(未输入)	同完整模式，可当作特殊页面的嵌入包含。

模板功能与参数总表：

嵌入包含一个特殊页面内容模型之页面

模板参数[编辑模板数据]

参数		描述	类型	状态
页面名称	1	要嵌入或读取_addText内容的页面。如果省略此参数则需要加入原始码(src)参数。	页面名称	可选
预览模式	preview	控制输出的预览模式	字符串	可选
页面内容模型	contentModel lang	以指定的页面内容模型来解析页面原始码。若省略则自动判断。	字符串	可选
原始码	src	从指定的原始码中解析。(建议用<nowiki>包覆)	内容	可选

子模板相依关系图

Special wikitext

展示代码

展示_addText

展示特殊页面

请求预览

#/codeshow

#/previewdisplay

#/preview

#/jspreview

Module:#/Template

图例

#/code

#/content

#/codedisplay

Gadget:#.js

模板本身

主要模板

#/include

#/immcode

Module:#

Module wikitext

#/JSON

渲染JSON

可外部调用

相依模组

#/testcases

#/testcase

Module:#/JSON

#/JSON.css

测试样例

内部模板

Template:#

#/codeshow

相依性

以下为MediaWiki:Gadget-SpecialWikitext.js的相依模板、模组与脚本。要让本工具汇入至其他维基媒体站点，令其在其他维基运作，需要在其他维基站点备齐。

• MediaWiki:Gadget-SpecialWikitext.js（完整引入）
  • MediaWiki:Gadget-HanAssist.js（需求函数conv）
  • Module:Special_wikitext/Template（完整引入）
  • Module:Module_wikitext（完整引入）
  • Module:Special_wikitext（完整引入）
  • MediaWiki:Gadgets-definition（加入*SpecialWikitext[ResourceLoader|default|dependencies=ext.gadget.site-lib,mediawiki.api|hidden|targets=desktop,mobile|type=general]|SpecialWikitext.js）
• MediaWiki:Clearyourcache（末尾加上{{#invoke:Special wikitext|displayWikitext}}）
• MediaWiki:Scribunto-doc-page-does-not-exist（Doc引用改成{{#invoke:documentation|nonexistent|_content={{ {{#invoke:documentation|contentTitle}}}}}}）
  • Module:Documentation（需求函数p._getModuleWikitext与函数p.nonexistent，并在p._main中root后方添加:wikitext(p._getModuleWikitext(args, env))）

参见

• Special:搜索/insource:/_addText/：可能有使用Special wikitext的页面。

上述文档嵌入自Template:Special wikitext/doc。 (编辑 | 历史)
编者可以在本模板的沙盒 (编辑 | 差异)和测试样例 (编辑)页面进行实验。
请在/doc子页面中添加分类。 本模板的子页面。