10

plugins/index.html に次のページがあります。

Plugin Development
==================

.. toctree::
   :hidden:

   basics/index
   advanced/index


The Basics
----------

- :doc:`basics/gettingstarted`
- :doc:`basics/resources`
- :doc:`basics/i18n`


Advanced Topics
---------------

- :doc:`advanced/models`
- :doc:`advanced/controllers`
- :doc:`advanced/services`

plugin/basics/index.html と plugins/advanced/index.html には、plugins/index.html にリストされている同じサブページにリンクする独自の toctree が含まれています。私が疑問に思っているのは、私がやっているようにサブページを手動でリストするのではなく、それらのサブ toctree を含める方法はありますか?

toctree から :hidden: フラグを削除するだけでよいことはわかっていますが、要点は、基本/高度なトピックを、独自の見出し、導入段落などを含む別のリストに保持したいということです。

4

1 に答える 1

5

次のように (またはこれらのディレクティブのさまざまな組み合わせで) ディレクトリの内容全体を一覧表示できます。

.. toctree::
  :glob:
  :titlesonly:
  :maxdepth: 2

  **

または私もこのように思います（未テスト）：

.. toctree::
  :glob:
  :titlesonly:
  :maxdepth: 2

  *
  basics/*
  advanced/*

ただし、手動でリストすることが最善の方法であることがよくあります。自動生成された TOC は優れていますが、書式設定の余地があまりありません (たとえば、サブ見出しの作成、ページの順序の変更など)。

私たちのドキュメントでは、最初の質問であなたがしたこととほとんど同じことをしました。

于 2012-11-02T01:44:05.327 に答える