作成日: 2019.03.05

MkDocsのFooterをカスタマイズする

MkDocsを使っているとFooterを直接カスタマイズしたいと思うことがある。

具体的にはファイルを上書きする、という方法があるのでそれを述べる。

前提としてMaterial for MkDocsを使用しているものとする。

1. Material for MkDocsのダウンロード

MkDocsを上書きするために、上書き元となるファイルをダウンロードする。
まずはバージョンを確認。

1 2	`$ pip list \| grep mkdocs-material mkdocs-material (4.0.1)`

対象バージョンのMaterial for MkDocsを任意の場所にダウンロードする。
(たまたま最新だったので、最新のをダウンロード)

1	`$ git clone https://github.com/squidfunk/mkdocs-material.git`

カスタムディレクトリを設定する。
カスタムディレクトリ、とはこのディレクトリ配下に置いたhtmlファイルが上書きされる、ということを意味するディレクトリである。

$ vi mkdocs.yml

theme:
    custom_dir: 'custom_dir'

MkDocs for Materialのボディに相当するファイルは以下にあるので、これをカスタムディレクトリ配下にコピーする。

1	`$ cp ~/mkdocs-material/material/partials/footer.html ./custom_dir/partials/footer.html`

以降、./custom_dir/partials/footer.htmlファイルを書き換えれば上書きされる。