| 此模板使用Lua语言: |
该模板用于显示代码示例,避免在同时显示代码和代码效果时,需要再复制一份代码的问题。
在此基础上,该模板能够使用wikitext以及模板(如{{color}})对展示的代码进行格式标注。
基本用法:
{{Example|pre=<nowiki>向Example模板传入示例代码('''要有nowiki'''),将呈现出一个{{荧光笔|代码块}},并且展示代码块的结果。</nowiki>}}
它的执行结果为两段,包含一段代码和一段该代码的结果:
向Example模板传入示例代码('''要有nowiki'''),将呈现出一个{{荧光笔|代码块}},并且展示代码块的结果。
向Example模板传入示例代码(要有nowiki),将呈现出一个代码块,并且展示代码块的结果。
代码展示模式决定了你的代码在展示时使用什么标签包裹。
| 模板调用 | 说明 |
|---|---|
{{Example|pre=<nowiki>代码</nowiki>}}
|
展示代码时,将代码用<pre></pre>包裹
|
{{Example|code=<nowiki>代码</nowiki>}}
|
展示代码时,将代码用<code></code>包裹
|
{{Example|bare=<nowiki>代码</nowiki>}}
|
展示代码时,不包裹代码 |
在编辑框输入:
{{example|pre=<nowiki>{{color|green|hello}}</nowiki>}}
显示为:
{{color|green|hello}}
hello
在编辑框输入:
{{example|code=<nowiki>{{color|green|hello}}</nowiki>}}
显示为:{{color|green|hello}}hello
在编辑框输入:
{{Example|bare=<nowiki>{{color|green|hello}}</nowiki>}}
显示为:{{color|green|hello}}hello
如果觉得太生硬,可以添加衔接语。
| 模板调用 | 说明 |
|---|---|
{{Example|pre/code/bare=<nowiki>代码</nowiki>|衔接语}}
|
显示为“代码 衔接语 结果” |
例如,在编辑框输入:
{{Example|code=<nowiki>{{color|green|hello}}</nowiki>|的解析结果是}}
显示为:{{color|green|hello}}的解析结果是hello
在pre/code/bare参数中,可以指定只在代码展示中出现,而不在结果展示中出现的批注。例如,可以给代码中想要强调的部分用wikitext及模板加粗、加注释、加上颜色等。为此,只需把批注放在<nowiki></nowiki>之外即可。
总之,你只要记住“只有<nowiki></nowiki>内部的代码才是我要执行的代码”。
例如,在编辑框输入:
{{example
|pre=这句话只会出现在代码展示中。
<nowiki
>{{color|</nowiki>{{color|green|<nowiki
>green</nowiki>}}<ref>这是一个在代码块中的注释。同时请注意前面绿色的“green”。</ref><nowiki
>|hello}}</nowiki>
如果太长,可以在nowiki与>之间换行以提升可读性,这不会导致多出空白字符。
}}
显示为:
这句话只会出现在代码展示中。
{{color|green[1]|hello}}
如果太长,可以在nowiki与>之间换行以提升可读性,这不会导致多出空白字符。
hello
你的模板可能接收含有<nowiki></nowiki>的内容,而你想展示它的用法。但是,Example也需要接收含有<nowiki></nowiki>的参数,可<nowiki></nowiki>内部是不能再嵌套<nowiki></nowiki>的!
这时,只需把内层的<nowiki></nowiki>改为<_nowiki></_nowiki>即可,它在展示的时候会被当作不带下划线的。你可以在<_nowiki></_nowiki>里继续嵌套,每次增加一个下划线。
| 模板调用 | 说明 |
|---|---|
{{Example|pre/code/bare=<nowiki>代码</nowiki>|echo=}}
|
显示为“代码”,没有衔接语和结果 |