维基语法

✍️ 指导说明

本篇文章旨在为初次接触wiki并且不知道如何使用代码的成员提供介绍说明


以下内容为Wikidot,即是这个维基所使用的系统里所有你会用的着的语法,合理使用则可以令你的文档变的精美又好看,本页内容修改自维基语法-SCP基金会


注意:自定义div部分和迭代部分之间的内容,光敏病人慎看!
注意:自定义div部分和迭代部分之间的内容,光敏病人慎看!
注意:自定义div部分和迭代部分之间的内容,光敏病人慎看!




字体

字体部分

你代码及其内容 你将看见的效果
//斜体// 斜体
**粗体** 粗体
普通^^上标^^ 普通上标
普通,,下标,, 普通下标
__底线__ 底线
--删除线-- 删除线
[!-- 不可见内容 --]
##blue|内容## 或 ##44FF88|自定义色码## 颜色 内容自定义色码 颜色
[[span class="ruby"]]彭忒希勒娅[[span class="rt"]]Penthesilea[[/span]][[/span]] 彭忒希勒娅Penthesilea

RGB颜色值与十六进制颜色码转换工具:https://www.sioe.cn/yingyong/yanse-rgb-16/#google_vignette

字体大小

字体大小可以通过 [[size 放大倍数]][[/size]]修改大小。

相对字体大小

相对字体大小基于现时的字体 — 它们放大或缩小目前的字体大小。用[[size smaller]][[size larger]][[size nem]],或[[size n%]](n是1-5位连小数点的数字)去指定相对字体大小。
你使用的代码及其内容 你将看见的效果
[[size smaller]]更小的字[[/size]] 更小的字
[[size larger]]更大的字[[/size]] 更大的字
[[size 50%]]原来大小的50%[[/size]] 原来大小的50%
[[size 80%]]原来大小的80%[[/size]] 原来大小的80%
[[size 100%]]原来大小的100%[[/size]] 原来大小的100%
[[size 150%]]原来大小的150%[[/size]] 原来大小的150%
[[size 200%]]原来大小的200%[[/size]] 原来大小的200%
[[size 0.8em]]原来大小的80%[[/size]] 原来大小的80%
[[size 1em]]原来大小的100%[[/size]] 原来大小的100%
[[size 1.5em]]原来大小的150%[[/size]] 原来大小的150%

绝对字体大小

绝对字体大小并基于现时的字体 。用 [[size xx-small]][[size x-small]][[size small]][[size large]][[size x-large]][[size xx-large]],或[[size npx]],(n是1-5位连小数点的数字)去指定绝对字体大小。
你所打的文字 你将看见的文字
[[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像素大小字型

直接显示文字

如果想直接显示语法而不是解析它,用内容最前方与最后方两个@@包围它。

这段//代码//内容**已解析**

@@这段//代码//内容**已解析**@@

以下为效果示范

这段代码内容已解析

这段//代码//内容**已解析**

[[code]]@@@@[[/code]]显示为@@@@,神奇的wiki代码(bushi)


排版

如何使用版式

使用[[include]]即可引用版式,例如

[[include :miss-zhu:theme:dark-suprematism]]

段落及换行

段落间以换行两次分隔开,换行一次则是新的一行,使用@@@@也能达到将两行割开的效果,并且间距比换行更宽些。

我多浪荡 我多肮脏

千页笔墨写我的罪状
@@@@
我的狂妄 我的思想
@@@@
附着在这丑陋的皮囊

以下为效果示范

我多浪荡 我多肮脏

千页笔墨写我的罪状

我的狂妄 我的思想

附着在这丑陋的皮囊

标点符号

你所打的 你得到的
``引号'' “引号”
`引号' ‘引号’
,,引号'' „引号”
<<引号>> «引号»
>>引号<< »引号«
点点点... 点点点…
破折 -- 号 破折 — 号

破折号两边要留空格,------的效果是类似于分割线。

隐藏内容与脚注

注释并不会出现于已编译版本上。使用[!--文字内容--]结构加上注释,就如:

[!--这段字不会被编译出来。--]

以下为脚注代码1,对应位置的脚注编号会出现在文字的右上角

[[footnote]]举例:我买光所有的炸药,却还是炸不掉他给你的碉堡[[/footnote]]
你可以用[[footnoteblock title="自定义标题"]]去更改脚注的标题或干脆去掉标题(title="")。

标题

在每行开头加上"+"号就能将之变成标题,加号的数量决定标题的等级。

+ 1级标题
++ 2级标题
+++ 3级标题
++++ 4级标题
+++++ 5级标题
++++++ 6级标题

内容列表

要列出每个标题,以及到达该处的连结,就在一行空行加上内容列表。

[[<]]
内容靠左对齐
[[/<]]

[[=]]
内容位于中央
[[/=]]

[[>]]
内容靠右对齐
[[/>]]

以下为效果示范

内容靠左对齐

内容位于中央

内容靠右对齐

值得注意的是,列表内容会出现在toc(目录)的书签上,如果不想让特定标题出现在内容列表,在"+"号后加上"*",就像:

+ 这会出现于内容列表里
+* 而这不会出现
++* 这也不会

水平分割线

用四个或以上的"-"号 (----)去拉出一条水平分割线。

列表

无序列表

在每行开始加"*"去制作列表。在"*"前面加空格可以缩进一格。

* 事项1
* 事项 2
 * 事项 2.1

以下为效果示范

  • 事项1
  • 事项2
    • 事项2.1

如果要在列表中弄一行以上,在行尾放"_"(要空格),"_"后面不能放东西。

* 事项1 _
另一行
* 事项2
 * 事项2.1

以下为效果示范

  • 事项1
    另一行
  • 事项2
    • 事项2.1

有序列表

同样,你能在每行开始加"#"去制作有数字排序的列表。

# 事项1
# 事项2
 # 事项2.1

以下为效果示范

  1. 事项1
  2. 事项2
    1. 事项2.1

如果要在列表中弄一行以上,在行尾放"_"(要空格),"_"后面不能放东西。

# 事项1 _
另一行
# 事项2
 # 事项2.1

以下为效果示范

  1. 事项1
    另一行
  2. 事项2
    1. 事项2.1

有序和无序的列表可以混用。

自定义列表

: 事项1 : Something
: 事项2 : Something else

以下为效果示范

事项1
Something
事项2
Something else

如果要在列表中弄一行以上,在行尾放"_"(要空格),"_"后面不能放东西。

: 事项1 : Something _
另一行
: 事项2 : Something else

以下为效果示范

事项1
Something
另一行
事项2
Something else

引用方块

在每行开头加上一个或以上的'>'再加上空格就能用引用方块括住文字。在文里加上"\"就能把句子分行存放方便编辑,显示出来时仍然是连在一起。

草东没有派对
> 原名草东街派对,中国台湾摇滚乐团 \
由主唱兼吉他手巫堵、吉他手筑筑、贝斯手世暄与鼓手黄士玮组成。 
>
> 他们的音乐充满了活力,草东没有派对被称作为“台湾的万能青年旅店”.
>> 巫堵:“抽烟上天堂!”
> 
>> 刘西蒙:“少抽点烟。”

以下为效果示范

草东没有派对

原名草东街派对,中国台湾摇滚乐团 由主唱兼吉他手巫堵、吉他手筑筑、贝斯手世暄与鼓手黄士玮组成。
他们的音乐充满了活力,草东没有派对被称作为“台湾的万能青年旅店”.

巫堵:“抽烟上天堂!”

刘西蒙:“少抽点烟。”

可折叠框

如果加上 folded="no" 参数进去,那该段文字会默认展开,就像内容列表一样。加上hideLocation="both"的话,就能在段落两端展开/收起文字了

[[collapsible show="+ 显示里面的东西" hide="- 隐藏里面的东西"]]
这是里面的东西
[[/collapsible]]

连结

内部连结

注意:页面名称必须为英语,如果你的页面标题是中文的话,请为它起个英语名字或其他什么英语作为页面名称。

你所打的 你所见到的 描述
[[[link-to-a-page]]] link-to-a-page 用原本的页面名称
[[[link "TO" a; pagE]]] link "TO" a; pagE 自动转换成正确的页面名称
[[[category: sample page]]] sample page 连接到带有分类的页面
[[[some page| 特定文字]]] 特定文字 使用特定文字(注:这种用法在中文wiki极重要!)
[[[wiki syntax|维基语法]]] 维基语法 连到存在的页面
[[[some page|]]] some-page 用页面名称作为连结名称
[[[wiki syntax#toc1|Section 1]]] Section 1 连到锚点
[[[wiki syntax#toc1]]] wiki syntax 连到锚点
[[[特定文字]]] 特定文字 错误的用法-这样会直接连到网站首页

一些常见的连结代码

你使用的代码 你看到的效果 描述
[[[https://miss-zhu.wikidot.com | 祝黎的小窝]]] 祝黎的小窝 命名连结
[https://miss-zhu.wikidot.com 祝黎的小窝] 祝黎的小窝 命名连结
[[[start | 主页]]] 主页 命名连结
[[[*https://miss-zhu.wikidot.com | 祝黎的小窝]]] 祝黎的小窝 命名链接,会开新窗口/分页

图片

单张图片

使用以下格式插入图片:

@@[[include :backrooms-wiki-cn:component:image-block
|name=图源
|caption=描述
|align=图片位置(left/center/right分别对应左中右)
|link=指向链接(一般可以不填)
]]@@

而图源可以用下面的其中之一:

图源 格式 例子 描述
URL 地址 任何有效的URL地址 http://www.example.com/image.jpg 显示目标网址的图片(原创页面请不要直接链接到wikidot以外的图片 )
本页附件 文件名 exampleimage.jpg 显示上传到此页的图片
他页附件 ///其他页名/文件名 /another-page/exampleimage.jpg 显示上传到其他页面的图片

以下为效果示范

example-01

这是一张示例图

此外,还有一种插图方块:

[[include component:image-block name=图源 |caption=描述 |align=位置]]

以下为效果示范

example-02

这是另一张示例图

笔记

使用 [[note]]内容[[/note]](这两个都要独自放一行) 来造一栏笔记

例子:

[[note]]
神明神明张开嘴 让我知道我是谁

他把我向天上推 掠过尘与灰

不得不停歇不停歇 黑夜在背上飞

来狂欢吧狂欢吧 永远不下坠
[[/note]]

以下为效果示范

神明神明张开嘴 让我知道我是谁

他把我向天上推 掠过尘与灰

不得不停歇不停歇 黑夜在背上飞

来狂欢吧狂欢吧 永远不下坠

表格

简单表格

你能用"||"去建立表格:

||~ 标题 1 ||~ 标题 2 ||~ 标题 3 ||
|| 内容 1 || 内容 2 || 内容 3 ||
|||| 长内容 4 || 内容 5 ||
||内容 6 |||| 长内容  7 ||
|||||| 超长 _
内容 8||
标题 1 标题 2 标题 3
内容 1 内容 2 内容 3
长内容 4 内容 5
内容 6 长内容 7
超长
内容 8

在行尾加" _"能在表格内开新行(如上例)。

用户名称

你所打的 你看到的 描述
[[user 用户名称]]
e.g. [[user MissZhu]]
MissZhu 用户信息(没头像)
[[*user 用户名称]]
e.g. [[*user MissZhu]]
MissZhuMissZhu 用户信息(连头像)

Tab view

Tab view 是一种能透过点击卷标去切换显示内容的方格。

注: TabView 会使TOC,锚点及返回接钮失效

  • 你连不上Tab里面的锚点
  • TOC不会连到Tab里的标题
  • 如果你点击tab里的连结返回,你总会看见第一个tab

要造一个tabview,即是一连串的tab,可以用以下的语法:

[[tabview]]
[[tab 皮囊]]
讨一副人血的偏方
弃则死 服则亡
我这孤独的脊梁
却充满了悲怆
[[/tab]]
[[tab 志铭]]
谁来杀死那个巨婴
吸吮着霓虹和酒精
谁来审判他的罪行
无知的正义沦为笑柄
[[/tab]]
[[tab 天才艺术家]]
我懒得说 我也懒得讲
那你就继续做你的天才艺术家
画地为牢 保持风雅
继续在那井底里孤芳自赏
[[/tab]]
[[tab 喂]]
揭开这鲜红的衣裳
露出还在流血的伤口
还要
多少血肉才够你们瓜分
再丢弃吃剩的烂骨头
[[/tab]]
[[/tabview]]

然后效果如下:

讨一副人血的偏方
弃则死 服则亡
我这孤独的脊梁
却充满了悲怆


Tabs能装下所有的内容。

信息栏

[[toc]]为信息栏代码,置于页面内即可生效,可移动信息栏效果如同页面右下角,点击对应的标签即可直接跳转至对应内容。

这里使用的是另一种目录的组件,有点小问题



进阶代码(大概)

修改题头

使用以下代码对题头进行修改,至于题头是什么?就是这个页面最上方的大标签和小标签。2

[[module css]]
:root {
/* 主标题 */
   --header-title: "WIKIBUG";
/* 副标题 */
   --header-subtitle: "这代码真是屎屎又山山啊";
/* logo样式 */
   --logo-image: url(" ");
}
[[/module]]

另一种修改题头的代码,我不知道为什么有些版式用的这个来修改,加上wiki的一些毛病,血压有点高

[[module css]]
:root,
:root:lang(cn) {
   --header-title: "WIKIBUG";
   --header-subtitle: "这代码真是屎屎又山山啊";
   --logo-image: url(" ");
}
[[/module]]

修改字体格式

[[module css]]
:root {
/* 正文字体 */
   --body-font: 'Noto Serif SC', serif;
/* 页眉字体 */
   --header-font: 'Zhi Mang Xing', cursive;
/* 标题字体 */
   --title-font: 'Zhi Mang Xing', cursive;
/* 单色字体 */
   --mono-font: 'Noto Sans SC', monospace;
}
[[/module]]

如何自定义div样式

首先你需要一个CSS块,然后对你的div名称进行定义,再使用 {} 来定义属性

[[module css]]
/* 定义div的名称 */
div.glitch-blockquote {
/* 宽度为60% */
    width: 60%;
/* 最小宽度250px,即250像素 */
    min-width: 250px;
/* 左侧间距自动调整 */
    margin-left: auto;
/* 右侧间距自动调整 */
    margin-right: auto;
/* 边缘宽度 */
    border-radius: 0.75rem;
/* 边缘框颜色 */
    border: solid 0.125rem rgb(var(--blockquote-logo-border));
/* 是否要框体阴影 */
    box-shadow: none;
/* div的背景图 */
    background-image: url("http://backrooms-sandbox-2.wikidot.com/local--files/phenomena-amberlon/videotogif_2023.02.05_12.28.31.gif");
/* 背景是否重复 */
    background-repeat: repeat;
/* 背景位置 */
    background-position: center;
/* 背景尺寸 */
    background-size: 100% auto;
}
[[/module]]

如何使用迭代

这是来自排版工具组2.0的单页迭代代码,真是太奇妙了

[[module css]]
.offset-page:not(:target), .offset-page:target ~ div#u-default-page { display: none }
.offset-page:target { display: block }
[[/module]]

然后使用方式为:

[[div class="offset-page" id="page-2]]
我是页面 2
[[/div]]
[[div class="offset-page" id="page-3"]]
我是页面 3
[[/div]]
[[div id="default-page"]]
我是页面 1
[[/div]]

[#u-default-page 跳转到页面 1]
[#u-page-2 跳转到页面 2]
[#u-page-3 跳转到页面 3]

至于多页迭代,可以参考这个页面 https://nationarea.wikidot.com/multi-page-iteration ,也是我写的,至于我为什么写你别管,因为压根就没人会和没人教




本站遵守CC-by-3.0协议