[外链图片转存失败,源站可能有防盗链机制,建议

[外链图片转存失败,源站可能有防盗链机制,建议

　　建立自己的维基知识管理系统

　　【外链图片传输失败，源站可能有反盗链机制，建议保存图片直接上传(img-Acg4hkT5-56)()】

　　本文编辑器将带您从头开始构建自己的维基系统。

　　开源wiki系统有很多，比如：

　　编辑选择使用MkDocs是因为它非常易于部署和使用，特别适合作为个人wiki知识管理系统。简单的说，MkDocs 就是将 Markdown 文件转换成静态的 HTML网站，然后可以在本地直接访问，或者托管在远程服务器或 GitHub 上。

　　实战开始

　　1.Install MkDocs 1.1 Ubuntu 系统

sudo apt-get install mkdocs

　　1.2 Windows 系统

　　MkDocs 目前支持 Python2.7、3.4、3.6、3.7 版本

　　pip install --upgrade pip

　　pip install mkdocs

　　1.3 确认安装是否正确

　　mkdocs --version

　　2.创建维基

　　mkdocs new my-wiki

cd my-wiki

　　创建成功后如下图：

　　[外链图片传输失败，源站可能有反盗链机制，建议保存图片直接上传(img-Ib4RfiMh-60)()]

　　3.预览维基

　　mkdocs serve

　　如果以上步骤执行成功，您会看到如下界面：

　　[外链图片传输失败，源站可能有反盗链机制，建议保存图片直接上传(img-zpyH1cbd-64)()]

　　到此，wiki系统就搭建好了，下面我们来学习如何在wiki系统中添加新的内容吧！

　　4.添加新内容4.1 添加新文本内容

　　This is a new page.

# 一级标题

## 二级标题

### 三级标题

　　nav:

- Home: index.md

- First: first.md

　　4.2 插入图片

　　在docs文件夹下创建一个images文件夹，把图片放在这个文件夹中，然后在markdown文件中引用：

　　

　　5.更改主题

　　mkdocs 有多种主题可供选择，以满足不同用户的喜好。在这里我们向大家推荐 Material 主题。

　　5.1 安装 Material 主题

pip install mkdocs-material

　　5.2 配置wiki使用Material主题

　　打开配置文件mkdocs.yml，写入如下内容：

　　theme:

name: 'material'

　　6.将您的 wiki 站点托管到 GitHub

　　cd my-wiki

git init

git add remote https://github.com/user_name/repository_name

git add .

git commit -m "first commit"

git push origin master

　　mkdocs gh-deploy

　　现在您的 wiki 站点（HTML 文件）位于 gh-pages 分支中，而您的 wiki 站点（markdown 文件）位于 master 分支中。

　　*通过以下 URL 访问您的 wiki

　　https://user_name.github.io/repository_name