docbook: Thread: What is needed when using xml and ldp xsl files?

Hi

I am finding it difficult to determine a clear path to create documents 
acceptable to tldp. I fully understand the wish to keep choices open to 
encourage people to participate in their preferred way but this has led to 
some confusion on my part. Probably not difficult.
There are a whole host of how-to's and similar documents providing 
information and advice. The problem is that as one reads more of them, one 
comes across more and more contradictions. This is not surprising as 
different people have found different ways of doing things. As none of the 
documents appears definitive, it is not possible to just follow one and 
disregard the others. I understand that this is a subject which one can not 
just sit down and write the perfect how-to for before breakfast but for the 
future, it might be worth looking at tidying up these documents into a 
smaller number of more coherent guides. I know I should volunteer at this 
point but I am so muddled in my understanding that I think I would only cause 
further confusion. I can't even build a how-to at the moment.  :-)This brings 
me onto some nitty-gritty I need some help with.

With reading and help from this forum (for which thanks), I have worked out 
that the preferred route forward to create new documents is using XML. OK.

What do I need:-

I have made a clean installation of openjade 1.3.2
I have found Norman Walsh's -xsl stylesheets (v 1.78) and installed them.
I have also installed the tldp-xsl stylesheets (10JUL2003).

I have edited the tldp-xsl files to point to where the N Walsh stylesheets 
are.

My source file is based on 'Sample-HOWTO.xml'.


An extract of my Makefile is:
...
# Stylesheets
XSL_PRINT=$(XML_SHARE_ADH)tldp-xsl/tldp-xsl-10JUL2003/tldp-print.xsl
XSL_HTML_WHOLE=$(XML_SHARE_ADH)/tldp-xsl/tldp-xsl-10JUL2003/tldp-html.xsl
XSL_HTML_CHUNK=$(XML_SHARE_ADH)tldp-xsl/tldp-xsl-10JUL2003/tldp-html-chunk.xsl
DCL_XML=$(XML_SHARE_ADH)/openjade/openjade-1.3.2/pubtext/xml.dcl

# Generated files.
HTML_FILE=index.html
HTM_FILE=$(BASENAME).htm

# Build rules.

html: $(HTML_FILE)

htm: $(HTM_FILE)


all: html htm


# Compile rules.

$(HTM_FILE): $(XML_FILE)
    $(JADE) -t sgml -d $(XSL_HTML_CHUNK) $(DCL_XML) $(XML_FILE)

$(HTML_FILE): $(XML_FILE)
    $(JADE) -t sgml -V nochunks -d $(XSL_HTML_WHOLE) $(DCL_XML) $(XML_FILE) > 
$(HTML_FILE)

And finally, I get the following error when building and have close to no 
idea where to start.

hatfield@tuborg:~/docbook/core-how-to$ make
/home/hatfield/docbook/openjade/bin/openjade -t sgml -V nochunks -d 
/home/hatfield/docbook/tldp-xsl/tldp-xsl-10JUL2003/tldp-html.xsl 
/home/hatfield/docbook/openjade/openjade-1.3.2/pubtext/xml.dcl core-how-to.xml
> index.html
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/tldp-xsl/tldp-xsl-10JUL2003/tldp-html.xsl:2:0:E: 
prolog can't be omitted unless CONCUR NO and LINK EXPLICIT NO and either 
IMPLYDEF ELEMENT YES or IMPLYDEF DOCTYPE YES
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/tldp-xsl/tldp-xsl-10JUL2003/tldp-html.xsl:2:4:E: 
character ":" not allowed in attribute specification list
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/tldp-xsl/tldp-xsl-10JUL2003/tldp-html.xsl:18:4:E: 
character ":" not allowed in attribute specification list
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/tldp-xsl/tldp-xsl-10JUL2003/tldp-html.xsl:21:4:E: 
character ":" not allowed in attribute specification list
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/tldp-xsl/tldp-xsl-10JUL2003/tldp-html.xsl:28:5:E: 
character ":" not allowed in end tag
/home/hatfield/docbook/openjade/bin/openjade:E: specification document does 
not have the DSSSL architecture as a base architecture
hatfield@tuborg:~/docbook/core-how-to$

I'd be more than grateful for any pointers.

Thanks
Alasdair

On Mon, 2003-07-21 at 00:45, Alasdair Hatfield wrote:
> I am finding it difficult to determine a clear path to create documents 
> acceptable to tldp. I fully understand the wish to keep choices open to 
> encourage people to participate in their preferred way but this has led to 
> some confusion on my part. Probably not difficult.
> There are a whole host of how-to's and similar documents providing 
> information and advice. The problem is that as one reads more of them, one 
> comes across more and more contradictions. This is not surprising as 
> different people have found different ways of doing things. As none of the 
> documents appears definitive, it is not possible to just follow one and 
> disregard the others. I understand that this is a subject which one can not 
> just sit down and write the perfect how-to for before breakfast but for the 
> future, it might be worth looking at tidying up these documents into a 
> smaller number of more coherent guides. I know I should volunteer at this 
> point but I am so muddled in my understanding that I think I would only cause 
> further confusion. I can't even build a how-to at the moment.  :-)This brings 
> me onto some nitty-gritty I need some help with.

As a matter of fact, we are looking for reviewers who may be interested
in working on an entire subject (kind of the way they're laid out by
category at the LDP), taking a look at the HOWTOs currently in the
collection, and working with all authors into streamlining so that
coverage on subjects is more organized and coherent.  It's a big job,
and we never seem to have enough people to help with reviews, but try
and be more discerning about what's ADDED.

> With reading and help from this forum (for which thanks), I have worked out 
> that the preferred route forward to create new documents is using XML. OK.
> 
> What do I need:-
> 
> I have made a clean installation of openjade 1.3.2
> I have found Norman Walsh's -xsl stylesheets (v 1.78) and installed them.
> I have also installed the tldp-xsl stylesheets (10JUL2003).

Typically I've always seen openjade run using DSSSL (.dsl) stylesheets
rather than XSL.  For XSL you should be using xsltproc.  

But if you go the openjade route you might want to try Jim Weller's
Quickstart Guide (www.jimweller.net).  The .dsl stylesheets for LDP are
at the LDP of course.

> I have edited the tldp-xsl files to point to where the N Walsh stylesheets 
> are.
> 
> My source file is based on 'Sample-HOWTO.xml'.

> # Compile rules.
> 
> $(HTM_FILE): $(XML_FILE)
>     $(JADE) -t sgml -d $(XSL_HTML_CHUNK) $(DCL_XML) $(XML_FILE)
> 
> $(HTML_FILE): $(XML_FILE)
>     $(JADE) -t sgml -V nochunks -d $(XSL_HTML_WHOLE) $(DCL_XML) $(XML_FILE) > 
> $(HTML_FILE)

When I use openjade and the ldp.dsl on an XML file, I use the following
command (bearing in mind your own directories):

openjade -t xml -d $SGMLHOME/ldp.dsl $SGMLHOME/xml.dcl file.xml

Using xsltproc, I use this command:

No Chunks:
xsltproc -o outputfile.html --docbook $SGMLHOME/ldp-html.xsl file.xml

Chunks:
xsltproc -o directory/ --docbook $SGMLHOME/ldp-html-chunk.xsl file.xml
(you have to create the target directory before you run the above)

On my RH8 box, I have a nifty little command called xsltproc_parse,
which will tell me the errors and on which lines in my xml file, and I
can use that with XEmacs and PSGML mode to correct the mistakes and get
it right.

I only run commands to process into html, there is no "make" to what I
do, so I can't tell you what is causing your errors.  But I hope the
above information helps you in some way!

Tab

-- 
Tabatha Marshall
Web: www.merlinmonroe.com
Linux Documentation Project Review Coordinator (http://www.tldp.org)
Linux Counter Area Manager US:wa (http://counter.li.org)

Hi

Tabatha - The idea of acting as reviewer is a possible. I need to do some 
work to go through what there is and see how much work it would be first.
Thanks for the pointers to Jim Weller etc.

Meanwhile back at the coalface, I've taken yet another tack and followed the 
approach of Jim Weller.

Simple environment setup.
top 'catalog' file.

and am still using openjade to create html. Maybe I'm stupid but the less 
different tools the better at the moment.

Issuing the following instruction:

$ /home/hatfield/docbook/openjade/bin/openjade -t xml -V nochunks -d 
/home/hatfield/docbook/dsssl/docbook-dsssl-1.78/html/ldp.dsl#html 
/home/hatfield/docbook/openjade/openjade-1.3.2/pubtext/xml.dcl
jim.xml > index.html

I get the following errors.

/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/dsssl/docbook-dsssl-1.78/html/ldp.dsl:355:18:E: 
reference to undefined variable "$table-width$"
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/dsssl/docbook-dsssl-1.78/html/ldp.dsl:320:28:E: 
reference to undefined variable "$verbatim-line-by-line$"

Indeed, table-width is not defined in ldp.dsl. It is defined in dbparam.dsl. 
and similaraly with verbatim-line-by-line which is in dbverb.dsl.

And the output (index.html) is just flat unformated text.
If I put the definitions into ldp.dsl, the errors go away but the text is 
still unformated. Not a great surprise.

It looks as if further 'manglers' after ldp.dsl are not being accessed. I can 
not get openjade to tell me where it is going or what it is using.

Are there any pointers to where my configuration is wrong?
(I hope that Jim Weller is right - that configuration is the difficult part.)

Thanks
Alasdair



On Monday 21 July 2003 10:19, you wrote:
> On Mon, 2003-07-21 at 00:45, Alasdair Hatfield wrote:
> > I am finding it difficult to determine a clear path to create documents
> > acceptable to tldp. I fully understand the wish to keep choices open to
> > encourage people to participate in their preferred way but this has led
> > to some confusion on my part. Probably not difficult.
> > There are a whole host of how-to's and similar documents providing
> > information and advice. The problem is that as one reads more of them,
> > one comes across more and more contradictions. This is not surprising as
> > different people have found different ways of doing things. As none of
> > the documents appears definitive, it is not possible to just follow one
> > and disregard the others. I understand that this is a subject which one
> > can not just sit down and write the perfect how-to for before breakfast
> > but for the future, it might be worth looking at tidying up these
> > documents into a smaller number of more coherent guides. I know I should
> > volunteer at this point but I am so muddled in my understanding that I
> > think I would only cause further confusion. I can't even build a how-to
> > at the moment.  :-)This brings me onto some nitty-gritty I need some help
> > with.
>
> As a matter of fact, we are looking for reviewers who may be interested
> in working on an entire subject (kind of the way they're laid out by
> category at the LDP), taking a look at the HOWTOs currently in the
> collection, and working with all authors into streamlining so that
> coverage on subjects is more organized and coherent.  It's a big job,
> and we never seem to have enough people to help with reviews, but try
> and be more discerning about what's ADDED.
>
> > With reading and help from this forum (for which thanks), I have worked
> > out that the preferred route forward to create new documents is using
> > XML. OK.
> >
> > What do I need:-
> >
> > I have made a clean installation of openjade 1.3.2
> > I have found Norman Walsh's -xsl stylesheets (v 1.78) and installed them.
> > I have also installed the tldp-xsl stylesheets (10JUL2003).
>
> Typically I've always seen openjade run using DSSSL (.dsl) stylesheets
> rather than XSL.  For XSL you should be using xsltproc.
>
> But if you go the openjade route you might want to try Jim Weller's
> Quickstart Guide (www.jimweller.net).  The .dsl stylesheets for LDP are
> at the LDP of course.
>
> > I have edited the tldp-xsl files to point to where the N Walsh
> > stylesheets are.
> >
> > My source file is based on 'Sample-HOWTO.xml'.
> >
> > # Compile rules.
> >
> > $(HTM_FILE): $(XML_FILE)
> >     $(JADE) -t sgml -d $(XSL_HTML_CHUNK) $(DCL_XML) $(XML_FILE)
> >
> > $(HTML_FILE): $(XML_FILE)
> >     $(JADE) -t sgml -V nochunks -d $(XSL_HTML_WHOLE) $(DCL_XML)
> > $(XML_FILE) > $(HTML_FILE)
>
> When I use openjade and the ldp.dsl on an XML file, I use the following
> command (bearing in mind your own directories):
>
> openjade -t xml -d $SGMLHOME/ldp.dsl $SGMLHOME/xml.dcl file.xml
>
> Using xsltproc, I use this command:
>
> No Chunks:
> xsltproc -o outputfile.html --docbook $SGMLHOME/ldp-html.xsl file.xml
>
> Chunks:
> xsltproc -o directory/ --docbook $SGMLHOME/ldp-html-chunk.xsl file.xml
> (you have to create the target directory before you run the above)
>
> On my RH8 box, I have a nifty little command called xsltproc_parse,
> which will tell me the errors and on which lines in my xml file, and I
> can use that with XEmacs and PSGML mode to correct the mistakes and get
> it right.
>
> I only run commands to process into html, there is no "make" to what I
> do, so I can't tell you what is causing your errors.  But I hope the
> above information helps you in some way!
>
> Tab

Hello

A little more to add to the puzzle:

The LDP authors resource page also offers (in addition to the ldp.dsl 
available) a set of four .dsl files zipped as tldp-xsl-10JUL2003.tar.gz.

Following the installation instructions and trying these with both the dsssl 
release docbook-dsssl-1.78 and also with the xsl release docbook-xsl-1.61.3, 
I get the following:


$ /home/hatfield/docbook/openjade/bin/openjade -t xml -V nochunks -d 
/home/hatfield/docbook/docbook-xsl/docbook-xsl-1.61.3/html/tldp-html.xsl 
/home/hatfield/docbook/openjade/openjade-1.3.2/pubtext/xml.dcl jim.xml > 
index.html


/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/docbook-xsl/docbook-xsl-1.61.3/html/tldp-html.xsl:2:0:E: 
prolog can't be omitted unless CONCUR NO and LINK EXPLICIT NO and either 
IMPLYDEF ELEMENT YES or IMPLYDEF DOCTYPE YES
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/docbook-xsl/docbook-xsl-1.61.3/html/tldp-html.xsl:2:4:E: 
character ":" not allowed in attribute specification list
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/docbook-xsl/docbook-xsl-1.61.3/html/tldp-html.xsl:17:4:E: 
character ":" not allowed in attribute specification list
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/docbook-xsl/docbook-xsl-1.61.3/html/tldp-html.xsl:20:4:E: 
character ":" not allowed in attribute specification list
/home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/docbook-xsl/docbook-xsl-1.61.3/html/tldp-html.xsl:27:5:E: 
character ":" not allowed in end tag
/home/hatfield/docbook/openjade/bin/openjade:E: specification document does 
not have the DSSSL architecture as a base architecture


Again, which ldp xsl file(s) should be used and if it is the pack of four, 
does anyone have any pointers as to why I am suffering the above?

Many thanks again
Alasdair



On Monday 21 July 2003 14:06, you wrote:
> Hi
>
> Tabatha - The idea of acting as reviewer is a possible. I need to do some
> work to go through what there is and see how much work it would be first.
> Thanks for the pointers to Jim Weller etc.
>
> Meanwhile back at the coalface, I've taken yet another tack and followed
> the approach of Jim Weller.
>
> Simple environment setup.
> top 'catalog' file.
>
> and am still using openjade to create html. Maybe I'm stupid but the less
> different tools the better at the moment.
>
> Issuing the following instruction:
>
> $ /home/hatfield/docbook/openjade/bin/openjade -t xml -V nochunks -d
> /home/hatfield/docbook/dsssl/docbook-dsssl-1.78/html/ldp.dsl#html
> /home/hatfield/docbook/openjade/openjade-1.3.2/pubtext/xml.dcl
> jim.xml > index.html
>
> I get the following errors.
>
> /home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/dsssl/d
>ocbook-dsssl-1.78/html/ldp.dsl:355:18:E: reference to undefined variable
> "$table-width$"
> /home/hatfield/docbook/openjade/bin/openjade:/home/hatfield/docbook/dsssl/d
>ocbook-dsssl-1.78/html/ldp.dsl:320:28:E: reference to undefined variable
> "$verbatim-line-by-line$"
>
> Indeed, table-width is not defined in ldp.dsl. It is defined in
> dbparam.dsl. and similaraly with verbatim-line-by-line which is in
> dbverb.dsl.
>
> And the output (index.html) is just flat unformated text.
> If I put the definitions into ldp.dsl, the errors go away but the text is
> still unformated. Not a great surprise.
>
> It looks as if further 'manglers' after ldp.dsl are not being accessed. I
> can not get openjade to tell me where it is going or what it is using.
>
> Are there any pointers to where my configuration is wrong?
> (I hope that Jim Weller is right - that configuration is the difficult
> part.)
>
> Thanks
> Alasdair
>
> On Monday 21 July 2003 10:19, you wrote:
> > On Mon, 2003-07-21 at 00:45, Alasdair Hatfield wrote:
> > > I am finding it difficult to determine a clear path to create documents
> > > acceptable to tldp. I fully understand the wish to keep choices open to
> > > encourage people to participate in their preferred way but this has led
> > > to some confusion on my part. Probably not difficult.
> > > There are a whole host of how-to's and similar documents providing
> > > information and advice. The problem is that as one reads more of them,
> > > one comes across more and more contradictions. This is not surprising
> > > as different people have found different ways of doing things. As none
> > > of the documents appears definitive, it is not possible to just follow
> > > one and disregard the others. I understand that this is a subject which
> > > one can not just sit down and write the perfect how-to for before
> > > breakfast but for the future, it might be worth looking at tidying up
> > > these documents into a smaller number of more coherent guides. I know I
> > > should volunteer at this point but I am so muddled in my understanding
> > > that I think I would only cause further confusion. I can't even build a
> > > how-to at the moment.  :-)This brings me onto some nitty-gritty I need
> > > some help with.
> >
> > As a matter of fact, we are looking for reviewers who may be interested
> > in working on an entire subject (kind of the way they're laid out by
> > category at the LDP), taking a look at the HOWTOs currently in the
> > collection, and working with all authors into streamlining so that
> > coverage on subjects is more organized and coherent.  It's a big job,
> > and we never seem to have enough people to help with reviews, but try
> > and be more discerning about what's ADDED.
> >
> > > With reading and help from this forum (for which thanks), I have worked
> > > out that the preferred route forward to create new documents is using
> > > XML. OK.
> > >
> > > What do I need:-
> > >
> > > I have made a clean installation of openjade 1.3.2
> > > I have found Norman Walsh's -xsl stylesheets (v 1.78) and installed
> > > them. I have also installed the tldp-xsl stylesheets (10JUL2003).
> >
> > Typically I've always seen openjade run using DSSSL (.dsl) stylesheets
> > rather than XSL.  For XSL you should be using xsltproc.
> >
> > But if you go the openjade route you might want to try Jim Weller's
> > Quickstart Guide (www.jimweller.net).  The .dsl stylesheets for LDP are
> > at the LDP of course.
> >
> > > I have edited the tldp-xsl files to point to where the N Walsh
> > > stylesheets are.
> > >
> > > My source file is based on 'Sample-HOWTO.xml'.
> > >
> > > # Compile rules.
> > >
> > > $(HTM_FILE): $(XML_FILE)
> > >     $(JADE) -t sgml -d $(XSL_HTML_CHUNK) $(DCL_XML) $(XML_FILE)
> > >
> > > $(HTML_FILE): $(XML_FILE)
> > >     $(JADE) -t sgml -V nochunks -d $(XSL_HTML_WHOLE) $(DCL_XML)
> > > $(XML_FILE) > $(HTML_FILE)
> >
> > When I use openjade and the ldp.dsl on an XML file, I use the following
> > command (bearing in mind your own directories):
> >
> > openjade -t xml -d $SGMLHOME/ldp.dsl $SGMLHOME/xml.dcl file.xml
> >
> > Using xsltproc, I use this command:
> >
> > No Chunks:
> > xsltproc -o outputfile.html --docbook $SGMLHOME/ldp-html.xsl file.xml
> >
> > Chunks:
> > xsltproc -o directory/ --docbook $SGMLHOME/ldp-html-chunk.xsl file.xml
> > (you have to create the target directory before you run the above)
> >
> > On my RH8 box, I have a nifty little command called xsltproc_parse,
> > which will tell me the errors and on which lines in my xml file, and I
> > can use that with XEmacs and PSGML mode to correct the mistakes and get
> > it right.
> >
> > I only run commands to process into html, there is no "make" to what I
> > do, so I can't tell you what is causing your errors.  But I hope the
> > above information helps you in some way!
> >
> > Tab
>
> ______________________
> http://lists.tldp.org/

On Mon, 21 Jul 2003 14:46:08 +0200 Alasdair Hatfield ####@####.#### wrote:

> Hello
> 
> A little more to add to the puzzle:
> 
> The LDP authors resource page also offers (in addition to the ldp.dsl 
> available) a set of four .dsl files zipped as tldp-xsl-10JUL2003.tar.gz.
> 
> Following the installation instructions and trying these with both the
> dsssl 
> release docbook-dsssl-1.78 and also with the xsl release
> docbook-xsl-1.61.3, 
> I get the following:
> 
> 
> $ /home/hatfield/docbook/openjade/bin/openjade -t xml -V nochunks -d 
> /home/hatfield/docbook/docbook-xsl/docbook-xsl-1.61.3/html/tldp-html.xsl 
> /home/hatfield/docbook/openjade/openjade-1.3.2/pubtext/xml.dcl jim.xml > 
> index.html


The jade/openjade processing engine uses DSSSL (.dsl)
The xsltproc processing engine uses XSL (.xsl).

You need to either change your processing engine or the stylesheets.

 
cheers,
Greg

This one time, at band camp, Tabatha Marshall ####@####.#### wrote:
> As a matter of fact, we are looking for reviewers who may be interested
> in working on an entire subject (kind of the way they're laid out by
> category at the LDP), taking a look at the HOWTOs currently in the
> collection, and working with all authors into streamlining so that
> coverage on subjects is more organized and coherent.

*raises hand* Pick me, pick me! :p
But really, I am interested in making sure what's already there is 
good. And I'll have the updated threads FAQ Real Soon Now, I don't 
know how, but over my last vacation I actually forgot about it =p

> No Chunks:
> xsltproc -o outputfile.html --docbook $SGMLHOME/ldp-html.xsl file.xml
> 
> Chunks:
> xsltproc -o directory/ --docbook $SGMLHOME/ldp-html-chunk.xsl file.xml

You don't need the --docbook flag with XML, that's only for Docbook 
SGML.

Morgon
-- 
"Man is the only creature capable of hating itself" -- Governor of Japan 
in The End of Evangelion

Thanks for the help.

I've finally thrown (open)jade away and gone to xsltproc. Built and installed 
it all and reconfigured makefiles etc and now am getting, not sexy, but good 
how-to's out with indexes and TOCs etc.

If its useful, I'll scratch my head about taking a global look at the docbook 
/ ldp authoring documents.

Best regards
Alasdair


On Monday 21 July 2003 18:42, you wrote:
> This one time, at band camp, Tabatha Marshall ####@####.#### 
wrote:
> > As a matter of fact, we are looking for reviewers who may be interested
> > in working on an entire subject (kind of the way they're laid out by
> > category at the LDP), taking a look at the HOWTOs currently in the
> > collection, and working with all authors into streamlining so that
> > coverage on subjects is more organized and coherent.
>
> *raises hand* Pick me, pick me! :p
> But really, I am interested in making sure what's already there is
> good. And I'll have the updated threads FAQ Real Soon Now, I don't
> know how, but over my last vacation I actually forgot about it =p
>
> > No Chunks:
> > xsltproc -o outputfile.html --docbook $SGMLHOME/ldp-html.xsl file.xml
> >
> > Chunks:
> > xsltproc -o directory/ --docbook $SGMLHOME/ldp-html-chunk.xsl file.xml
>
> You don't need the --docbook flag with XML, that's only for Docbook
> SGML.
>
> Morgon

> I've finally thrown (open)jade away and gone to xsltproc. Built and
installed 
> it all and reconfigured makefiles etc and now am getting, not sexy,
but good 
> how-to's out with indexes and TOCs etc.

If you want sexy, you can jazz up the HTML output by using a CSS style
sheet.  Each of the HTML pages generated with the tldp-xsl
customizations should have a link to a style sheet called "style.css". 
If you create such a stylesheet and put it in the same directory as the
HTML pages you can get whatever style you want.

There is a sample "style.css" in the tldp-xsl.tar.gz package that can
make a big difference in readability in a web browser.  You can
customize it to produce something more flashy if you wish.  The w3c.org
site has some good info on CSS.

Good Luck!
Dave

On Mon, Jul 21, 2003 at 07:13:38PM +0200, Alasdair Hatfield wrote:
> If its useful, I'll scratch my head about taking a global look at the docbook 
> / ldp authoring documents.

I'm already working on editing the LDP author guide. I'll post the
revisions where when they're ready (this is a *huge* job and I'm still at
the paper editing stage).

emma

-- 
Emma Jane Hogbin
[[ 416 417 2868 ][ www.xtrinsic.com ]]