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

“LLWiki:模板指引”的版本间差异

跳转到导航 跳转到搜索
本指引描述LLWiki的模板页面普遍遵循的格式。
 
LLWiki的模板(Template)页面一般分为三个组成部分,依次为(1)模板文档、(2)以分类为主的其他不可见的<code>&lt;noinclude&gt;</code>内容和(3)模板代码。前两项总是包裹在<code>&lt;noinclude&gt;</code>标签内,模板引用时会被忽略。
{{目录右置}}
==文档==
以下是一个模板文档页(<code><nowiki>{{doc|Template:AS song/doc}}</nowiki></code>)的实际例子。{{doc|Template:AS song/doc}}
 
模板文档通常包含以下全部内容:(1)用途描述、(2)参数列表和说明,以及(3)各种用法示例。必要的时候还需要添加特别注意事项。以上这些要素在上面的实际例子中都可以找到。如果模板引用自其他版权协议兼容的网站,还需要在{{code|<nowiki>外部链接</nowiki>}}章节中使用{{tl|CCnotice}}模板说明。
 
===繁简转换===
由于LLWiki处理模板文档繁简转换的方式特殊,这里单独列为一个章节。
 
模板文档繁简转换的需求来自于两个方面,其一是模板使用的中文参数都需配备简体和繁体两个互为替代的等效参数(详见[[#代码]]章节),其二是在说明参数或是展示示例时用到的中文表达。一般情况下MediaWiki会对中文自动进行繁简转换,但使用{{ce|<code>}}&lt;code&gt;</code>{{ce|<code>&lt;pre&gt;</code>}}标签时,内部文本不会执行繁简转换。LLWiki为此设立了{{tl|code}}和{{tl|pre}}两个模板作为对应的HTML标签的代用品,模板的参数仍会自动执行繁简转换。这两个模板都只有一个匿名参数,且参数一般需要使用<code>&lt;nowiki&gt;</code>标签包裹。
 
{{tl|code}}和{{tl|pre}}模板和对应的HTML标签有一个极大的区别,模板参数中的Wikitext仍旧会被执行,而且即使使用转义的HTML字符实体也往往无效(特例见附表)。例如:{{code|<nowiki>{{code|<-{}-nowiki>&-{}-amp;lt;span style="font-style:italic"&-{}-amp;gt;&-{}-amp;#39;&-{}-amp;#39;&-{}-amp;#39;{{color|red|文本}}&-{}-amp;#39;&-{}-amp;#39;&-{}-amp;#39;&-{}-amp;lt;/span&-{}-amp;gt;<-{}-/nowiki>}}</nowiki>}}的效果为{{code|<nowiki>&lt;span style="font-style:italic"&gt;&#39;&#39;&#39;{{color|red|文本}}&#39;&#39;&#39;&lt;/span&gt;</nowiki>}}。注意与此同时被{{ce|<code>&lt;nowiki&gt;</code>}}标签包裹的模板仍旧不会被展开。为了解决这一问题,一般需要在Wikitext语法的内部插入<code><nowiki>-{{ce|{}}}-</nowiki></code>进行破坏。下表给出了常用Wikitext作为{{tl|code}}和{{tl|pre}}模板的参数时的对应写法。
 
{| class="wikitable"
! 描述 !! 效果 !! Wikitext !! {{tl|code}}和{{tl|pre}}的模板参数 !! 说明
|-
| 斜体文本 || ''斜体'' || {{code|&apos;'斜体'&apos;}}或<br>{{code|'-{}-'斜体'-{}-'}} || {{code|&-{}-amp;apos;'斜体'&-{}-amp;apos;}}或<br>{{code|'--{}-{}-'斜体'--{}-{}-'}} || 使用字符实体<code>&amp;apos;</code>或用<code><nowiki>-{}-</nowiki></code>将<code>'</code>分隔开
|}
 
==分类==