mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Explain absolute paths in toctree.
This commit is contained in:
parent
b50e09e33e
commit
8d6aa310fe
@ -34,9 +34,10 @@ tables of contents. The ``toctree`` directive is the central element.
|
|||||||
|
|
||||||
This directive inserts a "TOC tree" at the current location, using the
|
This directive inserts a "TOC tree" at the current location, using the
|
||||||
individual TOCs (including "sub-TOC trees") of the documents given in the
|
individual TOCs (including "sub-TOC trees") of the documents given in the
|
||||||
directive body (whose path is relative to the document the directive occurs
|
directive body. Relative document names (not beginning with a slash) are
|
||||||
in). A numeric ``maxdepth`` option may be given to indicate the depth of the
|
relative to the document the directive occurs in, absolute names are relative
|
||||||
tree; by default, all levels are included. [#]_
|
to the source directory. A numeric ``maxdepth`` option may be given to
|
||||||
|
indicate the depth of the tree; by default, all levels are included. [#]_
|
||||||
|
|
||||||
Consider this example (taken from the Python docs' library reference index)::
|
Consider this example (taken from the Python docs' library reference index)::
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user