这个页面为wikidot使用的维基语法的简单说明与演示。
本文内容来自官方文档的翻译,部分翻译参考了SCP基金会中文分部的翻译以及虎鲸图书馆的翻译。
注意:SCP基金会与虎鲸图书馆的版式基于Sigma-9,部分语法可能无法在Black Gray White World wiki正常运行。本页面列出的语法全部可在Black Gray White World wiki正常运行。
行内格式
语法 | 效果 |
---|---|
**粗体** | 粗体 |
//斜体// | 斜体 |
__下划线__ | 下划线 |
--删除线-- | 删除线 |
{{teletype text(英文等宽字)}} | teletype text(英文等宽字) |
正常^^上标^^ | 正常上标 |
正常,,下标,, | 正常下标 |
[!-- 不可见注释 --] | |
[[span style="color:red"]]自定义//span//元素[[/span]] | 自定义span元素 |
##blue|预设## 或 ##44FF88|自定义色码## 颜色 | 预设 或 自定义色码 颜色 |
[[span class="ruby"]]正文文字[[span class="rt"]]拼音或顶标内容[[/span]][[/span]] | 正文文字拼音或顶标内容 |
@ @ 不解析文字(**示例**) @ @ | 不解析文字(**示例**) |
*请注意,为了避免解析,两个@和文本之间不应有空格。由于@@未能自行逃脱解析,因此如上所写。
字体大小
字体大小可以用 [[size …]] … [[/size]]设定。
相对字体大小
此语法基于当前字体改变大小。语法 | 效果 |
---|---|
[[size smaller]]更小的字[[/size]] | 更小的字 |
[[size larger]]更大的字[[/size]] | 更大的字 |
[[size 80%]]80%当前大小[[/size]]}} | 80%当前大小 |
[[size 100%]]100%当前大小[[/size]] | 100%当前大小 |
[[size 150%]]150%当前大小[[/size]] | 150%当前大小 |
[[size 0.8em]]80%当前大小[[/size]] | 80%当前大小 |
[[size 1em]]100%当前大小[[/size]] | 100%当前大小 |
[[size 1.5em]]150%当前大小[[/size]] | 150%当前大小 |
绝对字体大小
此语法不基于当前字体,而是直接改变字体的大小。语法 | 效果 |
---|---|
[[size xx-small]]微型字[[/size]] | 微型字 |
[[size x-small]]超小型字[[/size]] | 超小型字 |
[[size small]]小型字[[/size]] | 小型字 |
[[size large]]大型字[[/size]] | 大型字 |
[[size x-large]]超大型字[[/size]] | 超大型字 |
[[size xx-large]]巨型字[[/size]] | 巨型字 |
[[size 7px]]7像素大小字型[[/size]] | 7像素大小字型 |
[[size 18.75px]]18.75像素大小字型[[/size]] | 18.75像素大小字型 |
可折叠模块
[[collapsible]]能让你在点击指定文字时显示/隐藏一段文字。
[[collapsible show="+ 显示" hide="- 隐藏"]]
这是示例代码,“+ 显示”“- 隐藏”的部分可以自定义。
[[/collapsible]]
如果折叠内容过长,可以使用hideLocation="both"在折叠文本底部显示隐藏链接按钮。
[[collapsible hideLocation="both" show="+ 显示" hide="- 隐藏"]]
比如说
就像
在写现代诗
的样子
这么长
[[/collapsible]]
脚注
脚注有助于在文本中插入更多信息而不会使文本混乱。
插入[[footnoteblock]]确定脚注的位置。否则,脚注将出现在页面底部。需要注意的是,一个页面能够正常工作的[[footnoteblock]]只有一个,多余的[[footnoteblock]]将不会被解析。
嗟夫!予尝求古仁人之心,或异二者之为,何哉?[[footnote]]本文出自《岳阳楼记》[[/footnote]]
不以物喜,不以己悲,居庙堂之高则忧其民,处江湖之远则忧其君。
是进亦忧,退亦忧。然则何时而乐耶?
其必曰“先天下之忧而忧,后天下之乐而乐”乎!
噫!微斯人,吾谁与归?[[footnote]]时六年九月十五日。[[/footnote]]
[[footnoteblock]]
多余的[[footnoteblock]]将不会被解析。
嗟夫!予尝求古仁人之心,或异二者之为,何哉?1
不以物喜,不以己悲,居庙堂之高则忧其民,处江湖之远则忧其君。
是进亦忧,退亦忧。然则何时而乐耶?
其必曰“先天下之忧而忧,后天下之乐而乐”乎!
噫!微斯人,吾谁与归?2
多余的[[footnoteblock]]将不会被解析。
引用方块
在每行开头加上一个或以上的'>'再加上空格就能用引用方块括住文字。在文里加上"\"就能把句子分行存放方便编辑,显示出来时仍然是连在一起。
《陋室铭》
> 山不在高,有仙则名。水不在深,有龙则灵。\
斯是陋室,惟吾德馨。苔痕上阶绿,草色入帘青。\
谈笑有鸿儒,往来无白丁。可以调素琴,阅金经。
>> 无丝竹之乱耳,无案牍之劳形。
>>> 南阳诸葛庐,西蜀子云亭。
> 孔子云:
>
> 何陋之有?
加入多个'>'之后可以得到类似套娃的效果。
《陋室铭》
山不在高,有仙则名。水不在深,有龙则灵。斯是陋室,惟吾德馨。苔痕上阶绿,草色入帘青。谈笑有鸿儒,往来无白丁。可以调素琴,阅金经。
无丝竹之乱耳,无案牍之劳形。
南阳诸葛庐,西蜀子云亭。
孔子云:
何陋之有?
加入多个'>'之后可以得到类似套娃的效果。
此外,在Black Gray White World wiki,亦可使用[[div class="blockquote"]]制作引用方块,外观格式与上文相同:
《陋室铭》
[[div class="blockquote"]]
山不在高,有仙则名。水不在深,有龙则灵。斯是陋室,惟吾德馨。苔痕上阶绿,草色入帘青。谈笑有鸿儒,往来无白丁。可以调素琴,阅金经。
[[div class="blockquote"]]
无丝竹之乱耳,无案牍之劳形。
[[div class="blockquote"]]
南阳诸葛庐,西蜀子云亭。
[[/div]]
[[/div]]
孔子云:
何陋之有?
[[/div]]
使用{{@@[[div]]@@}}同样可以制造类似套娃的效果。{{@@[[div]]@@}}的详细使用方法将在下文介绍。
《陋室铭》
山不在高,有仙则名。水不在深,有龙则灵。斯是陋室,惟吾德馨。苔痕上阶绿,草色入帘青。谈笑有鸿儒,往来无白丁。可以调素琴,阅金经。
无丝竹之乱耳,无案牍之劳形。
南阳诸葛庐,西蜀子云亭。
孔子云:
何陋之有?
使用[[div]]同样可以制造类似套娃的效果。[[div]]的详细使用方法将在下文介绍。
选项卡视图(TabView)
选项卡视图允许在单个页面创建多个选项卡。
需要注意的是,选项卡视图会使目录、锚点和返回按钮失效。
[[tabview]]
[[tab 我是选项卡]]
我是选项卡的内容
[[/tab]]
[[tab 我也是选项卡]]
选项卡内部可以装下所有内容。
[[collapsible show="+ 就像这样" hide="- 点我折叠"]]
折叠块和表格都没问题。
[[/collapsible]]
[[/tab]]
[[tab 我还是选项卡]]
||~ 你可以 ||~ 创建多个 ||~ 选项卡 ||
|| 里面的 || 内容也 || 可以自定义 ||
|| 表格的语法 || 在下文 || 会介绍 ||
[[/tab]]
[[/tabview]]
表格
以下为标准3*5示例表格。
你可以用||在同一行创建新的表格。
||~ 标题格式单元格 ||~ 标题格式单元格 ||~ 标题格式单元格 ||
|| 非格式化单元格 || 非格式化单元格 || 非格式化单元格 ||
||< 左对齐单元格 ||< 左对齐单元格 ||< 左对齐单元格 ||
||> 右对齐单元格 ||> 右对齐单元格 ||> 右对齐单元格 ||
||= 居中对齐单元格 ||= 居中对齐单元格 ||= 居中对齐单元格||
标题格式单元格 | 标题格式单元格 | 标题格式单元格 |
---|---|---|
非格式化单元格 | 非格式化单元格 | 非格式化单元格 |
左对齐单元格 | 左对齐单元格 | 左对齐单元格 |
右对齐单元格 | 右对齐单元格 | 右对齐单元格 |
居中对齐单元格 | 居中对齐单元格 | 居中对齐单元格 |
你也可以使用更复杂的方式创建更复杂的表格,如下所示。
||~ 标题 ||~ 标题 ||~ 标题 ||~ 标题 ||
|| 这一行 || 是标准大小的 || 单元格 || 的示例 ||
|||| 空内容单元格会自动合并 || 像左边这样 || 创建长单元格 ||
|| 同理 |||| 这种长单元格可以 || 出现在中间 ||
|| 甚至 || 出现在 |||| 右边||
|||||||| 行尾加入空格和下划线('{{@@ _@@}}')可以开新的一行 _
就像这样||
||||||多个单元格的合并 _
可能带来意想不到的效果||也许吧||
标题 | 标题 | 标题 | 标题 |
---|---|---|---|
这一行 | 是标准大小的 | 单元格 | 的示例 |
空内容单元格会自动合并 | 像左边这样 | 创建长单元格 | |
同理 | 这种长单元格可以 | 出现在中间 | |
甚至 | 出现在 | 右边 | |
行尾加入空格和下划线(' _')可以开新的一行 就像这样 |
|||
多个单元格的合并 可能带来意想不到的效果 |
也许吧 |
标题
在每行开头加上"+"号就能将之变成标题,加号的数量决定标题的等级。
+ 1级标题
++ 2级标题
+++ 3级标题
++++ 4级标题
+++++ 5级标题
++++++ 6级标题
1级标题
2级标题
3级标题
4级标题
5级标题
6级标题
目录
要创建每个标题的列表以及指向该标题的链接,请在其自己的行上放置目录标记。
[[toc]]
[[f>toc]] - 靠右的目录
[[f<toc]] - 靠左的目录
请注意,目录会创建一个名为“#toc”的书签。
如果您希望特定标题不出现在目录中,请在加号后附加一个星号,如下所示:
+ 这个标题不会出现在目录里
+* 而这不会出现
++* 这也不会
你可能注意到了,上文“标题”段落中出现的示例标题全都没有出现在目录中——因为它们的源代码都在加号后附加了星号。
分割线
可以用4个以上半角减号/连字符(-)创建水平分割线,4个、5个、6个甚至更多连字符创建的分割线效果均一致。
----
-----
------
列表
有序列表
在每行开始加"#"制作有序列表。在"#"前面加空格可以缩进一格。
# 这是项目1
# 这是项目2
# 这是项目2.1
# 这是项目2.2
# 这是项目3, _
加入空格和下划线可以在有序列表内部换行
# 这是项目4
- 这是项目1
- 这是项目2
- 这是项目2.1
- 这是项目2.2
- 这是项目3,
加入空格和下划线可以在有序列表内部换行 - 这是项目4
无序列表
同理,在每行开始加"*"可制作无序列表。
* 请注意
* 这些列表
* 前面标的是圆点,而非数字
* 和有序列表一样,使用空格和下划线 _
也可以进行换行
* 原理是差不多的
- 请注意
- 这些列表
- 前面标的是圆点,而非数字
- 和有序列表一样,使用空格和下划线
也可以进行换行 - 原理是差不多的
链接
外部URL会直接显示为链接。
http://www.wikidot.com - http://www.wikidot.com
你可以用以下代码自定义链接显示的文字。
[http://www.wikidot.com Wikidot官网] - Wikidot官网
链接内部页面时,请使用三个中括号。默认情况下将显示目标页面的标题。
例如[[[wiki-syntax]]]。 - 例如wiki-syntax。
如果页面标题和你想使用的链接文字不同,请使用以下代码:
[[[wiki-syntax|自定义文本。]]]就像这个样子。 - 自定义文本。就像这个样子。
在 URL 前添加星号 (*) 会在新窗口中打开链接:
*http://www.wikidot.com - http://www.wikidot.com
[*http://www.wikidot.com Wikidot官网] - Wikidot官网
格式要素
左、右、居中、左右对齐
语法 | 说明 |
---|---|
[[<]] … [[/<]] |
左对齐 |
[[>]] … [[/>]] |
右对齐 |
[[=]] … [[/=]] |
居中对齐 |
[[==]] … [[/==]] |
左右对齐 |
举例:
[[=]]
**《念奴娇·赤壁怀古》**
大江东去,浪淘尽,千古风流人物。
故垒西边,人道是,三国周郎赤壁。
乱石穿空,惊涛拍岸,卷起千堆雪。
江山如画,一时多少豪杰。
遥想公瑾当年,小乔初嫁了,雄姿英发。
羽扇纶巾,谈笑间,樯橹灰飞烟灭。
故国神游,多情应笑我,早生华发。
人生如梦,一尊还酹江月。
[[/=]]
《念奴娇·赤壁怀古》
大江东去,浪淘尽,千古风流人物。
故垒西边,人道是,三国周郎赤壁。
乱石穿空,惊涛拍岸,卷起千堆雪。
江山如画,一时多少豪杰。
遥想公瑾当年,小乔初嫁了,雄姿英发。
羽扇纶巾,谈笑间,樯橹灰飞烟灭。
故国神游,多情应笑我,早生华发。
人生如梦,一尊还酹江月。
注意:对齐格式标签必须另起一行,后面不能有任何内容,包括空格。
此外,你也可以使用下列语法让单行内容居中:
= 我是一行居中内容。
我是一行居中内容。
自定义[[div]]块
[[div]]...[[/div]]的使用方法与html的 <div>...</div> 类似。你可以在这里参考相关内容。
wikidot的[[div]]块支持的属性有id、class、style、data-。要想使用这些属性,必须提前定义相应的类。如果你有一定的CSS基础,也可以使用[[module CSS]]临时定义[[div]]块支持的属性。
这是在Black Gray White World wiki可用的[[div]]块的一个例子:
[[div class="blockquote"]]
这就是上文所述的{{@@[[div]]@@}}格式的引用方块。
这种方法比起原版的每行前面加{{@@> @@}},在长段文字需要引用时优势更大。
[[/div]]
这就是上文所述的[[div]]格式的引用方块。
这种方法比起原版的每行前面加> ,在长段文字需要引用时优势更大。