2

Qt Assistant で表示するために sphinx を使用して Python ドキュメントを生成しましたが、Python 開発者がドキュメントに使用するテーマには Qt Assistant で問題があるようです。ドキュメントを生成する前にテーマをオーバーライド/変更する方法はありますか?

ここに画像の説明を入力

ありがとう！

PS: ここhttp://docs.python.org/devguide/documenting.html#using-make-make-batmake htmlからいくつかの指示に従いましたが、実行する代わりにsphinx-build -b qthelp . build/qthelp後でqcollectiongenerator-qt4 build/qthelp/Python.qhcp. Sphinx 1.1.3 を使用しました。</p>

4

2 に答える 2

1

Sphinx でのテーマ設定は簡単です。Sphinx パッケージ ディレクトリで変更したいテーマを見つけるか、インターネット上のさまざまなテーマから何かを選択するだけです。あなたがする必要があるのは、テーマをいくつかのフォルダ（たとえば_themes）に置き、このフォルダをあなたのconf.py. conf.pyデフォルトでは、テーマパスの行があるはずです。conf.pyの下にテーマの名前を使用しますhtml_theme。

それはトリックを行う必要があります。

ほとんどの標準テーマは、テーマに基づいておりbasic、そのクラスのほとんどを継承しています。このテーマにはほとんどのものが明示的に含まれており、継承の混乱がないため、サンドボックスとして使用することを検討してください。

また、あなたのカスタム ビルダーに気付かずにはいられませんでした。ここでもカスタムビルダーが問題になる可能性があります。Sphinx の HTML テーマは、標準の HTML ビルダーで最適に機能します。ただし、基本的なテーマは見た目の美しさを取り除いているため、おそらくワークフローでうまく機能する可能性があります.

于 2014-03-31T08:47:40.393 に答える