Re: [docbook-apps] ?How to mark changebars, a couple of profiles, AND use profile-docbook?

["Bob Stayton" <bobs@sagehill.net>]

The changebars.xsl stylesheet is a customization layer, which means it
imports docbook.xsl and adds stuff.

But it is the last step in making changebar output, after you have run a
program that generates a diffs document in XML for changebars.xsl to format.
You need to investigate Norm Walsh's diffmk, which is available here:

http://nwalsh.com/java/diffmk/index.html

The first link on that page is to Norm's essay "Making All the Difference",
which is helpful for understanding the process, but apparently Sun removed
it from their website.  If you google on diffmk plus that title in quotes,
you will get a hit on it.  The direct link doesn't work, but the "cached"
link does.  I guess it hasn't been gone long.

Norm also includes some doc in the diffmk download.  The first version was
Perl, but the current version is Java.  I've never used it myself, but I
would be curious to hear from others who have.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Billard, Trish" <trish.billard@hp.com>
To: <docbook-apps@lists.oasis-open.org>
Sent: Friday, September 24, 2004 2:15 PM
Subject: [docbook-apps] ?How to mark changebars, a couple of profiles, AND
use profile-docbook?


Hi,
  I'm using the 1.65.1 version of the stylesheets, and I'm trying to figure
out how to best do the same kind of markup (add divs and spans) as is done
for the revisionflag attribute for the os and arch attributes, and still be
able to do profiled and chunked output for HTML and HTML help.
  I noticed the changebars.xsl stylesheet imports docbook.xsl.  Which
template calls changebars.xsl?  Or is it intended that the customization
layer call changebars.xsl instead of docbook.xsl?

I'm trying to figure out how best to ensure that I get div/span tags for
each element that has revisionflag, os, arch, or some combination of the
three attributes, and yet still do proper profile-chunking.
Any guidance?


Trish Billard
trish.billard@hp.com
(408) 285-5462