一些很好的獅身人面像定製的例子？

Question

我使用sphinx-quickstart創建了一個Sphinx文檔。

1. 是否有任何關於自定義外觀的好示例/教程？特別要修改標題並添加徽標。

2. 是否有一些可下載的Sphinx文檔的項目？我想看看他們是如何定製他們的外觀。

更新：添加標誌的默認設置是支持，只是不是特別有據可查。在conf.py中查看*_logo設置.`

Answer 1

查看一些these themes。由於項目是開源的，你應該能夠仔細檢查它們。

Answer 2

Matplotlib documentation是我想的一個很好的例子。他們甚至在documenting matplotlib有詳細的描述：dynamically generated figures和inheritance diagrams是他們對我認爲的獅身人面像的自定義擴展。他們的文檔也有自定義徽標。

我猜你應該能夠下載大多數項目的RST文檔來源。

Answer 3

http://docs.djangoproject.com/en/1.1/和http://ask.github.com/celery/是兩個很好的例子。

Answer 4

我一直很喜歡SQLAlchemy文檔。它們與標準的獅身人面像主題非常不同，並且非常適合他們的網站。

Answer 5

blender.org新的API文檔只是得到了翻新的獅身人面像的主題是下載過

網站
http://www.blender.org/documentation/blender_python_api_2_59_release

主要站點（其中主題是基於關閉）
http://www.blender.org/

主題文件
https://svn.blender.org/svnroot/bf-blender/trunk/blender/doc/python_api/blender-org/

只是我知道的一個例子，但有趣的是看看比賽有多接近。

Answer 6

開始收集鏈接的時間。

• https://github.com/coordt/ADCtheme - 蘋果般
• https://github.com/mitsuhiko/flask-sphinx-themes - 瓶
• http://loose-bits.com/2012/11/19/sphinx-bootstrap-theme-updates.html - Twitter的引導
• https://github.com/snide/sphinx_rtd_theme - 閱讀的主題的文檔
• https://github.com/bitprophet/alabaster - 基於瓶

Answer 7

圍棋到http://pypi.python.org並在那裏搜索sphinx template。它將列出幾十個模板。然後他們每個人你可以下載並嘗試。

Answer 8

我Kenneth Reitz的主題的忠實粉絲，他使用了requests庫：

https://github.com/kennethreitz/kr-sphinx-themes