= Sphinx-docxbuilder について =
このソフトウェアは、SphinxドキュメントビルダでMS Word2007のファイルを出力するための機能拡張プログラムです。
現在は、次のような機能をサポートしています。
* セクションのヘッダ
* インラインマークアップ(テキストのスタイルを変更するもののみ)
* リストと引用のようなブロック
* リテラルコードブロック(ソースコード等の記述用)
* シンプルテーブル
* 一部のAdmonition
* イメージの挿入
* 独自のスタイルの変更(docx形式のスタイルファイルを指定できます)
上記の機能でも、まだ使用できないものの一部あると思います。
== 使用方法 ==
=== インストール ===
まず、Python2.6以上と下記のモジュールがインストールされていることを確認して下さい。
* sphinx 1.1.2
* lxml
* PIL (Python Imaging Libraray)
ソースコードをダウンロードして、Pythonのパス (sys.path)のディレクトリにコピーします。通常は、Sphinxが導入されているディレクトリに sphinx-docxbuilder をコピーするか、シンボリックリンクを作成して下さい。
=== Sphinx conf.pyの設定 ===
sphinx-buildコマンドでdocx形式の出力をサポートするために、conf.pyの中の 'extensions' に 'sphinx-docxbuilder' を追加します。
{{{
extensions = ['sphinx-docxbuilder']
}}}
次に、書きのコマンドを入力するとdocx形式の文書が生成されます。
{{{
$ sphinx-build -b docx [input-dir] [output-dir]
}}}
[[ReleaseList]]
[[RecentTickets(limit=5)]]