1 生成目录

使用这条命令可以生成当前页面的目录:

#LIST: toc

#List 命令还支持许多功能,例如生成当前页面的表格列表、图片列表等,更多功能请参看 deplate 附带的用户手册。

2 纯文本片段

如果你需要将一段纯文本片段直接贴入 ViKi,忽略所有的 ViKi 语法,你就可以使用 Verbatim 宏。

Verbatim 宏的语法是:

#Verbatim <<结束符
任意文本
结束符

结束符可以是文本中不出现的任意字符串,例如,如果我们采用“EOC”作为结束符,则可以这样编写代码:

#Verbatim <<EOC
任意文字
EOC

一般情况下,滇狐个人习惯使用三个减号作为结束符“---”,示例代码如下:

#Verbatim <<---
这里是 Verbatim 环境!

该环境中的所有换行、空格,
    都会被原样保留。
该环境中的所有 ViKi 语句,
    都被忽略。

换句话说,
Verbatim 环境中的所有内容都被原样照抄,
    ** 不会做任何处理。**

在许多模板下,
Verbatim 环境都会被一个框包含起来,
    并且使用等宽字体。
滇狐自己的模板也是这样的。
---

效果如下:

这里是 Verbatim 环境!

该环境中的所有换行、空格,
    都会被原样保留。
该环境中的所有 ViKi 语句,
    都被忽略。

换句话说,
Verbatim 环境中的所有内容都被原样照抄,
    ** 不会做任何处理。**

在许多模板下,
Verbatim 环境都会被一个框包含起来,
    并且使用等宽字体。
滇狐自己的模板也是这样的。

3 代码片段

在 ViKi 中插入代码片段的时候,使用 Code 环境可以获得语法加亮效果,方便网页访问者阅读。

Code 宏的语法是:

#Code syntax=语法 <<结束符
任意文本
结束符

关于结束符的定义,请参看前一节。

下面是在网页中插入 C++ 代码片段的例子:

#Code syntax=cpp <<---
#include <iostream>

int main(void)
{
    std::cout << "Hello, world!" << std::endl;
    return 0;
}
---

效果如下:

#include <iostream>

int main(void)
{
    std::cout << "Hello, world!" << std::endl;
    return 0;
}

如果你使用 code-vim73.rb 插件实现语法加亮的话,你可以获得数不胜数的语法加亮文件格式。如果你不知道需要被加亮的文件格式的 syntax 是什么的话,你可以用 gvim 打开该文件,然后在 Normal 状态下输入:

:set ft?

回车后 gvim 的状态栏上就会显示出当前的 syntax 格式。

例如,当你用 gvim 打开 smb.conf 文件,并输入上述语句时,gvim 的状态栏上将会显示:

  filetype=samba

因此,当你需要在你的 ViKi 页中粘贴 smb.conf 的代码片段时,你就可以使用“syntax=samba”的 Code 环境。

4 嵌入 HTML

ViKi 并不是万能的,有的时候,你也许希望能够通过直接编写 HTML 增强页面的功能。ViKi 允许你直接使用 HTML。

插入 HTML 的语法如下:

#Native fmt=html <<结束符
任意 HTML 代码
结束符

关于结束符的定义,请参看前两节。

例如,我们使用以下代码实现背景加亮的闪烁文本。注意:闪烁效果在 Microsoft Internet Explorer 下无效,请使用 Firefox。

#Native fmt=html <<---
这是一段<span style="background-color: red; color: #00ffff">
<blink>
会闪烁
</blink>
</span>
的文本!!
---

效果如下:

这是一段 会闪烁 的文本!!