Hi,

Suppose I have:

- a `foo0.rst` file at the root (`source`) of my `sphinx-doc` source folder,
- a `foo1.rst` file in a subfolder `subfolder1` of `source`,
- a `foo2.rst` file in a subfolder `subfolder2` of `subfolder1`,

that is:

    $ tree source
    source
    ├── foo0.rst
    └── subfolder1
        ├── foo1.rst
        └── subfolder2
            └── foo2.rst

all with the same content:

    This a title
    ============

Now, if the `index.rst` contains:
    
    Welcome to Test's documentation!
    ================================
    
    .. toctree::
       :maxdepth: 3
       :caption: Contents:
    
       foo0
       subfolder1/foo1
       subfolder1/subfolder2/foo

`make html` gives:
    
    Welcome to Test’s documentation!
    
    Contents:
    
        • This a title
        • This a title
        • This a title

that is all the headings are sections.

What I would like to get instead is the following:

    Welcome to Test’s documentation!
    
    Contents:
    
        • This a title
          ◦ This a title
            ▪ This a title

that is the heading of:

- `foo0.rst` being a section,
- `subfolder1/foo1.rst` being a subsection (and not a section),
- `subfolder1/subfolder2/foo2.rst` being a subsubsection (and not
  a section).

My question is therefore: is it possible to make the heading levels of
documents belonging to (sub(sub(...)))folders automatically depending on
the depth's levels of the folders they belong to?

Thanks.
-- 
Denis

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/e66aa3df-8427-4ec5-bd05-0c4e67e3ffecn%40googlegroups.com.

Reply via email to