Sphinx开发

Sphinx由一群志愿者维护。我们重视每一个贡献!

  • 该代码可以在Git存储库中找到,网址为https://github.com/sphinx-doc/sphinx/。

  • 应该在 跟踪器 中提出问题和功能请求.

  • 用于开发的邮件列表位于 Google Groups .

  • freenode 上还有 #sphinx-doc IRC频道 .

有关我们的开发过程和方法的更多信息,请参阅 Sphinx开发人员指南.

扩展

要了解如何编写自己的扩展,请参阅 开发扩展

sphinx-contrib 知识库包含许多贡献的扩展。其中一些在PyPI上有自己的版本,其他一些你可以从结帐安装。

这是该存储库中当前贡献的扩展列表:

  • aafig:使用 aafigure 渲染嵌入式ASCII艺术作为漂亮的图像

  • actdiag:使用 actdiag 嵌入活动图

  • adadomain: Ada支持的扩展(需要Sphinx 1.0)

  • ansi: 解析文档中的ANSI颜色序列

  • argdoc: 自动生成命令行参数,描述和帮助文本的文档

  • astah: 使用astah嵌入图表

  • autoanysrc: 从任何源文件中收集reST文档

  • autorun: 在 runblock 指令中执行代码

  • blockdiag: 使用 blockdiag 嵌入框图

  • cacoo: 从Cacoo嵌入图表

  • cf3domain: CFEngine 3政策的域

  • cheader: Sphinx的内置C域缺少 c:header 指令

  • cheeseshop: 轻松链接到PyPI包

  • clearquest: 从 ClearQuest 查询创建表

  • cmakedomain: CMake 的域

  • coffeedomain: (自动)记录CoffeeScript源代码的域

  • context: ConTeXt的构建器

  • disqus: 在文档中嵌入Disqus评论

  • documentedlist: 将Python列表转换为生成的文档中的表

  • doxylink: 链接到外部Doxygen生成的HTML文档

  • domaintools: 一个轻松创建域的工具

  • email: 混淆电子邮件地址

  • erlangdomain: Erlang支持的扩展(需要Sphinx 1.0)

  • exceltable: 使用 exceltable 将Excel电子表格嵌入到文档中

  • feed: 用于从您的网站内容创建联合供稿和基于时间的概述的扩展程序

  • findanything: 一个扩展,用于在文档中添加Sublime Text-like findanything面板,以便在键入时查找页面,节和索引条目

  • gnuplot: 使用 gnuplot 语言生成图像

  • googleanalytics: 使用 Google Analytics 跟踪网络访问者统计信息

  • googlechart: 使用 Google Chart 嵌入图表

  • googlemaps: 使用 谷歌地图 嵌入地图

  • httpdomain: 用于记录RESTful HTTP API的域

  • hyphenator: 使用连 hyphenator 的客户端HTML连字符

  • imgur: 在文档中嵌入Imgur图像,相册和元数据

  • inlinesyntaxhighlight: 内联语法高亮显示

  • lassodomain: 用于记录 Lasso 源代码的域

  • libreoffice:包含LibreOffice支持的任何绘图的扩展(例如odg,vsd,…)

  • lilypond: 从 Lilypond 以PNG格式插入音乐脚本的扩展程序

  • makedomain: GNU Make 的域

  • matlabdomain: 文档 MATLAB 代码

  • mockautodoc: 模拟进口

  • mscgen: 嵌入mscgen格式的MSC(消息序列图)

  • napoleon: 支持 Google styleNumPy style docstrings

  • nicovideo: 嵌入来自nicovideo的视频

  • nwdiag: 使用 nwdiag 嵌入网络图

  • omegat: 支持与 OmegaT 协作的工具(需要Sphinx 1.1)

  • osaka: 将标准日语文档转换为大阪方言(这是一个笑话扩展)

  • paverutils: Sphinx与 Paver 的替代集成

  • phpdomain: PHP支持的扩展

  • plantuml: 使用 PlantUML 嵌入UML图

  • py_directive: 在 py 指令中执行python代码并返回一个数学节点

  • rawfiles: 复制原始文件,如CNAME

  • requirements: 在任何需要的地方声明需求(例如在测试文档字符串中),标记状态并将它们收集在一个列表中

  • restbuilder: reST(reStructuredText)文件的构建器

  • rubydomain: Ruby支持的扩展(需要Sphinx 1.0)

  • sadisplay: 显示SqlAlchemy模型 sadisplay

  • sdedit: 使用快速序列图编辑器(sdedit)扩展插入序列图

  • seqdiag: 使用 seqdiag 嵌入序列图

  • slide: 在 slideshare 和其他网站上嵌入演示幻灯片

  • swf: 嵌入flash文件

  • sword: 从 Sword 插入圣经经文的扩展

  • tikz: 使用 TikZ/PGF LaTeX package 绘制图片

  • traclinks: 从Sphinx中创建 TracLinksTrac 实例

  • versioning: Sphinx扩展允许构建版本化文档以进行自托管

  • whooshindex: whoosh的索引器扩展

  • youtube: 从 YouTube 嵌入视频

  • 提供一个 autointerface 指令,用于使用 Zope interfaces

在开始编写自己的扩展时,请参阅 extension tutorials