tl;dr Read the Docs (RTD)でよくわからないバグでコンパイルできない -> Dockerを使うと簡単にデバッグできるよ。 問題 RTDにはじめてドキュメンテーションを登録してみたところ、エラーでまくり。 このGithubレポジトリをこのRTDとしてアップロード。 ローカルの環境ではうまくいくのにImportErrorがでていた。 やったこと 公式ドキュメンテーションにあるとおりRTDはそのドキュメンテーションビルド手順を完全に公開しています。また、ビルドに使う環境のdockerイメージも公開しているので、手元で同等の環境を作り、デバッグすることが容易です。 まず、dockerイメージをpullし、interactive shellで起動します。 export READTHEDOCS=1 # 追加分 mkdir -p /home/docs/checkouts/readt
