一下如何向Material系统中添加新的内容吧!!
优采云 发布时间: 2021-08-16 20:24一下如何向Material系统中添加新的内容吧!!
本文小编将带您从零开始搭建自己的wiki系统。开源的wiki系统有很多,比如:
编辑选择使用MkDocs是因为它非常易于部署和使用,特别适合作为个人wiki知识管理系统。简单来说,MkDocs 将 Markdown 文件转换为静态 HTML网站,然后可以直接在本地访问,或者托管在服务器或 GitHub 上。
实战开始1.install MkDocs1.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
创建成功后如下图:
3.预览维基
mkdocs serve
如果以上步骤执行成功,您会看到如下界面:
到此,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 分支中。
该命令执行了两个操作:
将Mardown文件转成静态HTML网页文件,将所有静态HTML网页文件推送到远程仓库的gh-pages分支
GitHub 会自动管理 gh-pages 分支的静态网页,相当于一个静态的网站服务器。
https://user_name.github.io/repository_name
扫描二维码关注“Edge Smart Lab”了解更多精彩资讯!