我使用sphinx-quickstart创建了一个Sphinx文档.
有没有关于自定义外观的好例子/教程?专门修改标题并添加徽标.
是否有一些可下载Sphinx文档的项目?我想看看他们如何定制他们的外观.
更新:默认设置中支持添加徽标,但没有特别详细记录.看在conf.py
了*_logo
settings.`
看看其中的一些主题.由于项目是开源的,您应该能够仔细检查它们.
是时候开始收集链接了.
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
Matplotlib文档是我认为的一个很好的例子.他们甚至在记录matplotlib时有详细的描述:我认为动态生成的数字和继承图是他们对Sphinx的自定义扩展.他们的文档也有自定义徽标.
我猜你应该能够为大多数项目下载RST文档源.
http://docs.djangoproject.com/en/1.1/和http://ask.github.com/celery/是两个很好的例子.