LLWiki正在建设中，欢迎加入我们！

本页使用了标题或全文手工转换

LLWiki:模板指引

来自LLWiki
跳转到导航 跳转到搜索
提示：本页面的主题不是帮助:模板。

本指引描述LLWiki的模板页面普遍遵循的格式。

LLWiki的模板（Template）页面一般分为三个组成部分，依次为（1）模板文档、（2）以分类为主的其他不可见的<noinclude>内容和（3）模板代码。前两项总是包裹在<noinclude>标签内，模板引用时会被忽略。

文档

模板文档总是通过{{Documentation}}呈现。简短的文档可以使用{{Documentation}}的content参数直接书写在当前页面内，较长的文档则应单独置于模板文档页。模板文档页的页面名称应为“模板页面名称 + /doc”，如Template:Lyrics的文档页位于Template:Lyrics/doc。多个模板共用同一个文档页时，页面名称不对应的模板页需使用{{Documentation}}的1参数（可以使用匿名写法）。Template:Documentation页面给出了几个简单的用法示例。

以下是一个模板文档页（{{doc|Template:AS song/doc}}）的实际例子。

Template-info.png 文档
[查看] [编辑] [历史] [刷新]
这个文档嵌入自Template:AS song/doc。
本页使用了标题或全文手工转换

此模板用于列出LoveLive!学园偶像祭ALL STARS中的歌曲资讯。

若模板下的文字的排版走了样，请在本模板下方加上{{clear|left}}。

使用时若没有对应难度请直接删去对应行。

参数

{{AS song
|歌名=
|Image=
|属性=
|初级LIVE力=
|初级体力=
|初级S分数=
|中级LIVE力=
|中级体力=
|中级S分数=
|上级LIVE力=
|上级体力=
|上级S分数=
|上级+属性=
|上级+LIVE力=
|上级+体力=
|上级+S分数=
|Challenge属性=
|Challenge LIVE力=
|Challenge体力=
|Challenge S分数=
|配信时间=
}}

示例

Love U my friends.png
 推荐 演唱会能力 体力 S等级分数
Attrib-甜美.png 初级 3200 24300 700000
Attrib-甜美.png 中级 6700 51300 2205000
Attrib-甜美.png 上级 12000 90000 7874000
Attrib-甜美.png 上级+ 19000 144000 29280000
Attrib-自然.png 挑战 22000 171000 48000000
配信时间：
开服（1章Stage1）
{{AS song
|歌名=Love U my friends
|Image=Love U my friends.png
|属性=smile
|初级LIVE力=3200
|初级体力=24300
|初级S分数=700000
|中级LIVE力=6700
|中级体力=51300
|中级S分数=2205000
|上级LIVE力=12000
|上级体力=90000
|上级S分数=7874000
|上级+属性=smile
|上级+LIVE力=19000
|上级+体力=144000
|上级+S分数=2928000
|Challenge属性=natural
|Challenge LIVE力=22000
|Challeng体力=171000
|Challenge S分数=48000000
|配信时间=开服（1章Stage1）
}}{{clear|left}}
Fantastic Departure!.png
 推荐 演唱会能力 体力 S等级分数
Attrib-优雅.png 初级 1450 10800 371000
Attrib-优雅.png 中级 3650 27900 1309000
Attrib-优雅.png 上级 6700 51300 4280000
- 上级+ - - -
- 挑战 - - -
配信时间：
2020年07月22日15:00至今
{{AS song
|歌名=Fantastic Departure!
|Image=Fantastic Departure!.png
|属性=elegant
|上级+属性=
|初级LIVE力=1450
|初级体力=10800
|初级S分数=371000
|中级LIVE力=3650
|中级体力=27900
|中级S分数=1309000
|上级LIVE力=6700
|上级体力=51300
|上级S分数=4280000
|配信时间=2020年{{0}}7月22日15:00至今
}}

模板文档通常包含以下全部内容：（1）用途描述、（2）参数列表和说明，以及（3）各种用法示例。必要的时候还需要添加特别注意事项。以上这些要素在上面的实际例子中都可以找到。如果模板引用自其他版权协议兼容的网站，还需要在外部链接章节中使用{{CCnotice}}模板说明。

繁简转换

由于LLWiki处理模板文档繁简转换的方式特殊，这里单独列为一个章节。

模板文档繁简转换的需求来自于两个方面，其一是模板使用的中文参数都需配备简体和繁体两个互为替代的等效参数（详见#代码章节），其二是在说明参数或是展示示例时用到的中文表达。一般情况下MediaWiki会对中文自动进行繁简转换，但使用<code>和<pre>标签（或行首空格）时，内部文本通常不会执行繁简转换。如果需要让标签内的文本实现繁简转换，可以在开头添加-{}-，如<pre>-{}-内容</pre>。<code>标签内的文本繁简转换还可以通过给标签加上任意的语言属性来实现，如<code lang="mw">字体</code>，但注意这只适用于<code>标签内没有额外套<nowiki>的情形。

除了上述方法外，LLWiki还设立了{{code}}和{{pre}}两个模板作为对应的HTML标签的代用品，模板的参数仍会自动执行繁简转换。这两个模板都只有一个匿名参数，且参数一般需要使用<nowiki>标签包裹。

{{code}}和{{pre}}模板和对应的HTML标签有一个极大的区别，模板参数中的Wikitext仍旧会被执行，而且即使使用转义的字符实体也往往无效（特例见附表）。例如：

{{code|<nowiki>&lt;span style="font-style:italic"&gt;&#39;&#39;&#39;{{color|red|文本}}&#39;&#39;&#39;&lt;/span&gt;</nowiki>}}

的效果为{{color|red|文本}}。注意与此同时被<nowiki>标签包裹的模板仍旧不会被展开。为了解决这一问题，一般需要在Wikitext语法的内部插入-{}-进行破坏。下表给出了常用Wikitext作为{{code}}和{{pre}}模板的参数时的对应写法。

描述 Wikitext {{code}}和{{pre}}的模板参数 说明
状态开关 __TOC__ _-{}-_TOC__ 在任意位置插入-{}-破坏。
斜体文本 ''斜体'' &apos;'斜体'&apos;或
'-{}-'斜体'-{}-'		 使用字符实体&apos;或用-{}-将'分隔开，注意不要出现任意连续的两个'。这里&apos;不能使用&#39;替代。
粗体文本 '''粗体''' '&apos;'粗体'&apos;'或
'-{}-'-{}-'粗体'-{}-'-{}-'
粗斜体文本 '''''粗斜体''''' '&apos;'&apos;'粗斜体'&apos;'&apos;'或
'-{}-'-{}-'-{}-'-{}-'粗斜体'-{}-'-{}-'-{}-'-{}-'
章节标题 
====4级标题====
-{}-====4级标题==== 只有位于行首时才生效，此种情况下在开头加上一个-{}-即可。
分割线 
----
-{}-----
无序列表 
*无序列表
-{}-*无序列表
有序列表 
#有序列表
-{}-#有序列表
定义 
;定义
-{}-;定义
缩进文本 
:缩进
-{}-:缩进
预格式化文本（行首空格） 
 预格式化
-{}- 预格式化或
&nbsp;预格式化
段落 
第一段

第二段

第一段<br>
第二段
其中一次换行需使用<br>标签代替。
HTML标记 例如<!-- --> <!-{}--- -->或
&amp;lt;!-- --&amp;gt;		 在左半部分标记中插入-{}-破坏。
特殊符号 &copy; &-{}-amp;copy; 将&转义为&amp;，并在&后插入-{}-破坏。
内部链接和跨维基链接 [[首页]] [-{}-[首页]] 在左侧的[[中间插入-{}-破坏。
插入图片 [[File:Bg1.png]] [-{}-[File:Bg1.png]]
分类 [[Category:文件]] [-{}-[Category:文件]]
外部链接 [//llwiki.org 首页] [-{}-//llwiki.org 首页] 在协议之后（如果有的话）//之前插入-{}-破坏。
繁简转换 -{zh-hans:繁體;
zh-hant:简体}-		 --{}-{zh-hans:-{繁體}-;
zh-hant:-{简体}-}-		 在左侧的-{中插入-{}-破坏。
防转换

東京

-{東京}-

有时本不应转换的内容（如日语）需要手动添加-{}-防转换。注意上例中也使用了这一技巧。
表格 
{|class="wikitable"
! 列标题
|-
| 内容
|}

-{}-{|class="wikitable"
-{}-! 列标题
-{}-|-
-{}-| 内容
-{}-|}
稳妥起见，可以在每一行的开头都插入-{}-破坏。

最后通过两组示例来展示使用{{pre}}、{{code}}模板或不使用模板时如何实现繁简转换，实际上方法并不唯一。

HTML标签 Wikitext 不使用模板 使用模板
pre 
{| class="wikitable"
! 内容
|-
|
;定义
:缩进
小节

小节
|}

<pre>-{}-
{| class="wikitable"
! 内容
|-
|
;定义
:缩进
小节

小节
|}</pre>

{{pre|<nowiki>
-{}-{| class="wikitable"
-{}-! 内容
-{}-|-
-{}-|
-{}-;定义
-{}-:缩进
小节<br>
小节
-{}-|}
</nowiki>}}
code

{{pre|''[[首页]]''<sup>&copy;</sup>}} 

<code lang="mw">&#123;{pre|&apos;'[-{}-[首页]]{{ce|''<sup>&amp;copy;</sup>}}}}</code>

{{code|<nowiki>{{pre|'-{}-'[-{}-[首页]]'-{}-'<-{}-sup>&-{}-amp;copy;<-{}-/sup>}}</nowiki>}}

分类

按功能分类

所有模板都一定有至少一个（一般也只有一个）功能分类。LLWiki现共有以下14种功能分类：

以下分类的优先级较高。
以下分类的优先级较低，仅在不满足前述分类的情形下考虑。

这些分类往往还会进一步细分，请根据已有分类体系和类似模板添加到合适的分类级别。

特殊分类

LLWiki现共有2种特殊分类，分别为使用Widget的模板和需要替换引用的模板。

代码

有使用次数上限的解析器函数

部分解析器函数在同一个页面内有使用次数限制，如#loop和#regex。如果一个模板需要反复调用这些解析器函数，或是一个用到这些解析器函数的模板可能会在同一个页面内反复引用，此时应当将模板改写为Lua模块。

代码展示

LLWiki在模板页面直接展示模板代码，且可以通过CodeMirror扩展（需要开启“高亮模板代码”小工具）进行语法高亮，方便用户查阅。为了防止在模板引用时错误地嵌入<pre>标签，在模板实际代码之前添加

<includeonly><!--</includeonly><pre class="wiki-highlight">-->

在代码之后添加

<!--</pre><includeonly>--></includeonly>

但需要注意的是，<pre>标签内的-{}-和<nowiki>仍会被执行，可能造成看到的代码和实际代码不符。如果遇到这种情况，应当考虑首先将代码中的<nowiki>全部改写为等效的形式（如-{}-、<nowiki/>和{{ce}}等），然后将外层的<pre class="wiki-highlight"> + </pre>更换为<code class="wiki-highlight"><nowiki> + </nowiki></code>。

结语

为方便模板页面遵照既定格式编写，LLWiki在快速编辑工具中添加了模板页面的格式框架，请参考本指引和预加载的框架填入模板文档、分类和代码这三项主要内容。如有进一步的疑问或遇到技术困难，欢迎随时在Help:互助客栈提问，将会有管理员或是其他有经验的用户提供帮助和解答。也欢迎各位用户点击站内公告的链接加入官方编辑群，在群内实时提问交流。

取自“https://llwiki.org/mediawiki/index.php?title=LLWiki:模板指引&oldid=31593”