Template:Doc/doc/zh

This is a documentation subpage for Template:Doc.
Don't forget to purge the contents of the base page upon creating or editing this subpage.

Purge base's cache

模板 {{doc}} 旨在向各个页面（主要是模板页面）添加文档块。某种语言的子页面将根据用户界面的语言加载到文档块中。如果是英文，文档将取自 /doc 子页面。但在所有其他情况下，文档将取自子页面 /doc/<lang 代码>

工具

主工具位于文档块上方的右上角：

• «创建» – 打开文档的创建页面。仅在文档未创建时显示。
• «查看» – 打开文档页面。
• «编辑» – 打开打开文档的编辑页面。
• «页面历史» – 打开文档页面的更改历史记录。

另外，在右上角有一个标有省略号 [ ... ] 的按钮。它可以展开/折叠其他工具：

• «沙盒» – 打开子页面 /sandbox 的创建页面并复制原始页面的代码，或者，如果此页面存在，则直接打开它。
• «测试用例» – 打开 /testcases 子页面。对于在不同情况下测试模板很有用。
• «子页面» – 打开 Special:PrefixIndex 并输入本页面名以搜索全部子页面。
• «清除缓存(刷新页面)» – 打开一个窗口，其中包含有关清除页面(缓存)的消息。

语言栏

在右上角的工具下，有一些标志可以将文档切换到另一种语言。切换是通过在页面链接中插入 &uselang=<语言代码> 来实现的，因此，如果您单击另一种语言，那么随着文档，界面语言将发生变化。

如果将 {{{nolang}}} 设置为 1，则可以删除语言栏。

如果没有某种语言的文档，将显示消息“文档页面 <页面> 不存在。”，并且语言标志将以红色突出显示。

参数

• {{{1}}}: 用于切换模板分配的参数：
  • 如果需要标准文档块，请不要在此参数中输入任何内容。
  • 0 – 会显示消息“这是 <页面> 的文档子页面。。”
  • 1 – 会显示消息“这是文档 <页面> 的沙盒子页面。”
  • 2 – 会显示消息“该文档不是沙盒页面。”
• {{{docpage}}}: 将用作文档的页面。
• {{{content</语言代码>}}}: 将用作文档的内容，而不是单独的页面。使用时，主工具是隐藏的。
• {{{pagespace}}}: 页面空间是自动确定的，但你可以输入自己的页面空间。标题中的文本取决于以下参数：
  • Template → “模板页面”
  • File → “摘要”
  • 其他情况下为 “文档”
• {{{nolang}}}: 如果设置为 1 则移除语言栏。
• {{{examples}}}: 可以复制并在其他页面上使用的示例请转到此处。使用时，“示例”按钮出现在文档块标题下方的左侧。

创建文档

要开始创建文档，请单击右上角的“创建”按钮。在文档的最开头，添加模板 {{doc}} 并在参数 {{{1}}} 中输入 0。之后，你将看到一条消息，指出这是一个文档子页面。为了使此消息不会出现在文档块中，应按以下方式编写：

<code style=padding:0><noinclude>{{doc|0}}</noinclude></code>

然后编写文档本身的文本。首先有一个简短的描述，然后 - 取决于编写文档的目的。 Template:Warning:zh-cn