
下载
目前版本: 1.2
获得 Sphinx 从 Python Package Index, 或者使用如下命令安装:
easy_install -U Sphinx
最新的 开发版本文档 也是可用的。
问题? 建议?
请加入 Google group:
或者加入在FreeNode上的频道#pocoo.
你可以新建或者加入 话题.
Quick search
Enter search terms or a module, class or function name.
Welcome
使用者说:
“为这个伟大的工具而干杯,因为她让所有的程序员们愿意 编写文档!”
Sphinx是一个工具,她能够轻易地创建智慧和优雅的文档,她是出自Georg Brandl之手,在BSD许可证下授权。
她最初是为了新版的python文档, 因此在python项目的文档具有完美的特性,但是同样支持c/c++,目前正在计划增加对其他的语言的支持。 理所当然,本页面也是使用Sphinx创造自reStructuredText格式源!Sphinx具有如下的特点:
- 输出格式: 超文本标记语言 (包括Windows HTML帮助),LaTeX (可打印的PDF版本),手册页,纯文本
- 丰富的交叉引用: 语义标记以及针对函数,类,引用,词汇表(术语)和相似的信息块的自动链接
- 层次结构: 简单的文本树定义,就能自动地链接到同层(兄弟姐妹)、上一层(父母)以及下一层(子女)的文本位置
- 自动生成目录: 通用索引以及语言模块的目录
- 代码高亮: 代码自动高亮,通过使用 Pygments
- 扩展功能: 自动测试的代码片段,包括从Python模块(API文档)的文档字符串
Sphinx 使用 reStructuredText 作为她的标记语言,她的优点大部分是来自于reStructuredText 以及reStructuredText的解析和转换工具(套件)Docutils的强大以及简单明了。
文档
初熟Sphinx 目录 |
搜索页 通用索引 |
你也能下载PDF格式的Sphinx文档:一种PDF 版本 是由LaTeX Sphinx生成,另一种PDF 版本 是由rst2pdf生成。
实例
用Sphinx生成文档的项目能够在 Projects using Sphinx上找到。
想要查看Sphinx源文件长得什么样的话,可以在除本欢迎页外的任何页面上使用“显示网页源代码”。
你也许对这份十分不错 教程感兴趣,它是由matplotlib的开发者编写,是使用了Sphinx创建地自定义的文档。
下载 Sphinx
Sphinx是一个可用的 easy-install包在 Python Package Index.
源码能够在下面的地址中找到: http://bitbucket.org/birkenfeld/sphinx/。