一些不错的Sphinx定制示例？

Question

我使用sphinx-quickstart创建了一个Sphinx文档.

1. 有没有关于自定义外观的好例子/教程？专门修改标题并添加徽标.

2. 是否有一些可下载Sphinx文档的项目？我想看看他们如何定制他们的外观.

更新:默认设置中支持添加徽标,但没有特别详细记录.看在conf.py了*_logosettings.`

Answer 1

看看其中的一些主题.由于项目是开源的,您应该能够仔细检查它们.

Answer 2

是时候开始收集链接了.

• https://github.com/coordt/ADCtheme - 像Apple一样
• https://github.com/mitsuhiko/flask-sphinx-themes - 烧瓶
• http://loose-bits.com/2012/11/19/sphinx-bootstrap-theme-updates.html - Twitter Bootstrap
• https://github.com/snide/sphinx_rtd_theme - 阅读文档的主题
• https://github.com/bitprophet/alabaster - 基于Flask

Answer 3

Matplotlib文档是我认为的一个很好的例子.他们甚至在记录matplotlib时有详细的描述:我认为动态生成的数字和继承图是他们对Sphinx的自定义扩展.他们的文档也有自定义徽标.

我猜你应该能够为大多数项目下载RST文档源.

Answer 4

http://docs.djangoproject.com/en/1.1/和http://ask.github.com/celery/是两个很好的例子.