**************************************************************** Sphinx Life **************************************************************** LastUpdated: $IsoDate$ .. # LastUpdate: $IsoDate$ # Revision: $ShortRevision$ # Committer: $Author$ # Filename: $Basename$ # $Source$ ================================================================ 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`_ これは重複扱いにならない .. _Calendar: http://calendar.jp/ * debian で最新版使いたい。 * /etc/apt.sources に1行追加して update * クロスリファレンスの逆方向確認できないか? * デッドリンクを確認したい。make linkcheck