MkDocsのテンプレートをカスタマイズする方法

概要

• Jinja2で作られている
  • Python向けのテンプレートエンジン
  • これを理解することで自在にカスタマイズできる。たぶん
• テンプレート変数について、まともなリファレンスはないので、mkdocsのGitHubリポジトリを眺めて知るのが早い
  • www.mkdocs.org にも一応書いてあるが、網羅されていない

カスタマイズ方法

• まずはMaterial for MkDocsを読んでリファレンスを理解する
  • 設定で解決する内容ならここで終わり
• テンプレートのカスタマイズが必要な場合、overrides/main.htmlを生やしてブロック単位でいじる
  • 元のブロックはgithub.comを参考にする
  • 構文はjinja.palletsprojects.com