本网站使用Wiki.js搭建而成。Wiki.js是一款基于Node.js的现代、轻量级且功能强大的开源Wiki应用程序,基于 AGPL-v3 许可发布。它支持多平台安装,并且具有性能强劲、可定制、可扩展等优点。
为了便于对网站内容进行更好的管理,目前本网站仅对成功注册编者组的用户开放页面创建、编辑、删除等权限。如果您对网站的内容有更好的建议,请在页面下方留下您的注册邮箱,或通过QQ邮箱31017486@qq.com
与管理员联系。管理员将及时为您开通编辑权限。
请在对网站内容进行编辑前阅读完本页全部内容,并熟知编辑方法。如对网站内容、结构造成损害,管理员有权对您的账号进行永久封停!
全局导航: 永久性导航菜单,显示在所有页面上,用于显示网站的整体结构。
面包屑导航: 当前页面的完整路径。每页顶部显示的面包屑导航栏是根据路径自动生成的。
全局搜索: 通过执行搜索快速找到页面,支持关键字搜索和标签搜索。
页面目录: 当前页面的各个部分,根据页面内容中的标题自动生成。
页面标签: 与当前页面关联的标签。可通过单击标签查看含有同样标签的页面。
作者: 查看作者和页面上次修改的日期。
社交链接: 当前页面的共享、打印链接。
编辑页面/页面操作: 快速访问菜单,可在当前页面上编辑或执行其他操作。
新建页面: 创建一个新页面。
用户菜单: 当前登录用户特定的操作,例如查看配置文件、管理和注销等。
为了创建新页面,请单击页面右上角的“新建页面”按钮,将出现以下对话框:
语言选择区: 可以选择新建页面的语言。此选项针对具有多语言命名空间的网站准备,本网站仅设置了简体中文语言环境,创建页面时无需对该处进行改动。
完整路径: 网站现有页面的完整路径结构,点击任意文件夹,可查看该文件夹下的页面。同时下方页面路径会自动跳转到当前文件夹下。
现有页面: 该文件夹下现有页面的列表。
页面路径: 可以输入新建页面的完整路径和页面名。页面路径是由文件夹名和页面名组成的。例如/Linux运维/Linux系统简介
表示在网站根目录/
下面的Linux运维
文件夹下创建的名为Linux系统简介
的页面。
在输入页面路径时应注意以下几个方面:
- 路径不应包含空格或句点(改为使用破折号),并且应由URL安全字符组成。
- 请勿在页面名后面加上
/
。- 您不需要新建文件夹。输入您要创建的完整路径,文件夹将自动创建。例如,输入
/中国/江苏省/南京市
,如网站中不存在中国
和江苏省
两个文件夹,系统将自动在根目录下创建中国
文件夹,并在中国
文件夹中创建江苏省
子文件夹,最后在江苏省
文件夹中创建名为南京市
的页面文件。- 所有文件夹名和页面名区分大小写。例如,系统将把
Nanjing
和nanjing
识别为两个不同的名字。
以下名称不能用于路径或页面名,而是保留供系统使用。
保留所有单个字符路径以访问网站的各个部分:
a
:管理页面c
:评论页面e
:页面编辑器f
:媒体资料管理器h
:页面历史i
:按ID浏览页面p
:用户资料s
:页面来源t
:标签u
:上传端点(API)w
:个人wiki保留下列格式的语言标签,以指定要使用的语言环境名称空间。
en
,fr
)en-us
,fr-ca
) 下面的术语不能作为路径或路径的一部分。例如,register
或register/test
不能作为有效路径,但registering
可以。
路径不能包含以下字符:
创建新页面时,将出现以下对话框提示:
本网站目前支持网页源码(Code)、Markdown、可视化编辑器(Visual Editor)三种编辑器进行页面编辑,后期还将推出API文件、博客、表格编辑器。目前支持的三种编辑器特点如下:
目前,本网站所有预设页面均使用Markdown编辑器,支持从Typora等Markdown编辑器直接复制源码使用。如需新建页面,可选择使用可视化编辑器(Virtual Editor)进行编写,并联系管理员在“全局导航”栏进行添加。
编辑器在选定后即与页面进行绑定,无法进行替换。如需更换编辑器,请新建页面重新进行编辑,并联系管理员删除原有页面。
选择编辑器后,系统会提示您“页面属性”对话框:
标题:标题将显示在页面正文的上方。
简短说明:将显示在标题的下方,类似副标题。
路径:显示当前页面文件的路径信息。
分类:可以为页面添加标签。在输入框中输入需要添加的标签后回车,即可为页面添加一个标签。如需添加多个标签,可继续在输入框中进行添加。
输入页面的标题,描述和标签。最后,单击“OK”关闭对话框并开始编写!
在页面创建后,您还可以通过单击页面右上角的“页面”按钮返回“页面属性”对话框进行编辑。
点击页面右上方或右下方的 “编辑页面/页面操作” 按钮即可打开当前页面的编辑窗口。根据编辑器的不同,编辑时会显示不同的界面。各编辑器的编写方法可参考编辑页面自带帮助说明,Markdown编辑器的基本用法请参考本页面下方 Markdown语法介绍 。
为方便各位编者尝试各种编辑器的用法,本网站分别建立了三种编辑器的测试页面供大家进行试用。页面链接为:网页源码编辑器测试页面、Markdown编辑器测试页面、可视化编辑器测试页面。请各位编者不要在这三个页面之外的地方进行尝试。
Wiki.js不需要用户在创建目录后再创建新页面。只要用户指明新建页面的目录结构,Wiki.js会在新建页面的同时创建好相应的目录。
例如,我们需要创建一个名为南京市
的页面,它在/中国/江苏省/
这个目录下。那么我们只需要在页面的路径结构里写出/中国/江苏省/南京市
,中国
和江苏省
两个父目录会自动创建出来。
Wiki.js的这一特性具有更大的灵活性和更少的目录依赖性。但是,这并不意味着我们不能使用传统的目录结构。我们依然可以按照先创建目录、再创建页面的流程操作。唯一的区别是您不必管理目录结构,它们是从页面路径自动创建出来的。
标签是对页面进行分类并轻松查找相关内容的好方法。与使用复杂的文件夹系统对内容进行分类相比,它们是一种更精简的选择。标签是贴在页面上的简单标签。
可以将多个标签添加到页面。
例如,对于一个关于城市的页面南京市,你可以为其添加标签地级市
、中国
、江苏省
。这些标签随后可用于快速查找页面。通过选择江苏省
和地级市
两个标签,由于页面上同时存在这两个标签,因此南京市页面将出现在结果中。
您可以随时在页面上添加或删除更多标签。
使用按标签浏览链接(位于全局搜索栏旁边或在导航菜单中)可查看Wiki中所有可用标签的列表。
选择一个或多个标签以查看与所选内容匹配的页面列表。
所有编辑器都有一个打开文件资料对话框的按钮。更多相关信息,请参阅每个编辑器编辑器的文档。查阅时请使用Google Chrome
等自带翻译工具的浏览器。
文件资料可以是任何文件类型,如图片、文档、压缩文件等。图像将自动显示为图像,而其他文件类型将仅显示标准链接。
使用界面右上角的“上传”对话框来上传新资料。您可以单击其中的“浏览”按钮,也可以直接将文件拖放到灰色区域中。准备就绪后,单击“上传”按钮以启动所有文件的上传。
上传前请确保文件已被正确命名,并且左侧资料文件夹处于正确目录下。本网站默认上传的单个文件最大为5MB,单次上传的总文件不得超过10个。
选择要插入的资料,然后单击“插入”按钮。
插入图像时,可以使用“图像对齐”下拉菜单(位于对话框右侧)来设置特定的对齐方式,也可以在文件代码的后方使用{.align-left}
、{.align- center}
、{.align-right}
、{.align-abstopright}
进行对齐方式的调整,详细代码请参考页面下方“Markdown常用语法”章节中图片的使用介绍。
要对文件执行任何操作,例如重命名、删除或编辑,请单击文件列表项右侧的…
按钮。将出现一个下拉菜单,其中包含所有可执行的操作。
请注意,禁用的操作尚不可用,并将在将来的版本中发布。
单击资料对话框顶部的“新建文件夹”按钮。输入的新名称应遵守命名限制。
目前版本尚不支持该项功能,任何创建的文件夹都无法进行删除操作,请大家谨慎操作。
文件夹必须遵守以下命名规则:
-
和下划线_
外,不允许含有其他特殊字符。ZZ
或ZZ-ZZ
这种格式的命名不能仅由字母(A-Z)组成(保留区域设置)。详细信息请参阅Wiki.js官网命名规则页面。
Markdown是一种轻量级的标记语言,是用于编写结构化文档的纯文本格式。它由John Gruber(在Aaron Swartz的帮助下)开发,并于2004年以语法描述和Perl脚本的形式发布,用于将Markdown转换为HTML。
Markdown与其他许多轻量级标记语法的区别在于其可读性。正如其开发者John Gruber写道:
Markdown格式化语法的首要设计目标是使其尽可能地可读。这就是说,Markdown格式的文档应该以纯文本形式原样发布,而不会看起来像被标签或格式说明所标记。
Markdown语言目前除了用于在主要代码存储库(例如GitHub、码云)上编写文档以外,还经常被用来撰写书籍、文章、幻灯片、信件和讲义。
本网站支持完整的CommonMark规范,并且添加了一些有用的扩展(包括GitHub Flavored Markdown插件)。目前,本网站所有预设页面均使用Markdown编辑器,支持从Typora等Markdown编辑器直接复制源码使用。如需新建页面,可选择使用可视化编辑器(Virtual Editor)进行编写,并联系管理员在“全局导航”栏进行添加。
Markdown编辑器界面主要由左侧代码编辑窗格、右侧预览窗格、上方工具栏和左侧工具栏四个部分构成。
Markdown用法帮助功能可以在不离开编辑界面的情况下查询各种常用语法格式的源代码、快捷键和显示效果,但目前为全英文界面。
Markdown语言使用标题对文档结构进行分层。在选定的文本前面加上1~6个井号( #
)和1个空格(
),可以表示当前行文本为标题行。使用几个 #
就表示该行为几级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
正文
在需要加粗的文本前后使用2个星号( *
)即可将星号中间的文字加粗。该格式常用来表示强调的作用,以引起读者的注意。
请大家**不要**随意更改页面配置信息。
请大家不要随意更改页面配置信息。
在需要改为斜体的文本前后使用1个星号( *
)即可将星号中间的文字改为斜体。该格式常用于重要性较低或补充解释性的语句,也可用于书籍名称、人名和标注不同的语言(例如英语中夹杂的法语)。
Wiki.js支持以下六种编辑器:
API文件(*即将推出*)
博客(*即将推出*)
Raw HTML
Markdown
表格(*即将推出*)
可视化编辑器
Wiki.js支持以下六种编辑器:
API文件(即将推出)
博客(即将推出)
Raw HTML
Markdown
表格(即将推出)
可视化编辑器
由于Markdown使用纯文本进行编辑,并且对其中的部分符号进行了功能定义,因此有时候需要用转义字符来输出部分符号。例如,本网站所使用的Markdown编辑器不支持使用 Tab 键或 空格 键进行首行缩进,因此,在每段开头需输入2个连续的  
。在文本中同样可以使用  
来输出空格。
符号 | 名称 | 转义字符 |
---|---|---|
|
空格 |   |
< |
小于号 | < |
> |
大于号 | > |
& |
与号 | & |
" |
引号 | " |
' |
撇号 | ' |
"Markdown"是一种轻量级的标记语言。
"Markdown"是一种轻量级的标记语言。
如果编辑器界面上无法输出空行,也可以在空白行上添加
 
来输出空行。
在需要改为上标的文本前后使用1个插入符号( ^
)即可将插入符号中间的文字改为上标。
y=x^2^
y=x2
在需要改为下标的文本前后插入1个单波浪号( ~
)即可将插入符号中间的文字改为下标。
水的化学式是H~2~O
水的化学式是H2O
使用 [^1]
在正文中的脚注位置进行标注,并在页面任意位置使用单独行 [^1]
: 脚注1 进行脚注说明。
脚注必须配套使用。脚注本身将自动出现在页面底部的水平线下方。脚注作为注释的一种,主要用于补充正文信息。
点击正文中的脚注图标,将自动跳转到页面底部的说明位置。点击脚注说明后方的图标,将跳回到正文中标注的位置。
兵[^1]者,国之大事,死生之地,存亡之道[^2],不可不察也。
[^1]: 兵:兵器,用兵,这里指战争。
[^2]: 存亡之道:国家存亡的途径。
兵[1]者,国之大事,死生之地,存亡之道[2],不可不察也。
有序列表是一列按照一定顺序排列的列表项的集合,一般使用数字对列表项进行编号。本网站Markdown编辑器中可通过在选定的段落前面加上数字、点,再跟空格的方法来形成有序列表。
福布斯2021全球富豪榜
1. 杰夫·贝佐斯
2. 埃隆·马斯克
3. 伯纳德·阿诺特
3. 比尔·盖茨
福布斯2021全球富豪榜
有序列表会自动核对序号。例如本例源代码中输入的比尔·盖茨的序号为3,但因为该条目是列表中的第4项,所以在实际显示的页面中该条目的序号被自动调整为4。
无序列表是一个没有特定顺序的列表项的集合,也称为项目列表。无需列表中各列表项的地位是平等的,无顺序之别,常使用小箭头或圆点对列表项进行标注。本网站Markdown编辑器中可通过在选定的段落前面加上星号( *
)或减号( -
),后面跟空格的方法来形成有序列表。
计算机的通用硬件:
- CPU
- 内存
- 主板
- 硬盘
- 显卡
- 电源
计算机的通用硬件:
除了标准无序列表样式外,Wiki.js还提供了表格列表样式和链接列表样式。
表格列表样式主要通过在标准列表的源代码最后一行加上 {.grid-list}
来实现。
- 表格项目1
- 表格项目2
- 表格项目3
{.grid-list}
链接列表样式的标准格式为 - [链接标题名称*链接描述*](网址)
并在列表项书写完的下一行添加 {.links-list}
来实现。链接列表样式中,用户点击 链接标题名称
可快速跳转到对应的网址。
- [百度*全球最大的中文搜索引擎*](https://www.baidu.com/)
- [京东*专业的综合网上购物商城*](https://www.jd.com/)
- [知乎*中文互联网最大的问答社区*](https://www.zhihu.com/)
{.links-list}
请注意,这些样式专属于Wiki.js,在其他应用程序中将回退到标准列表样式。
任务列表与无序列表的区别在于任务列表可以对是否完成进行标记。我们可以使用 - [ ]
和 - [X]
来制作任务列表。其中 - [X]
表示已完成项。
- [x] 吃饭
- [X] 睡觉
- [ ] 打豆豆
在
- [X]
中使用x
或X
都可以。但是请注意在- [X]
后面还有一个空格。
在需要添加删除线的文本前后插入2个单波浪号( ~
)即可对插入符号中间的文字添加删除线。
删除线表示某些内容需要删除,~~往往会写出删除理由~~。
删除线表示某些内容需要删除,往往会写出删除理由。
在空白行上输入3个减号( -
),即可生成一条水平线。
下面有一条水平线
---
上面有一条水平线
下面有一条水平线
上面有一条水平线
使用 
的语法可以在页面中添加图片,这种语法常用于直接调用其他网页上的图片。例如,在编辑器中输入 
,页面将自动调取网页上的图片。但当该图片无法调取时,页面将不显示图片。
当使用已上传至本网站资料文件夹中的图片时,可将格式中的 (图片路径) 替换为本地图片的路径,例如 
,不过本地图片的调用更建议使用左侧工具栏中的 插入文件 按钮,可对图片进行对齐操作。
为了更好的统一网站资源,请使用编辑器左侧工具栏中的 插入文件 按钮将命名好的图片上传到该页面对应的文件夹内。例如
/用户指南
页面中的图片,请放入/用户指南/
文件夹中;/收费系统/收费系统简介
页面的图片,请放入/收费系统/收费系统简介/
文件夹中。
若页面对应的文件夹不存在,请自行创建。目前Wiki.js不支持删除已创建的文件夹,请切记创建时仔细核对当前文件夹位置!
不要使用编辑器左侧的 插入图片 按钮进行添加!!!
下面将调用百度热搜的logo图片:

下面将调用已上传至网站中的图片:

下面将调用百度热搜的logo图片:
下面将调用已上传至网站中的图片:
有时图像太大,或者您可能希望图像填满所有可用空间,可以按照以下格式在图像路径末尾添加尺寸:
下面将显示规定图像长宽比例的格式:

也可以忽略其中的一个值,以自动保持图像比例:


也可以使用其他单位,例如%。需要图像占用所有可用空间时很有用:

显示效果为:
下面将显示规定图像长宽比例的格式:
也可以忽略其中的一个值,以自动保持图像比例:
也可以使用其他单位,例如%。需要图像占用所有可用空间时很有用:
请注意

中的x
是字母x
,不是乘号。
使用编辑器左侧工具栏中的 插入文件 按钮插入图片时,可在资料文件夹页面右下方 图像对齐 中进行选择,也可以在源代码的 
后使用 {.align-left}
、 {.align-center}
、 {.align-right}
、 {.align-abstopright}
进行对齐方式的调整。如 
后不跟任何对齐方式代码,则使用默认对齐方式。
{.align-left}
:左对齐{.align-center}
:居中对齐{.align-right}
:右对齐{.align-abstopright}
:页面右上,显示在当前页面标题的右侧。例如,将百度热搜logo图片居中对齐的源代码为:
{.align-center}
显示效果为:
使用 [链接文字](目标地址)
的格式可以为 链接文字
添加链接。指向本网站其他页面的链接还可以通过点击编辑器界面左侧工具栏中的 插入链接 按钮进行添加。
[高速公路机电系统运维知识手册](http://106.14.194.205/)是一个以提高员工对高速公路机电设备的认识和维护水平为目的的网站。
为了保障联网收费系统整体网络安全,我们编写了[《联网收费系统省域系统并网接入网络安全基本技术要求》解读](/机电系统网络知识/《联网收费系统省域系统并网接入网络安全基本技术要求》解读)。
高速公路机电系统运维知识手册是一个以提高员工对高速公路机电设备的认识和维护水平为目的的网站。
为了保障联网收费系统整体网络安全,我们编写了《联网收费系统省域系统并网接入网络安全基本技术要求》解读。
在需要显示为引用的段落之前加上大于号和1个空格( >
),可将该段落标记为块引用格式。Wiki.js除支持标准块引用格式外,还支持信息型块引用、成功型块引用、警告型块引用、错误型块引用四种专有格式。
> 这是一条标准块引用。
> 这是一条信息型块引用。
{.is-info}
> 这是一条成功型块引用。
{.is-success}
> 这是一条警告型块引用。
{.is-warning}
> 这是一条错误型块引用。
{.is-danger}
这是一条标准块引用。
这是一条信息型块引用。
这是一条成功型块引用。
这是一条警告型块引用。
这是一条错误型块引用。
在需要标记为键盘按键的文本之前加上 <kbd>
,并在之后加上 </kbd>
,可将所选文字变为键盘按键格式。
在Windows系统下,可同时按住<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>三个键,调出任务管理器界面。
在Windows系统下,可同时按住Ctrl+Alt+Del三个键,调出任务管理器界面。
在需要标记的文本前后各加上1个反引号(即 Tab 键上方的按键),即可将文本变为内嵌代码格式。
在需要标记为键盘按键的文本之前加上 `<kbd>` ,并在之后加上 `</kbd>` ,可将所选文字变为键盘按键格式。
在需要标记为键盘按键的文本之前加上 <kbd>
,并在之后加上 </kbd>
,可将所选文字变为键盘按键格式。
在需要标记为代码块的段落之前和之后的空白行使用3个反引号或3个单波浪号(即 Tab 键上方的按键),可将段落标记为代码块格式。
如需指明代码所使用的编程语言,可在代码块之前的三个反引号后添加语言名称,如 c++
、 php
、Markdown
等。当编辑器识别出代码所使用的语言后,代码块中的关键字会显示出不同的颜色,否则,代码块中的所有字符均显示白色。
浏览页面时,可单击代码块右侧的 copy 符号复制代码。
这是一段未标记编程语言的代码块:
```
#include <iostream>
int main()
{
std::cout << "Hello World!" << std::endl;
return 0;
}
```
这是一段标记了编程语言的代码块:
```c++
#include <iostream>
int main()
{
std::cout << "Hello World!" << std::endl;
return 0;
}
```
这是一段未标记编程语言的代码块:
#include <iostream>
int main()
{
std::cout << "Hello World!" << std::endl;
return 0;
}
这是一段标记了编程语言的代码块:
#include <iostream>
int main()
{
std::cout << "Hello World!" << std::endl;
return 0;
}
使用标题格式并将 {.tabset}
添加到父标题上,可以做出内容标签的效果。父标题文本将不会显示在页面中。
##### 加粗格式{.tabset}
###### 语法
在需要加粗的文本前后使用2个星号(`*`)即可将星号中间的文字加粗。
###### 源代码
`请大家**不要**随意更改页面配置信息。`
###### 显示效果
请大家**不要**随意更改页面配置信息。
###### 快捷键
选中需要加粗的文本,然后单击上方工具栏的<kbd>B</kbd>图标,可将文本进行加粗。
选中需要加粗的文本,然后按住键盘上的<kbd>Ctrl</kbd>+<kbd>B</kbd>,可将文本进行加粗。
在需要加粗的文本前后使用2个星号(*
)即可将星号中间的文字加粗。
请大家**不要**随意更改页面配置信息。
请大家不要随意更改页面配置信息。
选中需要加粗的文本,然后单击上方工具栏的B图标,可将文本进行加粗。
选中需要加粗的文本,然后按住键盘上的Ctrl+B,可将文本进行加粗。
你可以使用任何级别的标题来开始一个内容标签,只要制表符标题的级别比父标题高一个级别即可。例如,如果父标题为
###
(三级标题),则制表符标题必须为####
(四级标题)。父标题的最大标题级别为五级标题,制表符标题的最大级别为六级标题。
想要结束内容标签,必须在结束的地方使用一个小于父标题级别的标题。
Markdown编辑器支持emoji表情符号(绘文字符号)。例如 :smile:
将输出。
完整的emoji表情符号列表请参见emoji表情符号备忘录。
隔壁家的孩子养了一只:cat:。
隔壁家的孩子养了一只。
Mermaid图又叫做人鱼图,它是一个用来画流程图,甘特图等图形的工具。Mermaid使用代码块的形式来绘制图表。
请参阅Mermaid网站以获取用法参考。
```mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
```
PlantUML是一个画图脚本语言,用它可以快速地画出时序图、流程图等。PlantUML使用代码块的形式来绘制图表。
请参阅PlantUML官方网站以获取用法参考。
```plantuml
Bob->Alice : hello
```