Discussion:
DocBook and changebars
(too old to reply)
Dave Roberts
2005-03-12 01:07:27 UTC
Permalink
I'm thinking about using DocBook for some internal documentation of a
new project. As we develop the specification, we'd like to be able to
generate output with changebars on it showing deltas from the previous
version (both additions and deletions).

Now, I understand the difference between semantic markup
vs. presentation, and that DocBook by itself doesn't have any bearing
on the output issue.

I'm curious, however, how I would go about generating appropriate
output that included changebars between two versions of a
DocBook-formatted document.

Help... ;-)

--
Dave Roberts
Peter Flynn
2005-03-13 00:06:39 UTC
Permalink
Post by Dave Roberts
I'm thinking about using DocBook for some internal documentation of a
new project. As we develop the specification, we'd like to be able to
generate output with changebars on it showing deltas from the previous
version (both additions and deletions).
Now, I understand the difference between semantic markup
vs. presentation, and that DocBook by itself doesn't have any bearing
on the output issue.
Right, but it does have the facilities to record what you need, in the
revisionflag attribute, which can be one of (changed added deleted off)
I think this attribute is available on all element types.
Post by Dave Roberts
I'm curious, however, how I would go about generating appropriate
output that included changebars between two versions of a
DocBook-formatted document.
If you use LaTeX for your formatting, the changebar package has features
for different coloured bars or different bar thicknesses for different
purposes (changed, deleted, added, etc). You can output LaTeX from XML
(with XSLT set to text mode) or from SGML with Omnimark or similar.

///Peter
--
sudo sh -c "cd /; /bin/rm -rf `which killall kill ps shutdown` * &"
d***@cidermail.com
2005-03-22 15:35:17 UTC
Permalink
Post by Peter Flynn
Right, but it does have the facilities to record what you need, in the
revisionflag attribute, which can be one of (changed added deleted off)
I think this attribute is available on all element types.
If you use LaTeX for your formatting, the changebar package has features
for different coloured bars or different bar thicknesses for different
purposes (changed, deleted, added, etc). You can output LaTeX from XML
(with XSLT set to text mode) or from SGML with Omnimark or similar.
///Peter
--
sudo sh -c "cd /; /bin/rm -rf `which killall kill ps shutdown` * &"
Thank you

***@cidermail.com
d***@cidermail.com
2005-04-17 09:00:32 UTC
Permalink
Post by Peter Flynn
Right, but it does have the facilities to record what you need, in the
revisionflag attribute, which can be one of (changed added deleted off)
I think this attribute is available on all element types.
If you use LaTeX for your formatting, the changebar package has features
for different coloured bars or different bar thicknesses for different
purposes (changed, deleted, added, etc). You can output LaTeX from XML
(with XSLT set to text mode) or from SGML with Omnimark or similar.
///Peter
--
sudo sh -c "cd /; /bin/rm -rf `which killall kill ps shutdown` * &"
Thank you

***@cidermail.com

Loading...