ReadTheDocsを使用してJupyterで作成したSphinxドキュメントをホストします

Question

私は、sphinxとreadthedocsテーマを使ってJupyterノートブックをレンダリングしたgithubリポジトリを使ってReadTheDocsでビルドに失敗しました。私はRTDにしようとするが、私は失敗し、次のメッセージを取得し、ローカルでこれらをレンダリングすることができる午前：

私は、リポジトリにnbsphinx.pyファイルを配置しようとしたが、物事はまだ失敗します。 RTDへのリンクはこちらです：

https://readthedocs.org/projects/calculus-notes/

のGitHubのレポはこちらです：

https://github.com/jfkoehler/calc_docs

Answer 1

RTDはnbsphinxをインストールする必要があります。

はvirtualenvのにあなたのプロジェクトがインストールされます、プロジェクトの管理ページでvirtualenvの機能を有効にし、ユーザーが指定することができます：

1. RTD FAQ, My project isn’t building with autodocから：あなたがする必要があり、パッケージをインストールするには、RTDを伝えるために、プロジェクトのファイルはrequirements.txtです。

あなたのレポでrequirements.txtを作成し、その内容にnbsphinxを追加します。あなたがコミットし、あなたのレポにアイテム2を押した後で、RTDはnbsphinxをインストールし、正常にドキュメントを構築し、または少なくとも一つがある場合、次の故障に進むことができるはずですhttps://github.com/spatialaudio/nbsphinx/blob/0.2.14/doc/requirements.txt#L2

を参照してください。