On Saturday 10 March 2001 17:51, Purple Shirt wrote:
A long one.
I am still struggling to get anything with docbook going. I got 7.0 and about every package from sgm1 installed.
I got an ordinary sgml document:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <book> <title>An Example Book</title> <titleabbrev>Example</titleabbrev> <bookinfo> <legalnotice><para>No notice is required.</para></legalnotice> <author><firstname>Norman<surname>Walsh</author> </bookinfo> <dedication> <para> This book is dedicated to you. </para> </dedication> <preface><title>Forword</title> <para> Some content is always required. </para> </preface> <chapter><title>Required Chapter</title> <para> At least one chapter, reference, part, or article is required in a book. </para> </chapter> <appendix><title>Optional Appendix</title> <para> Appendixes are optional. </para> </appendix> </book>
I want to check if it conforms with the Docbook DTD.
$ > nsgmls -sv -c /usr/share/sgml/CATALOG.docbk31 test.sgm nsgmls:I: SP version "1.3.4" nsgmls:/usr/share/sgml/CATALOG.docbk31:24:0:W: DTDDECL catalog entries are not supported
Why does it give this warning???
MK, That comes from JADE. It's just one of thoes facts of life we have to live with unless we want to fix JADE. Watch the KDE compile sometime and see know many times that message occurs.
I then want to turn this sgml doc into other stuff like html and txt and pdf and ps.
For html I do:
sgml2html test.sgm
Processing file test.sgm /usr/bin/nsgmls:<OSFD>0:1:54:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V3.1//EN"
[snip]
/usr/bin/nsgmls:<OSFD>0:24:9:E: element "APPENDIX" undefined /usr/bin/nsgmls:<OSFD>0:24:16:E: element "TITLE" undefined /usr/bin/nsgmls:<OSFD>0:25:5:E: element "PARA" undefined /usr/bin/sgmlsasp: can't open `/usr/lib/sgml-tools/dist/book/html/mapping': No such file or directory
Ok I try it with jade then:
jade -t sgml -d /usr/share/sgml/docbkdsl/html/docbook.dsl test.sgm
<big cut>PECIFICATION" omitted, but OMITTAG NO was specified jade:/usr/share/sgml/docbkdsl/html/docbook.dsl:387:0: start tag was here jade:/usr/share/sgml/docbkdsl/html/docbook.dsl:403:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but OMITTAG NO was specified jade:/usr/share/sgml/docbkdsl/html/docbook.dsl:386:0: start tag was here jade:/usr/share/sgml/docbkdsl/html/docbook.dsl:403:13:E: end tag for "EXTERNAL-SPECIFICATION" omitted, but OMITTAG NO was specified [snip] Some content is always required. Required Chapter At least one chapter, reference, part, or article is required in a book. Optional Appendix Appendixes are optional. $ > _
The way SGML and XML handle DTDs and Libraries is rather difficult to get a handle on. I don't remember the details, or where all the answers lie, but I suggest reading the documentation on JADE. The DocBook book from O'Reilly does have some discussion of this.
Seems I am out of luck.
Ok I read something that docbook and html is not working right but only linuxdoc and html conversion. damn. for a document standard this docbook thing has no useful documentation on itself.
I try normal text conversion then.
Same stupid thing:
sgml2txt test.sgm
Processing file test.sgm /usr/bin/nsgmls:<OSFD>0:1:54:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V3.1//EN" /usr/bin/nsgmls:<OSFD>0:1:54:E: reference to entity "BOOK" for which no system identifier could be generated
/usr/bin/sgmlsasp: can't open `/usr/lib/sgml-tools/dist/book/groff/mapping': No such file or directory
So basically my simple question is:
How do you _use_ docbook and sgml? =)
mk
You need to understand how the DOCTYPE stuff references Catalogs and DTDs. I I come up with better info I'll post it. You either have to install the DTDs and catalogs, modify your headers to explicitly point to them, or modify some environment infor to help your porgrams find them. Steve