(dsssl) How to use modular stylesheet
Subject: (dsssl) How to use modular stylesheet|
From: Dan Richter <daniel.richter@xxxxxxxxx>
Date: Fri, 02 May 2003 12:24:07 +0200
When I installed OpenJade for the first time, I had a lot of information on
DSSSL, but no information on the modular stylesheet provided with OpenJade.
(I don't even remember how I found where it was installed on my system.)
This made it difficult to understand how to do simple tasks (like change
the admonition graphics). Naturally I could read the stylesheet myself
(which is what I eventually did), but that was difficult at first because
the stylesheet contains thousands of lines of code scattered among thirty
files. I was constantly grepping (searching) to understand how this
function in this file plugged into that function in that file. It took me a
long time, for example, to realize that dbparam.dsl contained a bunch of
configurable parameters. Sure, it makes sense after the fact, but how was I
supposed to guess? It wasn't exactly easy to read through each file and try
to guess what it was doing. (It would help if there was a comment at the
top of each file that explained what it was for.)
Does anyone know of a reference that explains, on a beginner's level, how
to change the modular stylesheet? I ask this because I'm ready to write one
if there isn't one already. I think that it's perfectly normal to want to
make small changes to the titlepage without writing your own stylesheet
from scratch, and it would be major help just to know that the function
name is book-titlepage and that it's defined in dbttlpg.dsl.
========== Dan Richter ============== mailto:Dan@xxxxxxxxx ===========
Their reproof adds the / injury of insult to / the shame of failure.
- Damian Conway, whose Perl script transforms computer
error messages into haikus.
DSSSList info and archive: http://www.mulberrytech.com/dsssl/dssslist