✍️ 指导说明
本篇文章旨在为初次接触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]]标题
在每行开头加上"+"号就能将之变成标题,加号的数量决定标题的等级。
+ 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
- 事项2
- 事项2.1
如果要在列表中弄一行以上,在行尾放"_"(要空格),"_"后面不能放东西。
# 事项1 _
另一行
# 事项2
# 事项2.1以下为效果示范
- 事项1
另一行 - 事项2
- 事项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 | 显示上传到其他页面的图片 |
以下为效果示范
这是一张示例图
此外,还有一种插图方块:
[[include component:image-block name=图源 |caption=描述 |align=位置]]
以下为效果示范
这是另一张示例图
笔记
使用 [[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]] |
用户信息(连头像) |
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 ,也是我写的,至于我为什么写你别管,因为压根就没人会和没人教
