Python 中最好的文档化工具
EpyDoc
简介
与其它文档化工具一样,EpyDoc 是通过标签区分注释的成份,自动从代码中抓取并生成多格式文档的!
只是! EpyDoc 因为Python 天生的优良品质,快速发展,并且使用非常自然,舒服!
- 嗬嗬嗬!Python 内核中就 由" batteries included" 特性可以得到本身的各种说明
使用
- 可以自个儿在编程的随时,使用简单的命令输出全部的文档到指定的目录中查看
当然首先,你要使用 EpyDoc 的标签约定来格式化你的注释
- 而且还可以利用简单的结构化文本来美化你的文档
示范
Otter 的API 文档 -- 可以去上一层对照的查看源代码,来理解 EpyDoc 的工作
经验
- 汇集使用 epdoc 的经验
-- ZoomQuiet (2004-12-22)