Sphinx Life

LastUpdated: $IsoDate$

Sphinx ともっと仲良くしたい

  • intersphinx ってなんぞや
  • テーマをカスタマイズするコツ
  • テーマを自作しよう
    • theme.conf
    • HTMLテンプレート
    • 静的テンプレート
  • Sphinxドメインっておいしい?
  • reST / Sphinx 英語ドキュメントについて翻訳したい
  • オレオレ role どうつくる
  • オレオレ directive どうつくる
  • オレオレ extension どうつくる (プラグイン)
  • Sphinx のパーサ/ライター

シングルソース マルチアウトプット

  • make html の使い方
  • make pdf の使い方
  • make man の使い方
  • make epub の使い方
  • make text の使い方

reST と他の構造化記法との変換

  • JSON
  • YAML
  • XML
  • textile
  • pukiwiki
  • markdown

Sphinx な悩み

  • テーブルで colspan rowspan 使えない?
  • include を使うと heading が衝突する! rubric で回避?
  • quoteが変わって困る場合はhtml_use_smartypantsをFalseに!
  • ハイパーリンクが重複扱いになる -> hoge
  • calendar これは重複扱いにならない
  • debian で最新版使いたい。
    • /etc/apt.sources に1行追加して update
  • クロスリファレンスの逆方向確認できないか?
  • デッドリンクを確認したい。make linkcheck