sphinx-quickstart でスキャフォールドを作成したら、sphinx-docxbuilderエクステンションを使えるようにするためクローンする
mkdir exts
cd exts/
hg clone https://bitbucket.org/haraisao/sphinx-docxbuilder
conf.pyの15-30行目あたりを編集
sys.path.insert(0, os.path.abspath('exts')) # -- General configuration ----------------------------------------------------- # If your documentation needs a minimal Sphinx version, state it here. #needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. extensions = ['sphinx-docxbuilder']
Makefileにdocx用の設定を追加
docx: $(SPHINXBUILD) -b docx $(ALLSPHINXOPTS) $(BUILDDIR)/docx @echo @echo"Build finished. now you can process the docx file. $(BUILDDIR)/docx."
文書を作成してみる
make docx
おお！
業務の文書をMSWordで提出しないとだめいうカルチャーの会社は多いと思うが、文書がフォルダに収められた後に、実際に再利用されるのを見たことがある人は少ないはず(探すの面倒だし)。
そういう場合にはReSTで書けるWIKIなんかを使うと常に参照できるうえに必要に応じてレポーティング出来ていいよねと思うのだが。僕はそういうスタイルでやっていたが超快適だった。
この快適さをmoin2+Sphinxで再現したい。