18

sphinx-quickstartを使用してSphinxドキュメントを作成しました。

  1. 外観のカスタマイズに関する良い例/チュートリアルはありますか?具体的には、ヘッダーを変更してロゴを追加します。

  2. ダウンロード可能なSphinxドキュメントを含むプロジェクトはありますか?彼らがどのように彼らの外見をカスタマイズしたかを見たいです。

更新:ロゴの追加はデフォルトの設定でサポートされていますが、特に十分に文書化されていません。設定を探してくださいconf.py。`*_logo

4

8 に答える 8

11

これらのテーマのいくつかをご覧ください。プロジェクトはオープンソースであるため、それらを詳しく調べることができるはずです。

于 2010-01-16T00:50:31.783 に答える
10

リンクの収集を開始する時間です。

于 2012-12-07T11:46:35.373 に答える
7

Matplotlib のドキュメントは、私が考える優れた例です。ドキュメントの matplotlibにも詳細な説明があります。動的に生成された図継承図は、Sphinx のカスタム拡張機能だと思います。彼らのドキュメントにもカスタムロゴがあります。

ほとんどのプロジェクトの RST ドキュメント ソースをダウンロードできるはずです。

于 2010-01-16T01:20:32.623 に答える
5

http://docs.djangoproject.com/en/1.1/http://ask.github.com/celery/は 2 つの良い例です。

于 2010-01-16T01:41:51.583 に答える
4

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/

私が知っているのはほんの一例ですが、試合がどれほど近いかを見るのは興味深いことです。

于 2010-05-15T07:50:44.160 に答える
4

私は常にSQLAlchemyのドキュメントが好きです。これらは、標準の Sphinx テーマとは大きく異なり、サイトに非常によく適合します。

于 2010-01-16T06:27:55.847 に答える
3

http://pypi.python.orgにアクセスして、そこで検索しsphinx templateます。数十のテンプレートのリストが表示されます。次に、それらのそれぞれをダウンロードして試すことができます。

于 2013-01-23T14:22:04.257 に答える