:maxdepth: 2
を含むTOC(index.rst
)を持つSphinx projectがあります。問題はrelease
セクションの深さを1
に減らして、メインのTOCにリリースノートのリストがない(リストが長すぎる)ようにしたいということです。スフィンクスTOCツリーを修正してください
それはTOCリストはdoctree-resolved
イベントハンドラを使用して変更することができるようですが、私は、イベントハンドラでTOCツリーを変更する方法を見つけ出すことはできません。
from sphinx import addnodes
def setup(app):
def update_toctree(app, doctree, docname):
if docname != 'index':
return
node = doctree.traverse(addnodes.toctree)[0]
toc = app.env.resolve_toctree(docname, app.builder, node)
# do something with "toc" here
app.connect('doctree-resolved', update_toctree)
私はTOCノードを読んで変更することはできますが、変更を維持することはできません。 – geographika