Template:Documentation：修订间差异

2026年8月26日 (三) 10:52的最新版本

这个模板自动显示“模板文档”框，就像你现在看到的这样。文档框中的内容由其它页面生成，

用法

在主模板中增加<noinclude>{{Documentation}}</noinclude>。
点击“编辑”链接，它将打开/doc子页面，并在那里填写文档。
將分類增加在/doc子頁面的<includeonly></includeonly>中。

正常的/doc子页面

<noinclude>{{Documentation}}</noinclude>

任意/doc子页面

<noinclude>{{Documentation|Template:any page/doc}}</noinclude>

内联内容

<noinclude>{{Documentation|content=这是一个文档。}}</noinclude>

有[查看][编辑]链接的内联内容

<noinclude>{{Documentation
|1 = Template:模板名/doc
|content ={{Template:模板名/doc|参数}}
}}</noinclude>

最佳用法

此代码应该放置在模板代码的底部“<noinclude>”之前且不加多余的空格（否则会导致使用该模板的页面上出现多余空格）。参数可以像上面这样来使用以包含任意文档页。用于模板本身的分类链接应该用 <includeonly> </includeonly> 标签来添加到文档页面。更复杂的案例请参见 Wikipedia:模板文件頁模式#分类链接。如果文档页包含 includeonly 或 noinclude 标签并作为文档的一部分，请用“<”替代“<”。

請勿在/doc子頁面裡再掛上{{Documentation}}，以避免出錯

自定义显示

替换这些值可以实现特殊的输出效果：

{{documentation| heading = ...}} − 改变“文档”页的标题文字。如果此处留空，整个标题行（包括第一个[编辑]链接）也将隐藏。

{{模板文档}}、{{Template doc}}、{{Documentation, template}}與{{Doc}}均重定向至此處。

进入 Template:Documentation/doc 页面来编辑这个模板的说明文档。（这个说明框是怎么回事？）
修改完毕后，请刷新上面的文本。（为什么？）

该模板搬运自huijiwiki:优质模板

@@ 第1行： / 第1行： @@
-<!--
+<div class="" style="padding:0px 1px;clear: both;"><div class="plainlinks" style="border: 1px solid rgba(255,255,255,.15);
-  Automatically add {{template sandbox notice}} when on a /sandbox page.
+    margin-bottom: 15px;
--->{{#ifeq: {{SUBPAGENAME}} | sandbox
+    padding: 10px;
-| <div style="clear: both;"></div>{{template sandbox notice|{{{livepage|}}}}}
+    background-color: rgba(255,255,255,.05);
-}}<!--
+    box-shadow: 0 0 0 1px #000;clear:both;"><span style="font-size:24px;">'''模板文档'''</span> <span style="float:right">[{{fullurl:{{FULLPAGENAME}}/doc|action=edit}} <span class="btn btn-primary">编辑文档</span>]&nbsp; [{{fullurl:{{FULLPAGENAME}}|action=edit}} <span class="btn btn-primary">编辑模板</span>]&nbsp;[{{fullurl:{{FULLPAGENAME}}|action=purge}} <span class="btn btn-primary">刷新</span>]</span>{{clear}}</div> <div class="" style="    border: 1px solid rgba(255,255,255,.15);
-  Automatically add {{pp-template}} to protected templates.
+    margin-bottom: 15px;
--->{{template other
+    clear:both;
-| {{#ifeq: {{PROTECTIONLEVEL:move}} | sysop
+    padding: 10px;
-  | {{pp-template|docusage=yes}}
+    background-color: rgba(255,255,255,.05);
-  | {{#if: {{PROTECTIONLEVEL:edit}}
+    box-shadow: 0 0 0 1px #000;">{{
-    | {{pp-template|docusage=yes}}
+    #if: {{{content|}}}
-    | <!--Not protected, or only semi-move-protected-->
+    | <nowiki/>
+{{{content}}}
+    | &nbsp;
+{{
+      #ifexist: {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}
+      |{{{{
+        #ifeq: {{NAMESPACE}} | {{ns:Template}}
+        || :{{NAMESPACE:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}} }}}}:
+      }}{{ #if: {{{1|}}} | {{PAGENAME:{{{1}}}}} | {{PAGENAME}}/doc}} }}
+      | :<strong class="error">这个模板暂时没有说明文档。</strong>你可以[{{fullurl:{{ #if: {{{1|}}} | {{ urlencode: {{{1}}} }} | {{FULLPAGENAMEE}}/doc }}|action=edit&preload=Template:Documentation/preload}} 创建模板文档]。{{
+        #ifeq: {{NAMESPACE}} | {{ns:10}}
+        | 在 [[h:templatemanager:{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}|灰机模板仓库]] 上面有大量可以复制的现成模板。      }}[[Category:Templates without documentation|{{PAGENAME}}]]
      }}
-   }}
+   }}  </div> <div class="" style="border: 1px solid rgba(255,255,255,.15);
-}}<!--
+    margin-bottom: 15px;
-  Start of green doc box.
+    padding: 10px;
--->{{documentation/start box2
+    background-color: rgba(255,255,255,.05);
-| preload = {{{preload|}}}   <!--Allow custom preloads-->
+    box-shadow: 0 0 0 1px #000;clear: both; font-size: 85%; text-align: right;">{{
-| heading = {{{heading|¬}}}   <!--Empty but defined means no header-->
+    #if: {{{content|}}}
-| heading-style = {{{heading-style|}}}
+     | [{{fullurl:{{FULLPAGENAMEE}}|action=edit}} Edit this page]
-| content = {{{content|}}}
+    | 进入 {{
+      #ifexist: {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}
-<!--Some namespaces must have the /doc, /sandbox and /testcases
+      | [[{{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}]]
-     in talk space-->
+      | [{{fullurl:{{ #if: {{{1|}}} | {{ urlencode: {{{1}}} }} | {{FULLPAGENAMEE}}/doc }}|action=edit&preload=Template:Documentation/preload}} {{ #if: {{{1|}}} | {{{1}}} | {{FULLPAGENAME}}/doc }}]
-| docspace = {{documentation/docspace}}
+     }}}} 页面来编辑这个模板的说明文档。（[[Template:Documentation|这个说明框是怎么回事]]？）<br />修改完毕后，请[{{fullurl:{{FULLPAGENAME}}|action=purge}} 刷新]上面的文本。（[[h:帮助:Huiji缓存|为什么？]]）</div></div><noinclude>{{优质模板|功能}}[[Category:已经本地化的模板]][[Category:huiji template]]</noinclude>
-| 1 = {{{1|}}}   <!--Other docname, if fed-->
-<!--The namespace is added in /start box2-->
-| template page = {{documentation/template page}}
-}}<!-- Start content --><!--
-  Start load the /doc content:
-  Note: The line breaks between this comment and the next line are necessary
-  so  "=== Headings ===" at the start and end of docs are interpreted.
--->
-{{#switch: {{#if:{{{content|}}}|1|0}}{{#if:{{{1|}}}|1|0}}{{#ifexist:{{{1|}}}|1|0}}{{#ifexist:{{documentation/docspace}}:{{documentation/template page}}/doc|1|0}}
-| 1000 | 1001 | 1010 | 1011 | 1100 | 1101 | 1110
-| 1111 = {{{content|}}}
-| 0110 | 0111 = {{ {{{1}}} }}
-| 0001 | 0011 = {{ {{documentation/docspace}}:{{documentation/template page}}/doc }}
-| 0000 | 0100 | 0010 | 0101 =
-}}
-<!--
-  End load the /doc content:
-  Note: The line breaks between this comment and the previous line are necessary
-  so  "=== Headings ===" at the start and end of docs are interpreted.
--->{{documentation/end box2
-| preload = {{{preload|}}}   <!--Allow custom preloads-->
-| content = {{{content|}}}
-| link box = {{{link box|}}}   <!--So "link box=off" works-->
-<!--Some namespaces must have the /doc, /sandbox and /testcases
-     in talk space-->
-| docspace = {{documentation/docspace}}
-| 1 = {{{1|}}}   <!--Other docname, if fed-->
-<!--The namespace is added in /end box2-->
-| template page = {{documentation/template page}}
-}}<!--
-  End of green doc box
---><noinclude>
-<!-- Add categories and interwikis to the /doc subpage, not here! -->
-</noinclude>

DoubleCircle​（留言 | 贡献）