39.
$ make html
...
Build finished. The HTML pages are in _build/html.
"make html" コマンドで
_build/html ディレクト
リ以下にhtmlファイル
が生成されます
最初のmake html
39
3. Sphinxインストール
Demo
49.
Sphinx i18n機能でのドキュメント翻訳プロセス
49
4. Sphinxの拡張
reST pot
html
po
make gettext
sphinx-intl
make html
ドキュメント作者
翻訳カタログ
翻訳済カタログ
翻訳者
翻訳者
翻訳者
作者 / 翻訳者
アップロード
翻訳者
clone
翻訳者
Relation between Sphinx and Docutils. Sphinx is created in 2007 based upon Docutils library. Docutils and Sphinx supports reStructuredText it called reST, it's an extensible markup.
Comparing Docutils and Sphinx. OK, I'll read it.
1. D: handle Single page. 1. S: can handle multiple pages. 2. D: can link to others with full name include ext as like as '.html'.2. S: can connect all pages under single tree structure by using toctree. 3. D: can make Cross reference in a page3. S: can make cross reference over each other pages (without a extension). 4. D: provides writers: html, latex, man, xml, ...4. S: will provide additional writers: html(w/ themes), pdf(latex), texinfo, epub, … 5. D: can handle standard reST markup specs 5. S: will provide additional markup specs: autodoc directive and so on