discuss: How to create a HOWTO on Red Hat Linux 9?
Subject:
Re: How to create a HOWTO on Red Hat Linux 9?
From:
Hal Burgiss ####@####.####
Date:
20 Oct 2003 11:28:07 -0000
Message-Id: <20031020112824.GV30708@feenix.burgiss.net>
On Sun, Oct 19, 2003 at 10:56:19AM -0600, Rodolfo J. Paiz wrote:
>
> In the interest of learning how to write Linux documentation and
> starting immediately with the format used by the LDP, I have begun
> to port a couple of small documents which I have previously handed
> out as ASCII text into SGML. (I also tried XML, but made even less
> progress so I reverted to SGML for the moment.)
>
> I have attached my SGML source so far along with the errors I
> received when running the command "linuxdoc -B html
> sourcefile.sgml".
>
> Can anyone help me diagnose this? I want to start working on a real
>
> project, but this is my test/learning case and it's... just...
> not... working...
> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
One problem: You are specifying a DocBook DTD and using linuxdoc to
build the SGML. AFAIK, the linuxdoc command only works with a linuxdoc
DTD (different). I would recommend learning DocBook though tldp will
accept either types of documents.
Command I use to build multi-page HTML:
jade -t sgml -ihtml -d /usr/lib/sgml/stylesheets/ldp.dsl\#html
That uses the TLDP stylesheet (ldp.dsl), which is available on the
tldp website somewhere, and would need to be installed manually. There
also is decent instructions in the Author's guide there somewhere.
The ldp stylesheet is not necessary, but its the same one used by
TLDP, so your test builds would look the same.
You could try the 'db2html' script also.
Your mark-up looked good AFAICS. Only one minor problem (an unclosed
para tag).
--
Hal Burgiss
