私のプログラムのドキュメントは主にSphinxで書かれていますが、2 つのカスタム HTML ページも含まれています。
これら 2 つの HTML ファイルは、Sphinx ではなく、プログラム自体によって生成されます。
Read the Docsで自分のドキュメントをホストしたいのですが、Sphinx ドキュメントと一緒にバージョン管理された 2 つのカスタム ページを構築してホストすると非常に便利です。
[プロジェクトのインストール] オプションが有効になっているため、プログラムは既に RtD ビルド環境にインストールされています。また、RtD のドキュメントでは独自の builder の作成について言及されているため、そこからプログラムを呼び出して、特定の場所に HTML コンテンツをダンプさせることができる可能性があると考えています。
だから私は本当に2つの質問があります:
これは Read the Docs の適切な使い方ですか? 任意の Web ページをホストするようには設計されていないと思いますが、これらのファイルは任意ではなく、ドキュメントの重要な部分です。
どうすれば実装できますか?RtD APIの意味を理解するのに苦労しています。この「ビルダー」はSphinx ビルダーに関連していますか? RtD に接続するにはどうすればよいですか? おそらくどこかに例がありますか?