Great, thanks, Henrik. Last question. . :) For the final document,
do you piece it together manually
or do you have another top level document that includes chapters in
the same way your chapters included textblocks?
On Feb 20, 5:19 am, Henrik <hwma...@gmail.com> wrote:
> On Feb 20, 9:02 am, Andy68 <andy.jew...@gmail.com> wrote:
> > Would you mind sharing how you organize the source documents? Is it
> > all in one document or do you have them split up in a hierarchy? I do
> I have one main document and a large set of subdocuments which I call
> "textblocks". This is very similar to a program which uses subroutines
> in a library. The "textblocks" are reusable components which are used
> in several manuals. For example the description of a RS-232 port pin-
> out is used in several manuals or another example would be the usual
> safety regulations which are repeated in every manual. Referring to
> the manual posted earlier, the chapter Installation in the main
> document looks like:
> I even use AsciiDoc attributes to parametrize some of the included
> textblocks, similar to passing parameters to a function in a
> programming language.
> Hope that explains a bit the concept. It allows me to quickly create
> new manuals with little overhead and also to maintain common text
> sections across several product manuals.
