問題タブ [read-the-docs]

次を使用して、htmlファイルとして保存されたインタラクティブなグラフをreStructuredTextドキュメントに埋め込もうとしていますiframe:

html ファイルはファイルと同じディレクトリにあり.rstますが、グラフが表示されず、file could not be foundエラーが発生します。

ただし、外部の html ファイルを_build/htmlディレクトリに貼り付けると、グラフは正常に表示されます。グラフが自動的に埋め込まれるように、この html ファイルを適切に埋め込むにはどうすればよいmake htmlですか?

私が欲しいものの実用的な例。

GitHub Enterprise リポジトリから RTD ページを作成しようとしています。公開されており、ここで見ることができます。ただし、RTD でリポジトリをインポートしているときにエラーが発生します。

このリポジトリには有効な Webhook が設定されていません。つまり、リポジトリへのコミット時に再構築されません。これを修正するには、Webhook を再同期します

import manuallyエンタープライズ github アカウントを readthedocs アカウントに接続できないため、このリポジトリをインポートするオプションを使用しています。

readthedocs service以下に示すように、このレポに を追加しました。

また、最近の配信の下にいくつかのjsonデータを警告とともに取得していますInvalid HTTP Response 400:

リクエスト:

ヘッダー:

ペイロード：

応答 400:

ヘッダー:

体：

特定のテストを実行するときにベースマップに依存するプロジェクト (最近参加した) があります。setup.py だけで "basemap" を指定すると、Travis CI では次のようになります。

これを回避するために、以前のメンテナーはrequirements.txtファイルを次のように開始しました。

travis yaml に次のようにインストールします。

その後、残りの Travis インストールが機能します。Readthedocs がドキュメントをビルドしようとすると、自動的に要件ファイルが取得されます (デフォルトは と表示されますがNone) が、libgeos が見つからない場合は失敗します。これを回避するために、readthedocs.ymlファイルを作成して試しました：

Rtdが「クローニング...」でハングする原因となったので、試しました：

これもハングします。私の最終的な実用的な解決策は、「docs/requirements.txt」に空のファイルを作成し、それを Rtd に指定することでした。

これを解決するより良い方法はありますか？私が行方不明であることは明らかですか？

私はつい最近 (昨日) sphinx の使用を開始し、自分のプロジェクトのドキュメントを読みました。

今のところ Html ドキュメントに満足していますが、pdf バージョンには目次見出し内のインデックスに表示されるすべての記事が含まれています。Documents の元のコンテンツ/インデックスは、単純に 2 つのリンクで構成されています。

助けてください。

ドキュメントはhttp://todx.rtfd.ioにあり、pdf はhere にあります。