SphinxでS6のスライドを作る

プライベートで最近開発したものなどを発表する会を同期とやろうっていう話になって、スライドを作る機会があったんで使ってみた。rest書くの自体卒論ぶりなんでSphinxのインストールから書く

環境はUbuntu 11.10

1.Sphinxのインストール

sudo apt-get install python-sphinx

sphinx-quickstartが実行できるようになっていればOK。

2.docutilsのインストール

sudo easy_install docutils

3.S6用テーマのインストール

sudo easy_install sphinxjp.themes.s6

4.スライドを書く

表紙タイトル
================

タイトル
--------------

* hoge
* funi

タイトル2
--------------

* foo
* bar

など。書けたら*.rstという拡張子で保存しておく

5.sphinx-quickstart実行

対話式で進めていく。わからないところはデフォルトでEnterして問題ない

6.conf.py編集

conf.pyがカレントディレクトリに作成されているはずなので、編集する。編集するのは以下の2箇所

extensions = ['sphinxjp.themecore']
html_theme = 's6'

make htmlする

make html

とすると、_build/html/以下にスライドができてるはず。
_static/ディレクトリにcssとかjsが入ってるんで、これも一緒にコピーしないとHTMLが半裸状態になります