OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

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

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]