Geraint North wrote:
It seems to me that there are two ways to manage changes to the XSLT
stylesheets:
1. Modifying the parameters/templates in-place.
2. Adding a customisation layer, duplicating (and thus overriding) the
parameters and templates that you specialise.
Initially, I went for the former approach, which was recommended in
"DocBook XSL: The Complete Guide", however, having just moved my changes
up from Docbook XSLT 1.68 to 1.73, I've switched to an approach where I
just modify the parameters and template in-place.
Confused. As you say, each time you update you lose your changes if
you modify 'docbooks' stylesheets.
A customization layer is much nicer, and re-usable.
E.g. if your directory stuff was in one stylesheet, I could include that
before the docbook ones. Then I get mine, yours, docbooks, all in
the right priority order.
This means that when
I update to future versions of the XSLT, I can apply the diffs and
resolve conflicts as appropriate - as it stood, I'd modified cloned
copies of templates that had changed significantly in the update, and
that wasn't caught until I manually went back to look at the 'new'
original templates.
I did that. Found it painful (docbook committee are really active :-)
when I had to keep re-doing it and eventually realized that providing
a customization layer to override the as installed set, it worked well.
However, this means that if I wanted to distribute any of my changes,
I'd be distributing them as a patch, rather than as a single file that
overrode the relevant templates - is this something that people
generally do?
No, see above... if you're as lazy as [some] of us, and want to
avoid rework.. rework.. rework :-)
Thinking of it, is there a page anywhere where people can distribute
their enhancements to the stylesheets?
That's what I was hoping for.
1. Your schema updates.
2. Your stylesheet customizations.
I don't think it's been addressed in the past.
As I offered before, if no reply, I'd be happy to add them to a new
section in the docbook faq.
Or perhaps a link from the docbook wiki?
regards
--
Dave Pawson
XSLT, XSL-FO and Docbook FAQ
http://www.dpawson.co.uk
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
