第27行: |
第27行: |
| | | |
| ===颜色=== | | ===颜色=== |
− | 在本Wiki中,您可以使用{{tl|color}}模板改变文字前景色,{{tl|bgcolor}}模板改变文字背景色,使用方法请点击模板链接查看。这不是Wiki原有的实现方法,因此在其他Wiki上可能并不适用。 | + | 在本Wiki中,您可以使用 <code>{{tl|Color}}</code> 模板改变文字前景色,<code>{{tl|Bgcolor}}</code> 模板改变文字背景色,使用方法请点击模板链接查看。这不是 Wiki 原生方法,因此在其他 Wiki 上可能并不适用。 |
| + | |
| + | 例如: |
| + | |
| + | <code><nowiki>{{Color|#0af|天蓝色的文字}}</nowiki></code> 显示为:{{Color|#0af|天蓝色的文字}} |
| + | <br /> |
| + | <code><nowiki>{{Bgcolor|#707|紫色的背景}}</nowiki></code> 显示为:{{Bgcolor|#707|紫色的背景}} |
| + | |
| + | ===行内代码和代码块=== |
| + | 在 Wiki 中没有对应的便捷语法,只能通过 HTML 标签进行定义。 |
| + | |
| + | 使用 HTML <nowiki><code></nowiki> 标签定义行内代码: |
| + | |
| + | <pre> |
| + | 这是一段行内代码 <code>This is an inline code</code> |
| + | </pre> |
| + | |
| + | 效果为: |
| + | |
| + | 这是一段行内代码 <code>This is an inline code</code> |
| + | |
| + | |
| + | 使用 HTML <nowiki><pre></nowiki> 标签定义一个多行代码块: |
| + | |
| + | <pre> |
| + | <pre> |
| + | 这是一个代码块 |
| + | </pre> |
| + | </pre> |
| + | |
| + | 效果: |
| + | <pre> |
| + | 这是一个代码块 |
| + | </pre> |
| + | |
| | | |
| ==换行与换段== | | ==换行与换段== |
第84行: |
第118行: |
| 当正文内容与标题足够多的情况下,系统会自动在第一个标题之前生成一个目录。 | | 当正文内容与标题足够多的情况下,系统会自动在第一个标题之前生成一个目录。 |
| | | |
− | (待补充)
| + | ==源代码注释== |
| + | 如果您需要为其他编辑者留下一些信息,或者暂时删掉一段不用的代码,可以使用源代码注释功能。和HTML一样,Wiki使用这种格式注释内容: |
| + | <pre> |
| + | <!-- 注释内容 --> |
| + | </pre> |
| + | |
| + | 放入注释中的内容不会被显示出来,您可以点击本页的【编辑/查看源代码】来阅读这里的隐藏信息。 |
| + | <!-- 恭喜您看到这里的隐藏信息了! --> |
| + | |
| + | ==注释&引用&参考文献== |
| + | {{Main|帮助:插入注释}} |
| + | |
| + | 和上面的源代码注释意义不同,这里是真正意义上的注释。在Wiki中,如果要对某处添加注释,可以使用<code><nowiki><ref></nowiki></code>标签,简单使用方法如下: |
| + | <pre><ref>注释内容</ref></pre> |
| + | |
| + | 插入注释以后,注释内容会自动在页面底部生成,当然您也可以使用<code><nowiki><references /></nowiki></code>标签手动指定注释列表生成的位置,一般放置在页面底部。 |
| + | |
| + | 在注释中,您可以插入一段话,也可以插入一个链接。例如: |
| + | |
| + | <pre> |
| + | 您可以点击右上角的注释角标定位到注释列表。<ref>也可以点击左侧的箭头返回注释的位置。</ref>您也可以在注释中插入链接。<ref>[https://en.wikipedia.org/ 维基百科]</ref> |
| + | </pre> |
| + | |
| + | 您可以点击右上角的注释角标定位到注释列表。<ref>也可以点击左侧的箭头返回注释的位置。</ref>您也可以在注释中插入链接。<ref>[https://en.wikipedia.org/ 维基百科]</ref> |
| + | |
| + | ==注释示例== |
| + | <references /> |
| + | |
| + | ==模板== |
| + | 繁琐重复的代码不利于理解和维护,如果将其包装为一个模板,就可以方便的使用,同时也更利于理解。在语音维基中,模板是一种重要的工具。 |
| + | |
| + | 上文中提到的{{tl|Color}}就是一种模板。同样的,把这个模板以特定格式显示在这里的{{tl|tl}}模板也是一种模板。如果点击前面的模板链接,可以看到模板的页面地址格式是“模板:''模板名''”。 |
| + | |
| + | 如果我们把{{tl|tl}}拆开来可以看到以下代码: |
| + | <pre> |
| + | {{{{ {{{|safesubst:}}}#if:{{{3|}}}|{{{3|}}}:|}}[[{{ {{{|safesubst:}}}ns:Template}}:{{{1}}}|{{{1}}}]]{{ {{{|safesubst:}}}#if:{{{2|{{{arg|}}}}}}|{{!}}{{{2|{{{arg}}}}}}}}}} |
| + | </pre> |
| + | |
| + | 显然这段代码十分不利于阅读、使用和维护,而模板的作用就是简化这一过程。 |
| + | |
| + | 事实上,如果你急于完成入门学习的话,这个章节可以以后再看,因为模板文档会告诉你如何使用模板,例如{{tl|color}}。 |
| + | |
| + | ===使用模板和赋予参数=== |
| + | |
| + | 例如,我们可以这样使用这个模板:<code><nowiki>{{tl|color}}</nowiki></code> 来显示这样的效果:{{tl|color}} |
| + | |
| + | 在上面这个例子中,名为tl的模板接受了一个参数:color |
| + | |
| + | 当然模板还可以接受更多的参数,例如:<code><nowiki>{{tl|Color|#fff}}</nowiki></code> 显示为:{{tl|Color|#fff}} |
| + | |
| + | 模板也可以不接受参数,就像这样:{{tl|color}} |
| + | |
| + | 当然,这么做对于一些必须接受参数的模板来说会出现问题,不过也有些模板不需要接受参数就可以使用。 |
| + | |
| + | 那么问题来了:我不想指定第一个参数,只想指定第二个参数,该如何编写呢?方法很简单:<code><nowiki>{{tl|2=#FFF}}</nowiki></code> |
| + | |
| + | “2”代表第二个参数,因为这个参数没有被命名,所以称之为匿名参数。使用等于号将右侧的内容赋值给这个参数。 |
| + | |
| + | 总而言之,使用匿名参数的模板的使用方式可总结为: |
| + | |
| + | <pre> |
| + | {{模板名}} |
| + | {{模板名|参数1}} |
| + | {{模板名|参数1|参数2}} |
| + | {{模板名|1=参数1|2=参数2}} |
| + | {{模板名|参数1|参数2|...|参数N}} |
| + | </pre> |
| + | |
| + | 有匿名参数,当然也会有非匿名参数。 |
| + | |
| + | 例如,在{{tl|Info}}模板中,定义了width、title、text等参数。使用方法为: |
| + | <pre> |
| + | {{info|width=50%|title=标题|text=文本}} |
| + | </pre> |
| + | |
| + | 也可以写成多行样式,易于阅读: |
| + | <pre> |
| + | {{info |
| + | |width=50% |
| + | |title=标题 |
| + | |text=文本 |
| + | }} |
| + | </pre> |
| + | |
| + | 需要注意的是,这些参数不能以匿名参数的方式使用,例如你不能用“1”或不填写参数名的第一个参数去指代“width”,这些模板在设计的时候可能会考虑快速使用的情况,因此具体如何使用还需阅读随附于模板页面的模板文档。 |
| + | |
| + | 总而言之,使用非匿名参数的模板的使用方式可总结为: |
| + | <pre> |
| + | {{模板名}} |
| + | {{模板名|参数名1=参数值1}} |
| + | {{模板名|参数名1=参数值1|参数名2=参数值2}} |
| + | {{模板名|参数名1=参数值1|参数名2=参数值2|...|参数名N=参数值N}} |
| + | </pre> |
| + | |
| + | ===关于模板的一些细节=== |
| + | * 同一个页面中重复使用同一个模板不会产生参数冲突。<s>除非模板的设计者干了件蠢事。</s> |
| + | * 模板参数支持输入多行数据。 |
| + | * 如果你发现匿名参数在处理多行数据时出现了点小问题,试试给他加上参数名。 |
| + | |
| + | ==另见== |
| + | * [[帮助:索引]] |
| + | * [[帮助:Wiki名词解释]] |
| | | |
| [[分类:Wiki帮助]] | | [[分类:Wiki帮助]] |