-- Andrew Ballard <[email protected]> wrote (on Monday, 22 February 2010, 03:01 PM -0500): > Is it possible to make the headings in the manual hierarchical? As > they are, they all seem to be heading level 1 which makes it difficult > to visually scan one of the pages and keep related blocks together.
I'll see what I can do; part of this is due to limitations of parsing the DocBook into HTML. In DocBook, you have <sectX ...><title>...</title>...</sectX> -- and the conversion uses the value of "X" to determine the <hX> value. The problem with this is that, traditionally, each chapter starts with a <sect1>... and sometimes multiple chapters are aggregated into a single page. I'll do some experiments in the coming weeks to see if I can tweak this a bit, though. > For example, consider this page: > > http://framework.zend.com/manual/en/zend.validate.set.html > > The current list of headings includes: > Alnum > Alpha > Barcode > Basic usage > Optional checksum > Writing custom adapters > Between > Callback > Basic usage > Usage with closures > Usage with class-based callbacks > Adding options > CreditCard > Basic usage > Accepting defined credit cards > Validation by using foreign APIs > Ccnum > Date > Db_RecordExists and Db_NoRecordExists > Basic usage > Excluding records > Database adapters > Database schemas > > > Shouldn't many of these be a lower heading level (with a corresponding > visual difference in the stylesheets)? > > Alnum > Alpha > Barcode > Basic usage > Optional checksum > Writing custom adapters > Between > Callback > Basic usage > Usage with closures > Usage with class-based callbacks > Adding options > CreditCard > Basic usage > Accepting defined credit cards > Validation by using foreign APIs > Ccnum > Date > Db_RecordExists and Db_NoRecordExists > Basic usage > Excluding records > Database adapters > Database schemas > > > Andrew > -- Matthew Weier O'Phinney Project Lead | [email protected] Zend Framework | http://framework.zend.com/ PGP key: http://framework.zend.com/zf-matthew-pgp-key.asc
