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

添加3,814字节 、​ 2020年12月15日 (二) 06:47
由于LLWiki处理模板文档繁简转换的方式特殊,这里单独列为一个章节。
 
模板文档繁简转换的需求来自于两个方面,其一是模板使用的中文参数都需配备简体和繁体两个互为替代的等效参数(详见[[#代码]]章节),其二是在说明参数或是展示示例时用到的中文表达。一般情况下MediaWiki会对中文自动进行繁简转换,但使用<code>&lt;code&gt;</code>和<code>&lt;pre&gt;</code>标签(或行首空格)时,内部文本不会执行繁简转换。LLWiki为此设立了{{tl|code}}和{{tl|pre}}两个模板作为对应的HTML标签的代用品,模板的参数仍会自动执行繁简转换。这两个模板都只有一个匿名参数,且参数一般需要使用<code>&lt;nowiki&gt;</code>标签包裹。
 
{{tl|code}}和{{tl|pre}}模板和对应的HTML标签有一个极大的区别,模板参数中的Wikitext仍旧会被执行,而且即使使用转义的字符实体也往往无效(特例见附表)。例如:{{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>}}。注意与此同时被<code>&lt;nowiki&gt;</code>标签包裹的模板仍旧不会被展开。为了解决这一问题,一般需要在Wikitext语法的内部插入<code><nowiki>-{}-</nowiki></code>进行破坏。下表给出了常用Wikitext作为{{tl|code}}和{{tl|pre}}模板的参数时的对应写法。
! 描述 !! 效果 !! Wikitext !! {{tl|code}}和{{tl|pre}}的模板参数 !! 说明
|-
| 斜体文本 || ''斜体'' || {{code|&apos;'斜体'&apos;}}或<br>{{code|'-{}-'斜体'-{}-'}} || {{code|&-{}-amp;apos;'斜体'&-{}-amp;apos;}}或<br>{{code|'--{}-{}-'斜体'--{}-{}-'}} || rowspan=3 | 使用字符实体<code>&amp;apos;</code>或用<code><nowiki>-{}-</nowiki></code>将<code>'</code>分隔开,注意不要出现任意连续的两个<code>'</code>。这里<code>&amp;apos;</code>不能使用<code>&amp;#39;</code>替代。
|-
| 粗体文本 || '''粗体''' || {{code|'&apos;'粗体'&apos;'}}或<br>{{code|'-{}-'-{}-'粗体'-{}-'-{}-'}} || {{code|'&-{}-amp;apos;'粗体'&-{}-amp;apos;'}}或<br>{{code|'--{}-{}-'--{}-{}-'粗体'--{}-{}-'--{}-{}-'}}
|-
| 粗斜体文本 || '''''粗斜体''''' || {{code|'&apos;'&apos;'粗斜体'&apos;'&apos;'}}或<br>{{code|'-{}-'-{}-'-{}-'-{}-'粗斜体'-{}-'-{}-'-{}-'-{}-'}} || {{code|'&-{}-amp;apos;'&-{}-amp;apos;'粗斜体'&-{}-amp;apos;'&-{}-amp;apos;'}}或<br>{{code|'--{}-{}-'--{}-{}-'--{}-{}-'--{}-{}-'粗斜体'--{}-{}-'--{}-{}-'--{}-{}-'--{}-{}-'}}
|-
| 章节标题 ||
====4级标题====
| {{pre|<nowiki>
-{}-====4级标题====
</nowiki>}}
| {{code|<nowiki>--{}-{}-====4级标题====</nowiki>}} || rowspan=7 | 只有位于行首时才生效,此种情况下在开头加上一个<code><nowiki>-{}-</nowiki></code>即可。
|-
| 分割线 ||
----
| {{pre|
-{}-----
}}
| <code><nowiki>-{}-----</nowiki></code>
|-
| 无序列表 ||
*无序列表
| {{pre|
-{}-*无序列表
}}
| {{code|--{}-{}-*无序列表}}
|-
| 有序列表 ||
#有序列表
| {{pre|
-{}-#有序列表
}}
| {{code|--{}-{}-#有序列表}}
|-
| 定义 ||
;定义
| {{pre|
-{}-;定义
}}
| {{code|--{}-{}-;定义}}
|-
| 缩进文本 ||
:缩进
| {{pre|
-{}-:缩进
}}
| {{code|--{}-{}-:缩进}}
|-
| 预格式化文本(行首空格) ||
预格式化
| {{pre|
-{}- 预格式化
}}
| {{code|--{}-{}- 预格式化}}
|-
| 段落 || 第一段
 
第二段
| {{pre|
第一段<br>
第二段
}}
| {{pre|
第一段<-{}-br>
第二段
}}
| 其中一次换行需使用<code><-{}-br></code>标签代替。
|-
| HTML标记 || {{n/a|3=}} || 例如{{code|<!-{}--- -->}} || <code><nowiki><!-{}--- --></nowiki></code> || 在左半部分标记中插入<code><nowiki>-{}-</nowiki></code>破坏。
|-
| 特殊符号 || 如&copy; || {{code|&-{}-amp;copy;}} || <code><nowiki>&-{}-amp;copy;</nowiki></code> || 将<code>&</code>转义为<code><nowiki>&amp;amp;</nowiki></code>,并在<code>&</code>后插入<code><nowiki>-{}-</nowiki></code>破坏。
|-
| 内部链接和跨维基链接 || [[LLWiki:首页|首页]] || {{code|<nowiki>[-{}-[LLWiki:首页|首页]]</nowiki>}} || {{code|<nowiki>[--{}-{}-[LLWiki:首页|首页]]</nowiki>}} || rowspan=2 | 在左侧的<code>[[</code>中间插入<code><nowiki>-{}-</nowiki></code>破坏。
|-
| 插入图片 || [[File:Bg1.png|60px]] || <span style="white-space:nowrap">{{code|<nowiki>[-{}-[File:Bg1.png|60px]]</nowiki>}}</span> || {{code|<nowiki>[--{}-{}-[File:Bg1.png|60px]]</nowiki>}}
|-
| 外部链接 || [//llwiki.org 首页] || {{code|[-{}-//llwiki.org 首页]}} || {{code|[--{}-{}-//llwiki.org 首页]}} || 在协议之后(如果有的话)<code>//</code>之前插入<code><nowiki>-{}-</nowiki></code>破坏。
|-
| 繁简转换 || -{zh-hans:繁體;zh-hant:简体}- || {{code|--{}-{zh-hans:-{繁體}-;<br>zh-hant:-{简体}-}-}} || {{code|<nowiki>---{}-{}--{}-{zh-hans:-{繁體}-;<br>zh-hant:-{简体}-}-</nowiki>}} || 在左侧的<code><nowiki>-{</nowiki></code>中插入<code><nowiki>-{}-</nowiki></code>破坏。
|-
| 防转换 || {{lj|東京}} ||
{{code|<nowiki>{{lj|-{東京}-}}</nowiki>}}
|
{{code|<nowiki>{{lj|--{}-{-{東京}-}-}}</nowiki>}}
| 有时本不应转换的内容(如日语)需要手动添加<code><nowiki>-{}-</nowiki></code>防转换。
|-
| 表格 ||
{|class="wikitable"
! 列标题
|-
| 内容
|}
| {{pre|<nowiki>
-{}-{|class="wikitable"
-{}-! 列标题
-{}-|-
-{}-| 内容
-{}-|}
</nowiki>}}
| {{pre|<nowiki>
--{}-{}--{}-{|class="wikitable"
--{}-{}-! 列标题
--{}-{}-|-
--{}-{}-| 内容
--{}-{}-|}
</nowiki>}}
| 稳妥起见,可以在每一行的开头都插入<code><nowiki>-{}-</nowiki></code>破坏。
|}
 
16,874

个编辑