MkDocs で Markdown でドキュメントを書くのは良いのだが git push した時に自動でデプロイされてほしい。 そうしないといちいちサーバにログインして git pull して mkdocs build する必要があり面倒だ。 これに関しては Git フックという仕組みを使えば git push 成功したタイミングでサーバサイドで処理を行うことができる。

ということでケイタブログ様の記事を参考に以下のように定義したらうまく動いた:

cd (リモート Git リポジトリ)/hooks
vi post-receive

#!/bin/sh
cd (デプロイ先ディレクトリ
git --git-dir=.git pull
cd (MkDocs のディレクトリ)
mkdocs build

chmod +x post-receive

--git-dir=.git は必要だった。 これがないとワーキングディレクトリで git pull してもエラーになる。