扫一扫分享
MkDocs 是一个用于创建项目文档的 快速, 简单 , 完美华丽 的静态站点生成器. 文档源码使用 Markdown 来撰写, 用一个 YAML 文件作为配置文档.
构建完全的静态 html 站点 , 可以将它托管到 GitHub pages, Amazon S3 等任意地方.
默认包含大量美观的主题. 可以从 bootstrap, readthedocs 和 12 款 bootswatch 主题中选择.
内建的开发服务器使你在撰写文档的时候就即时预览. 它甚至能在保存更改时自动载入, 只需刷新浏览器就可以查看更改.
可以配置文档主题.
使用 MkDocs 链接语法创建交叉索引.
pip install mkdocs
λ mkdocs.exe new mydoc
INFO - Creating project directory: mydoc
INFO - Writing config file: mydoc\mkdocs.yml
INFO - Writing initial docs: mydoc\docs\index.md
λ cd mydoc\
d:\code\mydoc
λ ls
docs/ mkdocs.yml
d:\code\mydoc
λ mkdocs serve
INFO - Building documentation...
INFO - Cleaning site directory
[I 190528 20:32:49 server:296] Serving on http://127.0.0.1:8000
[I 190528 20:32:49 handlers:62] Start watching changes
[I 190528 20:32:49 handlers:64] Start detecting changes
[I 190528 20:33:06 handlers:135] Browser Connected: http://127.0.0.1:8000/
手机预览