39. $ make html
...
Build finished. The HTML pages are in _build/html.
"make html" コマンドで
_build/html ディレクト
リ以下にhtmlファイル
が生成されます
最初のmake html
39
3. Sphinxインストール
Demo
伝統の「おまえ誰よ」から。
清水川です。
オープンソースで3つの活動をしています。
1. Sphinx co-maintainer since the end of 2011.
2. organize Sphinx-users.jp users group in Japan.
3. member of PyCon JP Committee.
BePROUDで働いています。
弊社では、主にDjangoやPyramidなどを使ってWebアプリケーション開発を行っています。
最近、Pythonトレーニング事業、Python技術サポート事業も始めました。
自宅勤務が週5日までOK、スタンディングデスクあり、ラジオ体操ありの会社です。
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