問題タブ [toctree]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
0 に答える
306 参照

python - Python Sphinx html 出力でサイドバーを作成できませんか?

Sphinx ツールを使用して Python プロジェクトを文書化していますが、HTML 出力は現在次のようになっています。

ご覧のとおり、ツールバーには「ナビゲーション」という見出しがあり、その下には何もありません。次のコードをconf.pyファイルに追加すると、HTML ツールバーは同じままです (ナビゲーションの下には何もありません)。

自分でファイルを作成する必要がありますか、それとも何か間違っていますか?

私の目標は、HTML が次のようになることです。

私も作成できなかったHTMLにロゴを追加するのと同じ問題だと思います。

これらは、index.rst私の Sphinx プロジェクトのファイルの内容です。

0 投票する
2 に答える
446 参照

python - Toctree はサイドバーの現在のページとメイン ページをアクティブにします

index.rst以下のように見えるデに問題はありません:

Sphinx RTD ドキュメントのホームページ

ただし、別のページに移動すると、私の場合はであり、以下にannotation-module.rst示すように、サイドバーは と の両方indexを選択して表示annotation-moduleします。

Sphinx RTD サイドバーに両方のメニューが表示される

ただし、注釈モジュールページのみをアクティブにして、そのサブセクションを表示したいと考えています。

以下のように環境変数を探すことによってconf.pyのみ使用します。html_themeREADTHEDOCS

私のindex.rst

またannotation-module.rst、何も含まれていませんtoctree。その下にセクションしかありません。

では、サイドバーの現在のドキュメント セクションのみを有効にするにはどうすればよいでしょうか?

これは、 Steve Piercyによって要求されたドキュメントのソース ディレクトリです。


環境

  • パイソン3.5
  • スフィンクス 1.7.6
  • スフィンクス-rtd-テーマ 0.4.0
0 投票する
1 に答える
175 参照

directory - 主題が異なる Sphinx ドキュメンテーション

サブジェクトごとに 1 つのタイルを使用して、インデックスに一種のダッシュボードを構築しようとしています。各サブジェクトは、後でsource独自の md ファイルを含む独自のフォルダーを持ちます。

各主題を他の主題と切り離してほしい。したがって、previousボタンは別のサブジェクトに移動するべきではありません。

構造は次のようにする必要があります: ここに画像の説明を入力 最初にすべての主題の概要があり、次に主題ごとに 1 つの toctree を持つサブページがあり、次に各ドキュメントに独自の通常のビューがあります。

誰かが私がそれについてどうするか考えていますか?

現在、私はそのようにインデックスを作成していますが、これはファイルを分離しません: