Hi, all.

Barton Wright said:

> But, to be honest, for the very large, thousand-page DocBook doc
> set I maintain, we found that the profiling overhead for simple
> variable substitution put far too much of a burden on our doc build
> times, and we gave up on it.[...]
>
> For variables, we ended up with a simple Perl script substitution
> that runs on a copy of our doc source files.

We also avoid profiling/conditionals because we have very large docs, and the
two-pass processing is something we'd like to avoid. Two approaches
we have used involve having multiple files with the entities and the desired
values in them, one for each variant.

Approach one: create a catalog file for each variant that resolves a file entity
for the entity file (terrible sentence, sorry) to the desired variant. Point to 
the
desired catalog at build time.

Approach two: (we use this for documents that are assembled out of many
pieces into a staging area: simply copy the desired entity file into the 
staging area
as a "prebuild" step.)

Hope that helps somebody. Good luck, Mary!

-- Mary Tabasko

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-h...@lists.oasis-open.org

Reply via email to