Hi Camille,
IMO, DocBook works very well for modular documentation. That said, I
usually recommend chunking at the section level, leaving the book,
chapters, etc. as "assembly templates/documents". The book and chapters
contain the higher level wrappers and additional verbage that is
appropriate for that level, and then contain entity references or
XIncludes to the section-level chunks that are to be reused.
Best regards,
--Scott
Camille B嶲nis wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hi all,
>
> I used big words in the subject, but it's a simple issue: When doing
> modular DocBook, it sometimes happen that a "chapter" module wants to be
> reused as an "appendix" for example...
>
> Is the only solution to use tinier modules by chunking at the "section"
> level, or is there something more intelligent?
>
> Or should we consider DocBook is not meant to be extremely modular,
> other grammars like DITA are more suited?
>
> Interested in hearing your experience.
>
> Camille.
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.2.2 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFEmonQjv9P65BfOUMRAuqFAJ9RlFh43Jn//l5LCaP9/yN1S8D2qQCfRxNG
> IV+TMnLp+nz+mQJ5OBN92fg=
> =iban
> -----END PGP SIGNATURE-----
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail:
> For additional commands, e-mail:
--
