mkdocs_Python 一个对 Markdown 非常友好的文档生成器

mkdocs

网站地址:https://markdown-docs-zh.readthedocs.io/zh_CN/latest/

GitHub:https://github.com/mkdocs/mkdocs

网站描述:Python 一个对 Markdown 非常友好的文档生成器

访问官网

GitHub

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/

仅供个人学习参考/导航指引使用，具体请以第三方网站说明为准，本站不提供任何专业建议。如果地址失效或描述有误，请联系站长反馈～感谢您的理解与支持！

链接: https://fly63.com/nav/1745