[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [docbook] Polymorphic Modular DocBook
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égnis 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: docbook-unsubscribe@lists.oasis-open.org > For additional commands, e-mail: docbook-help@lists.oasis-open.org --
begin:vcard fn:Scott Hudson n:Hudson;Scott org:Flatirons Solutions;Content Management Services adr:Suite 200;;4747 Table Mesa Drive;Boulder;CO;80305;USA email;internet:scott.hudson@flatironssolutions.com title:Consultant tel;work:303-542-2146 tel;cell:303-332-1883 note:Knowledge is Power. Sharing is Empowerment. x-mozilla-html:TRUE url:http://shudson310.blogspot.com version:2.1 end:vcard
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]