sphinx-quickstartを使用してSphinxドキュメントを作成しました。
外観のカスタマイズに関する良い例/チュートリアルはありますか?具体的には、ヘッダーを変更してロゴを追加します。
ダウンロード可能なSphinxドキュメントを含むプロジェクトはありますか?彼らがどのように彼らの外見をカスタマイズしたかを見たいです。
更新:ロゴの追加はデフォルトの設定でサポートされていますが、特に十分に文書化されていません。設定を探してくださいconf.py
。`*_logo
sphinx-quickstartを使用してSphinxドキュメントを作成しました。
外観のカスタマイズに関する良い例/チュートリアルはありますか?具体的には、ヘッダーを変更してロゴを追加します。
ダウンロード可能なSphinxドキュメントを含むプロジェクトはありますか?彼らがどのように彼らの外見をカスタマイズしたかを見たいです。
更新:ロゴの追加はデフォルトの設定でサポートされていますが、特に十分に文書化されていません。設定を探してくださいconf.py
。`*_logo
これらのテーマのいくつかをご覧ください。プロジェクトはオープンソースであるため、それらを詳しく調べることができるはずです。
リンクの収集を開始する時間です。
Matplotlib のドキュメントは、私が考える優れた例です。ドキュメントの matplotlibにも詳細な説明があります。動的に生成された図と継承図は、Sphinx のカスタム拡張機能だと思います。彼らのドキュメントにもカスタムロゴがあります。
ほとんどのプロジェクトの RST ドキュメント ソースをダウンロードできるはずです。
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/
私が知っているのはほんの一例ですが、試合がどれほど近いかを見るのは興味深いことです。
私は常にSQLAlchemyのドキュメントが好きです。これらは、標準の Sphinx テーマとは大きく異なり、サイトに非常によく適合します。
http://pypi.python.orgにアクセスして、そこで検索しsphinx template
ます。数十のテンプレートのリストが表示されます。次に、それらのそれぞれをダウンロードして試すことができます。