Hello,
the html file generated from tm module docbook does not have a table of content, which is very handy to browse and have links inside the file when referring to a function or parameter. See for comparison: http://sip-router.org/docbook/sip-router/branch/master/modules/tm/tm.html http://sip-router.org/docbook/sip-router/branch/master/modules/lcr/lcr.html
This seems to be because of using <section> as root tag, the modules coming from K use <book> and ToC is generated. I tried with <chapter> as root tag and I got ToC.
Can be <section> upgraded to <chapter>/<book>? Or is used somewhere in this form and shall have new file, like tm-book.html, that has <book> at top of document and will be used for online docs?
Cheers, Daniel
On 30-05 19:54, Daniel-Constantin Mierla wrote:
Hello,
the html file generated from tm module docbook does not have a table of content, which is very handy to browse and have links inside the file when referring to a function or parameter. See for comparison: http://sip-router.org/docbook/sip-router/branch/master/modules/tm/tm.html http://sip-router.org/docbook/sip-router/branch/master/modules/lcr/lcr.html
This seems to be because of using <section> as root tag, the modules coming from K use <book> and ToC is generated. I tried with <chapter> as root tag and I got ToC.
Can be <section> upgraded to <chapter>/<book>? Or is used somewhere in this form and shall have new file, like tm-book.html, that has <book> at top of document and will be used for online docs?
This is configurable in the stylesheets that convert docbook documents to HTML documents. I updated the configuration so that we get TOC even for documents that have <section> as the root element.
This change should be visible in the documentation that is online in a couple minutes.
Jan.
On 06/01/2009 06:33 PM, Jan Janak wrote:
On 30-05 19:54, Daniel-Constantin Mierla wrote:
Hello,
the html file generated from tm module docbook does not have a table of content, which is very handy to browse and have links inside the file when referring to a function or parameter. See for comparison: http://sip-router.org/docbook/sip-router/branch/master/modules/tm/tm.html http://sip-router.org/docbook/sip-router/branch/master/modules/lcr/lcr.html
This seems to be because of using <section> as root tag, the modules coming from K use <book> and ToC is generated. I tried with <chapter> as root tag and I got ToC.
Can be <section> upgraded to <chapter>/<book>? Or is used somewhere in this form and shall have new file, like tm-book.html, that has <book> at top of document and will be used for online docs?
This is configurable in the stylesheets that convert docbook documents to HTML documents.
even better.
I updated the configuration so that we get TOC even for documents that have <section> as the root element.
This change should be visible in the documentation that is online in a couple minutes.
Thanks, Daniel