欢迎来到复旦附中 Wiki!本教程将教会你如何使用本 Wiki 功能丰富的页面编辑器,让你写出精妙绝伦(花里胡哨)的文章~
在任意页面点击右上角的“创建新页面”按钮即可创建一篇新的内容。
本 Wiki 支持使用文件夹结构来编排文章。在创建页面时,可以在“页面位置”中定义文章的位置,该位置将直接作为 URL 中的路径使用,并以文件夹形式显示在侧边栏中。
例如,创建 wiki/测试 文章后,你将可以在 https://nmwiki.top/wiki/测试 中访问该文章。
注意,为保证关键页面不被篡改,普通用户仅能在
wiki及其子目录下创建或修改文章
找到一个页面,点击右上角的“页面操作”按钮,即可对文章进行不同的编辑操作。聪明的你肯定也发现,本 Wiki 记录了所有人的所有编辑历史,每一次编辑都会被记录。
并且,你也可以查看到页面的源代码,这样就可以借鉴(抄袭)他人的格式样式等啦~
在创建页面时你需要先选择编辑器,不过这部分内容比较多所以就先放到下面啦~
每一个页面都会有相应的属性,关乎页面的显示逻辑。在创建和修改是均可编辑页面属性。页面属性包括“页面信息”“定时任务”“脚本”和“样式”。
页面信息中包括:
定时任务可以让你发布/归档一个页面。当页面未发布时,仅有编辑权限的用户(非访客)可以看到页面的内容,在发布后才是所有人可见。
下方可以设置“开始日期”和“结束日期”,到达开始日期后页面将被自动发布,而到结束日期后页面将被归档(即取消发布)。
怎么说呢,这功能对于普通用户......聊胜于无吧~
你会发现这个按钮是灰色的,这是因为出于安全考虑把这个功能给普通用户禁了诶嘿~
如果你有幸学过 CSS 的话,那么恭喜你,你可以随意的编写 CSS 美化你的文章页面!(比隔壁 SHSWiki 和 HYWiki 不知道强几倍)具体的话自行探索吧!(毕竟会 CSS 的应该不需要我多说)
比如本页面通过此样式把侧边栏和按钮等改绿了:
.v-application .blue.darken-2:not(html),
.v-application .primary:not(html) {
background-color: #1f9543 !important;
border-color: #1f9543 !important
}
.v-application .blue.darken-3:not(html) {
background-color: #1c9e44 !important;
border-color: #1c9e44 !important
}
AsciiDoc、Markdown、HTML 编辑器在部分中文输入法用 ↑ ← ↓ → 键选词时会抽风,可尝试在左下角打开勿扰模式后按 Esc 退出解决~
Wiki 的文章分为四种类型(从低到高):AsciiDoc、Markdown、富文本和 HTML。(没错你甚至能用 HTML 写文章)
文档可以在页面操作中从低级转为高级,例如 AsciiDoc 可以转为 Markdown 或 HTML,但没有格式能转为 AsciiDoc。
当然,编辑器还提供另一种方法——从模板创建(抄袭),也就是复制一份别的页面并加以修改。
本 Wiki 编辑器包含了非常强大的功能,往下读就知道了,你甚至能在页面里画画:
Markdown 与 AsciiDoc 类型均为文本,但 Markdown 可提供更多功能,因此强烈建议优先选择 Markdown
可以在此处查看 AsciiDoc 格式的文档~
网上有许多 Markdown 教程,因此这里不在过多赘述。详细的教程可以查看这些:基础语法和拓展语法。注意本 Wiki 不支持拓展语法中的定义列表。
相信我,Markdown 绝对很简单,十分钟就能学会。况且编辑器还提供内置的快捷按钮呢!
当然,我们的 Markdown 不仅限于 Markdown。Markdown 中支持添加 HTML 标签,并且增加了许多自定义的语法和方言,如下所示。
你可以使用 ^ 包裹文本以使文本变为上标,例如 文本^上标^ 渲染为:文本上标
你可以使用 ~ 包裹文本以使文本变为下标,例如 文本~下标~ 渲染为:文本下标
你可以使用 *[缩写]: 全称 来定义缩写。定义可以写在文档的任意位置。
注意使用缩写时需要与前后文之间有空格,缩写会被下划线,鼠标悬停可以显示全称,例如:
*[复附]: 复旦大学附属中学
我爱 复附!
渲染的结果是:
我爱 复附!
众所周知你可以通过:

来添加图片,但是你现在可以通过:

来定义图片大小了!例如:

可以获得一张被诡异拉伸的校徽图片:

想画流程图 / 思维导图 / 时序图等?没问题!去看看 Kroki 和 PlantUML 吧!本 Wiki 完全支持 Kroki 和 PlantUML!
例如:
```kroki
mermaid
graph TD
A[挖掘机技术哪家强] -->|问题来了| B(中国山东找*翔)
```
```plantuml
Bob -> Alice : hello
```
可以渲染出:
你可以使用 $ 包裹文本以书写行内 LaTex 公式,例如 $1 + 1 = 2$ 为:
你也可以使用 $$ 来书写多行 LaTex 公式,例如:
$$
\displaystyle v_{瞬时} = \lim_{t \to 0} \frac{\Delta x}{\Delta t}
$$
渲染的结果为:
直接使用编辑器左侧按钮就可以插入文件和绘画了哦~
也就是可视化编辑器啦,我觉得你如果会用“Word”(是个人都会吧)你就会用它。
如果你恰好会 HTML 的话,你完全可以尝试使用 HTML 来写一个更自定义的页面。
出于安全考虑,部分标签和属性将被禁用,例如
<script>等。(企图 xss 攻击的小伙我看你很刑啊)
当然,Wiki 增加了许多自定义标签,还有部分写法与 Markdown 格式相同,可以在这里找到文档。
部分中文输入法不支持多光标,但可以通过复制黏贴等行为代替。
学废了吗?学废了在评论区扣1(bushi)。那么,祝你写出一个美观而优雅的页面吧~