Theme

HTMLBuilder の見た目のカスタマイズ。

• rtd の toplevelのtoctree + 現在地 が使い易い

theme		navigation
alabaster	default	toplevelのtoctree 固定
basic系	builtin	prev, next, table of contents, 現在地
rtd		toplevelのtoctree + 現在地, prev, next
sphinx_book_theme		toplevelのtoctree + 現在地, prev, next

• Sphinxを使用しているプロジェクト

• https://sphinx-themes.org/

• https://www.sphinx-doc.org/en/master/usage/theming.html

• https://sphinx-users.jp/cookbook/changetheme/index.html

• https://pypi.org/search/?c=Framework+%3A%3A+Sphinx+%3A%3A+Theme

alabaster も含めて builtin のテーマはすべて basic テーマを継承している。

• basicテーマ

その他のテーマ

• furo

• https://sphinx-themes.org/sample-sites/sphinx-rtd-theme/

• https://github.com/executablebooks/sphinx-book-theme

• https://github.com/shiguredo/sphinx_shiguredo_theme

• https://github.com/ryan-roemer/sphinx-bootstrap-theme

• https://foss.heptapod.net/doc-utils/cloud_sptheme

テーマのカスタマイズ

• customize
  • sidebar
    • コンテンツを選ぶ
    • カスタムのテンプレートを追加する
    • 更に css を追加する
  • css
  • inherit
    • 手順
• テーマの作成
  • jinja
  • pygments
  • memo