Re: Text_Wiki doc ... DocBook

Hello Martin !

On Sat Feb 04, 2006 at 12:4602PM +0100, bertrand Gugger wrote:

For Text_Wiki itself, the intention is to enable some "copy" of the official wiki doc to integrate it in the PEAR manual.

Be aware that the PEAR manual is not really "vanilla" DocBook. Due to the fact that we are writing a <book> you must make sure that the documentation is converted into a <refsect1> and not into e.g. an <article>. Actually, it's a dream, I don't expect to be able to auto-generate a whole doc in a near future.

It will first only enable some conversions of chunks of DocBook to be manually integrated. Anyway, you're right to point out that the sectioning produced has to be highly configurable. We know in Text_Wiki only headings with numeric levels (as h1, h2 ...). These levels are not necessarly contiguous (may start as h2 then skip to h4, for example) and are unlimited (or only limited by the parser) 1) Docbook requires contiguous sectioning (if not using the recursive <section>) 2) It can use various flavor of sectioning, from Sets down to sections, themselves can be <sectX>, <refsectX>, recursive <section> ... I need to implement it in such a way the user can configure what sectioning s?he wants, for the global document and the nested levels. This choice has to be applied sequentially, independantly of the parsed headings levels. Thanks for your comment &agrave; + :) -- toggg