django - Sphinx ドキュメントと django の統合

Question

django プロジェクトのスフィンクス ドキュメントを作成しました。build フォルダー、html フォルダー、および index.html ファイルを作成しました。確信が持てないのは、index.html ファイルをプロジェクトに統合する方法です。URL構成に単純に追加することは可能ですか?どのようにフォーマットされますか?

Answer 1

IMO、これを行う「最良の」方法は、Django 自体ではなく、HTTP サーバー レベルで行うことです (少なくとも、私が過去に行った方法です)。Sphinx ドキュメントを提供するために Django レイヤーの一部は必要ありません。必要なのは、それを行うための「バニラ」Web サーバーのセットアップだけです。

また、Django の使用を主張する場合、これはDjango の URL を HTML テンプレートに直接変換するのに役立つ可能性があります...ただし、ルートの下に /docs ディレクトリをセットアップし、基本的な Apache/NGINX/ を介して sphinx データを指すように投票します。などの設定。