手把手linux下搭建wiki

使用mkdocs安装wiki

MkDocs官方网站

安装mkdocs

升级pip

[root@localhost .pip]# pip install --upgrade pip

安装wheel

[root@localhost .pip]# pip install wheel

安装mkdocs

[root@localhost home]# pip install mkdocs

检查mkdocs版本

[root@localhost .pip]# mkdocs --version

创建站点

在home下创建一个文件夹wiki

创建一个新站点

[root@localhost wiki]# mkdocs new hfzy-wiki

构建站点

[root@localhost hfzy-wiki]# mkdocs build

[root@localhost hfzy-wiki]# ls
docs  mkdocs.yml  site
[root@localhost hfzy-wiki]# cd site
[root@localhost site]# tree
.
├── 404.html
├── css
│   ├── base.css
│   ├── bootstrap.min.css
│   └── font-awesome.min.css
├── fonts
│   ├── fontawesome-webfont.eot
│   ├── fontawesome-webfont.svg
│   ├── fontawesome-webfont.ttf
│   ├── fontawesome-webfont.woff
│   └── fontawesome-webfont.woff2
├── img
│   ├── favicon.ico
│   └── grid.png
├── index.html
├── js
│   ├── base.js
│   ├── bootstrap.min.js
│   └── jquery-1.10.2.min.js
├── search
│   ├── lunr.js
│   ├── main.js
│   ├── search_index.json
│   └── worker.js
├── sitemap.xml
└── sitemap.xml.gz

5 directories, 21 files

启动服务

在创建的站点项目下启动服务

[root@localhost hfzy-wiki]# mkdocs serve -a 192.168.0.101:8000
INFO     -  Building documentation...
INFO     -  Cleaning site directory
INFO     -  Documentation built in 0.12 seconds
INFO     -  [23:17:28] Watching paths for changes: 'docs', 'mkdocs.yml'
INFO     -  [23:17:28] Serving on http://192.168.0.101:8000/

开启8000端口

[root@localhost hfzy-wiki]# firewall-cmd --zone=public --add-port=8000/tcp --permanent && firewall-cmd --reload
success
success
[root@localhost hfzy-wiki]# firewall-cmd --reload
success

浏览器访问192.168.0.101:8000

wiki应用

修改wiki名称

打开mkdocs.yml,修改site_name

[root@localhost ~]# cd /home
[root@localhost home]# ls
git  git-repo  software  wiki
[root@localhost home]# cd wiki/
[root@localhost wiki]# ls
hfzy-wiki
[root@localhost wiki]# cd hfzy-wiki/
[root@localhost hfzy-wiki]# ls
docs  mkdocs.yml  site
[root@localhost hfzy-wiki]# cat mkdocs.yml 
site_name: My Docs
[root@localhost hfzy-wiki]# vim mkdocs.yml 

添加页面

将md文件拷贝到docs文件夹中

修改mkdocs.yml文件

添加nav标签

修改wiki 主题

可以从第三方下载主题（Theme)

MkDocsd第三方主题

以Bootstrap4为例

安装主题

[root@localhost hfzy-wiki]# pip install mkdocs-bootstrap4

在mkdocs.yml中使用主题

---

服务器后台运行

当ssh断开连接后服务器继续运行程序使用screen指令

安装screen

[root@localhost hfzy-wiki]# yum install screen

创建ssh会话

在打开的ssh会话(即使用ssh工具连接会话中)，创建一个screen会话名称

wiki_run为自定义的screen会话名称

[root@localhost hfzy-wiki]# screen S wiki_run

启动mkdocs服务

扩展js功能

如果需要扩展系统的js脚本，可以在docs 创建resources文件用来存放扩展的内容

在mkdocs.yaml文件中配置

案例：禁止鼠标右键功能

function iEsc(){ return false; }
function iRec(){ return true; }

function DisableKeys() {
if(event.ctrlKey || event.shiftKey || event.altKey)  {
    window.event.returnValue=false;
    iEsc();
	}
}

document.ondragstart=iEsc;
document.onkeydown=DisableKeys;
document.oncontextmenu=iEsc;

if (typeof document.onselectstart !="undefined")
	document.onselectstart=iEsc;
else{//qsyz.net
    document.onmousedown=iEsc;
    document.onmouseup=iRec;
}

function DisableRightClick(www_qsyz_net){
    if (window.Event){
        if (www_qsyz_net.which == 2 || www_qsyz_net.which == 3)
        iEsc();
    }
    else if (event.button == 2 || event.button == 3){
        event.cancelBubble = true
        event.returnValue = false;
        iEsc();
        }
}