Date: Wed, 08 May 2002 22:57:07 +0200 From: Eivind Olsen <eivind@aminor.no> To: freebsd-questions@FreeBSD.ORG Subject: I'm having DocBook-problems - anyone who can provide me with a clue? Message-ID: <10221738.1020898627@[192.168.0.2]>
next in thread | raw e-mail | index | archive | help
Hello.
I'm having DocBook-problems - anyone who can provide me with a clue?
I've installed the textproc/docproj port on FreeBSD 4.5-STABLE (of 1 week
ago). Now, I'm trying to learn how to write DocBook SGML, but I'm having
some problems with validating documents. I'm not sure if it's a problem
with me or with the ports or both (most likely it's a problem with me. ;)
For example, I have the following "docbooktest.sgml"-file:
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>
<artheader>
<title>Article's Title</title>
<author><firstname>EmilioFirstname</firstname>
<surname>Lastname</surname></author>
</artheader>
<para>...</para>
<sect1><title>Title of Section</title>
<para>...</para>
</sect1>
<bibliography>...</bibliography>
</article>
When I try to validate it with "nsgmls -s", I get:
eivind@trisha:~/dokumenter > nsgmls -s docbooktest.sgml
nsgmls:docbooktest.sgml:1:57:W: cannot generate system identifier for
public text "-//OASIS//DTD DocBook V3.1//EN"
nsgmls:docbooktest.sgml:1:57:E: reference to entity "ARTICLE" for which no
system identifier could be generated
nsgmls:docbooktest.sgml:1:0: entity was defined here
nsgmls:docbooktest.sgml:1:57:E: DTD did not contain element declaration for
document type name
nsgmls:docbooktest.sgml:2:8:E: element "ARTICLE" undefined
nsgmls:docbooktest.sgml:3:10:E: element "ARTHEADER" undefined
nsgmls:docbooktest.sgml:4:8:E: element "TITLE" undefined
nsgmls:docbooktest.sgml:5:9:E: element "AUTHOR" undefined
nsgmls:docbooktest.sgml:5:20:E: element "FIRSTNAME" undefined
nsgmls:docbooktest.sgml:6:12:E: element "SURNAME" undefined
nsgmls:docbooktest.sgml:8:5:E: element "PARA" undefined
nsgmls:docbooktest.sgml:9:6:E: element "SECT1" undefined
nsgmls:docbooktest.sgml:9:13:E: element "TITLE" undefined
nsgmls:docbooktest.sgml:10:5:E: element "PARA" undefined
nsgmls:docbooktest.sgml:12:13:E: element "BIBLIOGRAPHY" undefined
eivind@trisha:~/dokumenter >
I have installed a few ports related to DocBook:
eivind@trisha:~/dokumenter > pkg_info | grep doc
docbook-1.2 Meta-port for the different versions of the DocBook DTD
docbook-241 V2.4.1 of the DocBook DTD, designed for technical
documenta
docbook-3.0 V3.0 of the DocBook DTD, designed for technical
documentati
docbook-3.1 V3.1 of the DocBook DTD, designed for technical
documentati
docbook-4.0 V4.0 of the DocBook DTD, designed for technical
documentati
docbook-4.1 V4.1 of the DocBook DTD, designed for technical
documentati
docbook-tdg-2.0.4 Norman Walsh's book "DocBook: The Definitive Guide"
docbook-xml-4.1.2_1 XML version of the DocBook DTD
docproj-1.9 The "meta-port" for the FreeBSD Documentation Project
dsssl-docbook-modular-1.73 DSSSL stylesheets for the DocBook DTD by Norman
Walsh
jadetex-3.12 A TeX backend for Jade, for typesetting SGML documents
linuxdoc-1.1 The Linuxdoc SGML DTD
psgml-emacs21-1.2.4_1 A major mode for editing SGML and XML documents for
emacs21
sgmlformat-1.7_2 Generates groff and HTML from linuxdoc and docbook SGML
doc
sgmltools-2.0.2 Generates various output formats from DocBook SGML
document
eivind@trisha:~/dokumenter >
(well, some of these have nothing to do with DocBook)
Can anyone suggest what I might be doing wrong? Is the test DocBook file I
have incorrect? Am I missing any ports? Any manual configuration/changes I
need to do?
To me it looks like nsgmls is not able to map the DOCTYPE with a DTD, and
from what I understand it should do so by looking at a catalog-file
(probably /usr/local/share/sgml/catalog ?). Here is the contents of my
/usr/local/share/sgml/catalog file:
eivind@trisha:/usr/local/share/sgml > cat catalog
CATALOG "/usr/local/share/sgml/jade/catalog"
CATALOG "/usr/local/share/gmat/sgml/CATALOG"
CATALOG "iso8879/catalog"
CATALOG "linuxdoc/catalog"
CATALOG "docbook/catalog"
CATALOG "html/catalog"
CATALOG "iso12083/catalog"
eivind@trisha:/usr/local/share/sgml >
--
Eivind Olsen
eivind@aminor.no
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-questions" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?10221738.1020898627>