10

Sphinx 0.6.5 を使用して作成されました。

Python のドキュメントで が使用されていることは知っていますが、 や などreStructuredTextのセクションが異なります。http://docs.python.org/whatsnew/2.6.htmlhttp://docs.python.org/tutorial/index.html

reStructuredText でこれをどのように行いますか? rst2htmlその構造を維持しながら、多数のディレクトリで実行していますか?

Sphinx を使用していることは知っていますが ( Thomas Wouters の回答で直接 rst2html ではありません)、リポジトリ内のソース コード ファイルを使用して最初の構造をどのように整理すれば、本格的な自動化されたドキュメント Web サイトを作成できますか?

4

3 に答える 3

9

Pythonのドキュメントでは、マークアップにreSTを使用していますが、直接sphinxではなく、を使用してHTMLを生成していますrst2html。このsphinxツールは、すべての個々の.rstファイルを複数の.htmlファイルに変換するものです。Pythonドキュメントがどのように生成されるかを確認するには、http： //svn.python.org/projects/python/trunk/Doc/Makefileを参照してください。

于 2010-05-18T12:30:30.037 に答える
4

Sphinx を使い始めるには、matplotlib サイトの sampledoc チュートリアルが非常に役立つことがわかりました。

于 2010-05-18T12:53:36.327 に答える
2

Python ドキュメントを正確にビルドする方法は次のとおりです。

于 2014-02-12T08:09:55.920 に答える