Date: Thu, 2 Nov 2000 10:48:29 +0000 From: Nik Clayton <nik@freebsd.org> To: Michael Lucas <mwlucas@blackhelicopters.org> Cc: doc@freebsd.org Subject: Re: something wrong with my setup? Message-ID: <20001102104829.A1811@canyon.nothing-going-on.org> In-Reply-To: <20001031204024.A11647@blackhelicopters.org>; from mwlucas@blackhelicopters.org on Tue, Oct 31, 2000 at 08:40:24PM -0500 References: <20001031204024.A11647@blackhelicopters.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Oct 31, 2000 at 08:40:24PM -0500, Michael Lucas wrote:
> I'm trying to build a sgml book in DocBook, copying most of the format
> from faq/books.sgml.
>
> When I try to check my work, however, I get:
>
> turtledawn~/docs/FreeBSD;nsgmls -s troubleshoot.sgml
> nsgmls:/usr/local/share/sgml/docbook/4.1/catalog:22:0:W: DTDDECL catalog entries are not supported
OK, covered that. Mistakenly, I thought that was all. I should have read on.
> nsgmls:troubleshoot.sgml:1:73:W: cannot generate system identifier for public text "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN"
OK, this is a bit more interesting.
Your document is currently saying that it should be using the FreeBSD
DocBook DTD. This is an extension to DocBook, more details are at
http://www.freebsd.org/tutorials/docproj-primer/x1260.html#AEN1276
You can either continue to use the FreeBSD DTD (in which case you will need
to make sure that you've got it from the CVS repo, and then you will need
a copy of doc/share/sgml/catalog pointing to it, and listed in
SGML_CATALOG_FILES, or you can use one of the actual DocBook DTDs, in which
case you will need to change the FPI for your document, see
http://www.freebsd.org/tutorials/docproj-primer/sgml-primer-doctype-declaration.html
for more info.
> nsgmls:troubleshoot.sgml:2:77:W: cannot generate system identifier for public text "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"
OK. Now you're using more bits and pieces from the FreeBSD doc infrastructure.
I haven't written easy to use documentation yet for how to use them outside
of the FreeBSD doc/ tree.
Basically, you can either:
1. Not use them at all. This will make your documents more portable to
other systems, by reducing the amount of additional files that your
document(s) need to reference, but you lose some of our rather cool
functionality.
2. Use it as is. In which case (if you're writing articles) I recommend
doing
% cvs checkout doc/en_US.ISO_8859-1/articles
% cvs checkout doc/en_US.ISO_8859-1/share
% cvs checkout doc/share
which will checkout enough of the infrastructure that you can then do
% cd doc/en_US.ISO_8859-1/articles
and then make yourself a directory under there (copy one of the other
articles as necessary) and edit away, then use the make(1) toolchain
to handle converting the documents to different formats.
s/articles/books/ as necessary.
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20001102104829.A1811>