問題タブ [read-the-docs]

mkdocs を使用して、マークダウンから hendrix ドキュメントを作成しています。

readthedocsに表示される場合、ドキュメントには見出しのアンカー リンクがありません。

SphinxとReadTheDocsで使用されるテーマを独自のカスタム スタイルで拡張したいと考えています。

変更が反映されるようにするには、どうすればよいですか?

私のパッケージにはmatplotlibが含まれているため、ドキュメントを読んでもドキュメントがビルドされません。私は彼らのウェブサイトのコードを使用してmatplotlibをモックしましたが、matplotlibをビルドするにはfreetypeとpngが必要であり、明らかにこれがマシンにインストールされていないため、ビルドは失敗します。私はvirtualenvを構築して、または構築せずに試しました。

これが私のconfig.pyです。

モックが機能しないのはなぜですか?

ReadTheDocs を使用して Python プロジェクトを文書化しようとしています。最初は、ビルド プロセスは次のようになると停止していました。

私はrtd faqを読み、問題を起こしていた osgeo モジュールにモックを使用しました。これで、ビルド プロセスはそのインポートを通過しますが、チョークします。

このかなり役に立たないエラーで：

私はモックの使用にまったくosgeo慣れていませんが、問題はモック モジュールであるため、 submodule がないことだと思いますgdalconst。どうすればそれを回避できますか？サブモジュールもモックする方法はありますか?

私は最近Read The Docsを使い始めましたが、すべてがとてもスムーズに進みました。今日、Read The Docs で自分のプロジェクトの開発ブランチを構築してみました。ビルドに失敗しました。数時間のデバッグの後、変更されていないマスター ブランチに戻り、再度ビルドを試みました。ビルドに失敗しました。なぜ、またはどのようにして master ブランチが昨日正常にビルドされたのに、今日はビルドが失敗したのかわかりません。

ビルドページで取得したトレースバックは次のとおりです。

この後に 2 つのコマンドが続きますが、どちらも成功したように見えます。これをデバッグするために、他の Read The Docs プロジェクトを調べたところ、数週間にわたって正常にビルドされたものの、今日は同じエラーで失敗しただけであることがわかりました。このエラーの興味深い点は、具体的なソースが提供されていないことです。他の多くのプロジェクトImportErrorには、より具体的な性質の s またはその他のエラーがあります。このエラーがどれほど漠然としているのかはっきりしない場合は、次のページの画像をご覧ください。

両方のコマンドが成功したようです。私は自分の を提供していませんし、提供していませconf.pyんconf.py.conf(Google-fu にもかかわらず、そのファイルが何であるかさえわかりません)。また、構成ファイルを提供したこともありません。私はいつも Read The Docs に必要なものをすべて自動的に生成させてきました。

私のプロジェクトは昨日構築されました。私は決してソースを変更しませんでした。今日、それは構築されません。どうすればこれを修正できますか?

私はSphinxで拡張機能を実行しようとしています.拡張機能がセクションのタイトルを検出し、それらを折り畳みセクションに変換するという考えです.セクション。

私はこのような拡張機能を書き始めました:

しかし、ここでの問題: - クリックするとメインが消える onClick 関数でボタンをバインドする方法がわかりません。- メインは未加工の html にドロップされるだけですが、これは最適ではありません。サブ ディレクティブも含まれている場合、それらは処理されないためです。- sphinx のドキュメントは、選択しなければならない場合、理解するのが非常に難しいため、その場合はノードのいくつかの呼び出し.General インスタンスですが、正確にはわかりません。

ありがとう