Sphinx で _static ではないディレクトリに書き出す¶

注釈

For english reader

If you want change the output directory from _static to something, use this gist as an Extension.

Sphinxで _static 以外の場所にJSなどのファイルを書き出したい、ということがあるかもしれません。その場合のために、tk0miyaさんがそのための拡張を書いてくれました。

https://gist.github.com/tk0miya/a6b5dd01a019fb303a13

これを適当な名前を付けてconf.pyと同じディレクトリに置き、conf.pyを

sys.path.insert(0, os.path.abspath('.'))
extensions = ['sphinxcontrib_staticdir_hack.py']

というようにすればOKです。

conf.pyで

staticdir_name="なにかすきなディレクトリ名"

とし、make htmlで static ディレクトリが変更されていることを確認しましょう。

注意¶

この拡張はちょっと強引なhackをしているので、将来のバージョンでも使えるかどうかは保証しません。

要望がありましたら、MLや issues を上げてくだされば、 Sphinx側で正式に対応できるかもしれません。