docbook: What is needed when using xml and ldp xsl files?
Subject:
What is needed when using xml and ldp xsl files?
From:
Alasdair Hatfield ####@####.####
Date:
21 Jul 2003 07:43:35 -0000
Message-Id: <200307210640.h6L6eif18391@foureyes.embedded-designs.co.uk>
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
