Subject: Re: [docbook] Easiest way to define ProductName variable?
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