discuss: Author Guide - Writing a New HOWTO in DocBook
Subject:
Re: Author Guide - Writing a New HOWTO in DocBook
From:
Mark Komarinski ####@####.####
Date:
14 Mar 2001 21:40:30 -0000
Message-Id: <3AAFE541.8080803@valinux.com>
Welcome from Mozilla 0.8. A kind soul was nice enough to tell me where
to get Debian-compliant packages, so now I can have Mozilla and Nautilus.
Anyway, I have a very small HOWTO I converted to XML which might be more your
speed, I can send it if you like. I had to put the pointer to the DTD in there,
and Mozilla loaded it up quickly, only there was no formatting, like it ignored
the tags and just went along and spit out the content in plain
text mode. My guess is we're starting to get into things like XSL.
Also, looks like you might be right about the DB:TDG reference. This
is on page 20? This is going to cause a headache, since the times I write
a lot is when I'm off the network (in a plane). Validating that is going
to be a pain.
-Mark
Patrick K. O'Brien wrote:
> We're getting close to a solution, I think. First of all, I'm running
> Progeny Debian (gotta love Debian) so I have installed everything from
> packages. So my catalog file is fine. The real problem is a difference
> between SGML and XML. To quote from DB:TDG "External declarations in XML
> must include a system identifier." When I didn't have one Emacs and IE
> complained. (The XML version of the LAG is missing one, btw. So it really
> isn't compliant.)
>
> Pointing to a dtd file on the Internet is the example given in DB:TDG. So I
> tried that. I took the LAG xml file and changed the prologue to:
>
> <?xml version='1.0' encoding='ISO-8859-1'?>
> <!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.1.2//EN'
> 'http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd' [
>
> Then I tried to open the file in IE. It was dog slow so I killed it after a
> few minutes. I just tried again and it was pretty quick. Quick to come up
> with an error, that is:
>
> Error while parsing entity 'example-article'. An Invalid character was found
> in text content. Line 21, Position 30
> <revremark>Vers?inicial.</revremark>
>
> So I edited out the accented "a" character that IE didn't like and tried to
> load the LAG again. And again. And again. This is definitely not a fast way
> to read a big XML document. So then I created a "miniaturized" version of
> the LAG by deleting out all the entity references that sucked in the
> supporting xml files, like &conventions; and &glossary; and &cvs; but it is
> still dog slow. So I'm giving up. It may work in theory, but I agree with
> you - pointing to a critical file on the internet, especially one as big as
> docbookx.dtd, is not a good idea.
>
> ---
> Patrick K. O'Brien
> Orbtech (http://www.orbtech.com)
> "I am, therefore I think."
>
> -----Original Message-----
> From: mkomarinski [mailto:mkomarinski]On Behalf Of Mark Komarinski
> Sent: Wednesday, March 14, 2001 2:17 PM
> To: ####@####.####
> Cc: LDP-Discuss
> Subject: Re: Author Guide - Writing a New HOWTO in DocBook
>
> Heyyy....I bet your /etc/sgml/catalog doesn't point to the XML docbook.dtd,
> which is why you are having problems. I do things via packages and let them
> sort it out (yay Debian), but you may want to see if there's an RPM
> or whatever for your distro that has the XML DTD in it and edits the
> /etc/sgml/catalog file.
>
> The solution for IE should be one of two things:
> 1) IE has its own catalog that needs to know about the XML docbook.dtd
> 2) URL for the DTD in the LAG
>
> I don't like #2. I really have this thing against needing to use
> the network to get a critical file.
>
> -Mark
>
>
> _________________________
> http://list.linuxdoc.org/
--
Mark Komarinski - Senior Systems Engineer - VA Linux Systems
(cell) 978-697-2228
(email) ####@####.####
"Have one day pleasant" - Babelfish
