問題タブ [django-sphinx]

Django プロジェクトに対して PR を作成した後、Sphinx は実行時に次の警告を発します。

ローカル:

基本的に、Sphinx は参照が欠落していると報告しています。

エラー (実際には警告) は、ドキュメントのビルド中にも発生します: http://djangoci.com/job/docs/7444/console。

同様の問題を報告する質問への回答は、編集を提案しdocs/conf.pyます。ただし、この場合、docs/conf.pyDjango プロジェクト全体を編集することになるため、これはオプションではありません。

変更を伴わないこの問題の解決策はありdocs/conf.pyますか?

これは、index.rstビルドを作成するために make HTML を実行してこのファイルを作成した後の私のファイルです。ただし、index.htmlファイルには小見出しのライセンスとヘルプがありません。ソースディレクトリlicense.rstに手動で作成する必要がありますか? help.rstビルド中に自動的に生成されますか?

sphinxコマンドを使用してhtmlを作成しましmake htmlたが、見出しとコンテンツを含む単一ページのドキュメントが必要です。特定の見出しページをクリックすると、対応するコンテンツまで自動的にスクロールダウンします。