このエントリーをはてなブックマークに追加

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

注釈

For english reader

If you want change the output directory from _static to something,usethis gistas anExtension.

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

これを適当な名前を付けて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側で正式に対応できるかもしれません。