Hi,
as I'm working on the TOC stuff which will allow automatic numbering
I would like to discuss an aspect that would influence how the
numbering is realized. In particular, I'm interested in knowing what
is the typical document structure you guys use and how you apply the
headings into document sections. What I have seen on
xwiki.org is a
mixture of various patterns like:
1 title
1.1 chapter1
1.1.1 subchapter1
1.1 chapter2
or
1.1 title
1.1.1 chapter1
1.1.1.1 subchapter1
1.1.1 chapter2
or
1 chapter1
1.1 subchapter1
1 chapter2
or
1.1 chapter1
1.1.1 subchapter1
1.1 chapter2
In our team we used to use this pattern:
1 title
1.1 chapter1
1.1.1 subchapter1
1.1 chapter2
The problem is that generated numbered TOC than would look like:
1 title
1.1 chapter1
1.1.1 subchapter1
1.2 chapter2
which is not consistent with our company's standard Word documentation
structure (a common document structure, IMHO) which has this natural
TOC:
title
1. chapter1
1.1 subchapter1
2. chapter2
...
My question is whether you think it would be good idea to treat a
document title as a specific part of document and introduce a new tag
like {title} or 0 ... and have its own CSS item. In Confluence the
document title is equal to physical wiki document name and rendered
separately on top of the page.
Another possibility which would solve the generation of TOC issue is
to add an option to the TOC tag what initial heading level it should
start the generation at.
I would personally prefer to treat document title specifically as I
consider the mentioned TOC option as a kind of hack, IMHO.
Jiri.