docbook: What is needed when using xml and ldp xsl files?
Subject:
Re: What is needed when using xml and ldp xsl files?
From:
Alasdair Hatfield ####@####.####
Date:
21 Jul 2003 12:44:02 -0000
Message-Id: <200307211141.h6LBfKf19062@foureyes.embedded-designs.co.uk>
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/
