[Suggestion] : Section Numbering Schemes
C. Michael Pilato
cmpilato at red-bean.com
Wed Jan 10 14:08:03 CST 2007
Ramanathan Muthaiah wrote:
> Am not sure, if this has already been debated in the core group; but,
> I would like to put forward my suggestion:
> Apart from chapter numbers, found in the svn book (v1.3), I do not
> find numbering schemes followed for major sections / subscetions.
> Is there any reason not to have this style ?
Section numbers are a feature of the DocBook translation process, not of
the DocBook markup itself. I prefer them remain disabled for a number
* The book was originally composed as work destined for hardcopy,
an O'Reilly publication. O'Reilly doesn't use section numbering
in its books. In fact, I know of *no* publisher that uses
section numbering in their books.
* I've seen far too many documents with 6-level section numbers,
and the eye is far too easily fooled into thinking that, at quick
glance, 220.127.116.11.1.1 and 18.104.22.168.1.1 are the same number.
* Our sections move around as we edit things, so their numbers would
also change, and that's undesirable.
* It isn't the default behavior for any of our output translations.
* It reeks of Microsoft Word. (Can't you smell it?)
The book has two target markets: the Web (in which case folks pass
around URLs instead of chattering about "section 22.214.171.124 of the Book"),
and your bookshelf (where book versions and page numbers quite suffice
in terms of a coordinate system for identifying book content).
Of course, if you wish to generate the book in a format that has section
numbers, and that would better serve your purposes in some way, you are
more than welcome to do so! It's just a tiny tweak to the XSL
parameters. Attached is a patch that seems to work.
C. Michael Pilato <cmpilato at red-bean.com>
"The Christian ideal has not been tried and found wanting. It has
been found difficult; and left untried." -- G. K. Chesterton
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 1218 bytes
Desc: not available
More information about the svnbook-dev