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??? 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" /usr/bin/nsgmls:<OSFD>0:1:54:E: reference to entity "BOOK" for which no system identifier could be generated /usr/bin/nsgmls:<OSFD>0:1:0: entity was defined here /usr/bin/nsgmls:<OSFD>0:1:54:E: DTD did not contain element declaration for document type name /usr/bin/nsgmls:<OSFD>0:2:5:E: element "BOOK" undefined /usr/bin/nsgmls:<OSFD>0:3:6:E: element "TITLE" undefined /usr/bin/nsgmls:<OSFD>0:4:12:E: element "TITLEABBREV" undefined /usr/bin/nsgmls:<OSFD>0:5:9:E: element "BOOKINFO" undefined /usr/bin/nsgmls:<OSFD>0:6:12:E: element "LEGALNOTICE" undefined /usr/bin/nsgmls:<OSFD>0:6:18:E: element "PARA" undefined /usr/bin/nsgmls:<OSFD>0:7:7:E: element "AUTHOR" undefined /usr/bin/nsgmls:<OSFD>0:7:18:E: element "FIRSTNAME" undefined /usr/bin/nsgmls:<OSFD>0:7:36:E: element "SURNAME" undefined /usr/bin/nsgmls:<OSFD>0:9:11:E: element "DEDICATION" undefined /usr/bin/nsgmls:<OSFD>0:10:5:E: element "PARA" undefined /usr/bin/nsgmls:<OSFD>0:14:8:E: element "PREFACE" undefined /usr/bin/nsgmls:<OSFD>0:14:15:E: element "TITLE" undefined /usr/bin/nsgmls:<OSFD>0:15:5:E: element "PARA" undefined /usr/bin/nsgmls:<OSFD>0:19:8:E: element "CHAPTER" undefined /usr/bin/nsgmls:<OSFD>0:19:15:E: element "TITLE" undefined /usr/bin/nsgmls:<OSFD>0:20:5:E: element "PARA" undefined /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
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 jade:/usr/share/sgml/docbkdsl/html/docbook.dsl:385: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:384: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:383: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:382: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:380: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:379:0: start tag was here jade:E: specification document does not have the DSSSL architecture as a
Ok I try it with jade then: base architecture An Example Book Example No notice is required. NormanWalsh This book is dedicated to you. Forword 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. $ > _ 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/nsgmls:<OSFD>0:1:0: entity was defined here /usr/bin/nsgmls:<OSFD>0:1:54:E: DTD did not contain element declaration for document type name /usr/bin/nsgmls:<OSFD>0:2:5:E: element "BOOK" undefined /usr/bin/nsgmls:<OSFD>0:3:6:E: element "TITLE" undefined /usr/bin/nsgmls:<OSFD>0:4:12:E: element "TITLEABBREV" undefined /usr/bin/nsgmls:<OSFD>0:5:9:E: element "BOOKINFO" undefined /usr/bin/nsgmls:<OSFD>0:6:12:E: element "LEGALNOTICE" undefined /usr/bin/nsgmls:<OSFD>0:6:18:E: element "PARA" undefined /usr/bin/nsgmls:<OSFD>0:7:7:E: element "AUTHOR" undefined /usr/bin/nsgmls:<OSFD>0:7:18:E: element "FIRSTNAME" undefined /usr/bin/nsgmls:<OSFD>0:7:36:E: element "SURNAME" undefined /usr/bin/nsgmls:<OSFD>0:9:11:E: element "DEDICATION" undefined /usr/bin/nsgmls:<OSFD>0:10:5:E: element "PARA" undefined /usr/bin/nsgmls:<OSFD>0:14:8:E: element "PREFACE" undefined /usr/bin/nsgmls:<OSFD>0:14:15:E: element "TITLE" undefined /usr/bin/nsgmls:<OSFD>0:15:5:E: element "PARA" undefined /usr/bin/nsgmls:<OSFD>0:19:8:E: element "CHAPTER" undefined /usr/bin/nsgmls:<OSFD>0:19:15:E: element "TITLE" undefined /usr/bin/nsgmls:<OSFD>0:20:5:E: element "PARA" undefined /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/groff/mapping': No such file or directory
So basically my simple question is: How do you _use_ docbook and sgml? =) mk _________________________________________________________________ Get your FREE download of MSN Explorer at http://explorer.msn.com