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
à + 
--
toggg
--
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php
|