10

ドキュメントを toctree に挿入すると、表示されるリンクはドキュメントのメイン タイトルになります。だから私がするとき：

.. toctree::
   materials/diffuse
   materials/glossy
   materials/specular

私は得る：

材料

  • 拡散素材
  • 光沢のある素材
  • 鏡面反射素材

「マテリアル」という言葉は、toctree では明らかに冗長ですが、ドキュメントのタイトルでは理解を深めるために重要です。

RST を使用すると、次のように記述できます。

.. toctree::
   Diffuse<materials/diffuse>
   Glossy<materials/glossy>
   Specular<materials/specular>

しかし、ドキュメントの名前を変更するにはインデックスの toctree を更新する必要があり、リンクの更新が MediaWiki から Sphinx に移行した理由なので、私はこれが好きではありません。また、これにより、toctree での :glob: とワイルドカードの使用が無効になります

質問:たとえば「diffuse.rst」で、リーフ ドキュメント自体に toctree タイトルをメタ プロパティとして指定する方法はありますか?

ありがとう！

4

1 に答える 1