需求
- MarkDown 文本
- 文档结构化，方便组织
- 搜索整理
- shell 编辑
- 随时随地编辑
MkDocs 优点
- 轻量简单 :想用HEXO，但是NodeJS安装不上，费事费力
- 方面客户化: Python包，修改简单
方案
- 内部服务器
稳定，但是访问困难 - Home Raspberry
- 发布到Github Page
试验环境
- 安装环境
Centos6
pip install mkdocs
# 创建笔记项目
mkdocs new mdnote
cd mdnote
- 模板
pip install mkdocs-bootswatch
可用的模板：
- amelia
- cerulean
- cosmo
- cyborg
- flatly
- journal
- readable
- simplex
- slate
- spacelab
- united
- yeti
- 设置
编辑mkdocs.yml
site_name: iKnow
theme: readthedocs
- 文件存放目录
docs/
index.md
user-guide/getting-started.md
user-guide/configuration-options.md
about.md
- 部署到Github Page
生成静态页面:mkdocs build
生成的目录在site下，发布到自己的Github Page项目里
部署后遇到的问题:
unable to build page. Please try again later.
解决方法：
必须建立一个README.MD文件，添加后build正常
