問題タブ [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.
python - Python Sphinx html 出力でサイドバーを作成できませんか?
Sphinx ツールを使用して Python プロジェクトを文書化していますが、HTML 出力は現在次のようになっています。
ご覧のとおり、ツールバーには「ナビゲーション」という見出しがあり、その下には何もありません。次のコードをconf.py
ファイルに追加すると、HTML ツールバーは同じままです (ナビゲーションの下には何もありません)。
自分でファイルを作成する必要がありますか、それとも何か間違っていますか?
私の目標は、HTML が次のようになることです。
私も作成できなかったHTMLにロゴを追加するのと同じ問題だと思います。
これらは、index.rst
私の Sphinx プロジェクトのファイルの内容です。
python - Toctree はサイドバーの現在のページとメイン ページをアクティブにします
index.rst
以下のように見えるデに問題はありません:
ただし、別のページに移動すると、私の場合はであり、以下にannotation-module.rst
示すように、サイドバーは と の両方index
を選択して表示annotation-module
します。
ただし、注釈モジュールページのみをアクティブにして、そのサブセクションを表示したいと考えています。
以下のように環境変数を探すことによってconf.py
のみ使用します。html_theme
READTHEDOCS
私のindex.rst
:
またannotation-module.rst
、何も含まれていませんtoctree
。その下にセクションしかありません。
では、サイドバーの現在のドキュメント セクションのみを有効にするにはどうすればよいでしょうか?
これは、 Steve Piercyによって要求されたドキュメントのソース ディレクトリです。
環境
- パイソン3.5
- スフィンクス 1.7.6
- スフィンクス-rtd-テーマ 0.4.0
directory - 主題が異なる Sphinx ドキュメンテーション
サブジェクトごとに 1 つのタイルを使用して、インデックスに一種のダッシュボードを構築しようとしています。各サブジェクトは、後でsource
独自の md ファイルを含む独自のフォルダーを持ちます。
各主題を他の主題と切り離してほしい。したがって、previous
ボタンは別のサブジェクトに移動するべきではありません。
構造は次のようにする必要があります:
最初にすべての主題の概要があり、次に主題ごとに 1 つの toctree を持つサブページがあり、次に各ドキュメントに独自の通常のビューがあります。
誰かが私がそれについてどうするか考えていますか?
現在、私はそのようにインデックスを作成していますが、これはファイルを分離しません: