2012年4月11日

Sphinx のドキュメントデザインに Twitter Bootstrap を使う

テンプレートを差し替えてみたら思ったよりもすんなりできたのでメモ。

  1. Sphinx でドキュメントを書く。
  2. _templates ディレクトリに "layout.html" を置く。(下記)
  3. Twitter Bootstrap のサイトから ZIP パッケージをダウンロードする。
  4. パッケージを解凍する。
  5. _static ディレクトリに "css", "js", "img" をコピーする。
  6. make html で HTML をビルドする。
  7. ブラウザで表示を確認する。

(テーマは default にしておく)

初版のコード: めも:
  • セクションタイトルがナビゲーションバーの右側に表示されてしまう。
  • fluid のレイアウトもサポートできると便利そう。
  • well とか hero-unit クラスをサポートできると見栄えが整いそう。
  • グリフアイコン用の記法みたいなものを定義しておくと、ドキュメントを書いているときに嬉しい。

0 件のコメント: