Python教程

【Python】mkdocs 生成帮助文档

本文主要是介绍【Python】mkdocs 生成帮助文档,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

1. 简介

MkDocs 是一个用于创建项目文档的 快速简单 , 完美华丽 的静态站点生成器. 文档源码使用 Markdown 来撰写, 用一个 YAML 文件作为配置文档.

官网文档:https://markdown-docs-zh.readthedocs.io/zh_CN/latest/

官方网站:https://www.mkdocs.org/

  

2. 需求

可以用于生成django-rest-framework离线文档,快速查看, 不依赖网速, 也可内网使用

3. 安装

pip install mkdocs

4. 查看帮助

$ mkdocs help
mkdocs [help|new|build|serve|gh-deploy] {options}

5. 创建项目

$ mkdocs new my-project
$ cd my-project

6. 运行项目

$ mkdocs serve
Running at: http://127.0.0.1:8000/

7. 打包项目

mkdocs build --clean

备注:

  因为django-rest-framework已经有docs目录, 直接打包即可

这篇关于【Python】mkdocs 生成帮助文档的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!