LinuxSA Mailing list archives

  From: Alan Kennington <ak.linuxsa@topology.org>
  To  : Peter Gossner <gossner@arcom.com.au>
  Date: Fri, 3 Jan 2003 20:53:23 +1030

Re: docbook "hello world" for SuSE linux

On Fri, Jan 03, 2003 at 08:33:11PM +1030, Peter Gossner wrote:
> On Fri, 3 Jan 2003 18:03:37 +1030
> Alan Kennington <ak.linuxsa@topology.org> scribed:
> 
> > On Fri, Jan 03, 2003 at 07:28:01AM +1030, David Lloyd
> > wrote:> 
> > > Alan,
> > > 
> > > > Obviously not..... Unless someone can tell me
> > > > different.
> > > 
> > > Unless your SuSE is super ancient you should be able to
> > > do:
> 
> Alan David is dead right.
> Your install must be broken.
> (also 3.1 is ancient now)
> Though it should still work ..


Peter,

In the meantime, Brian Marr told me off-list about a program
called db2html.
Believe it or not, this is exactly what I should have been using:

	db2html hello.sgml

This works exactly as I wanted (with version 3.1). 
It even sticks all the HTML output
in a neat subdirectory with the following contents:

total 16
-rw-------    1 akenning users          20 2003-01-03 18:06 HTML.manifest
-rw-------    1 akenning users        1306 2003-01-03 18:06 book1.html
-rw-------    1 akenning users        1683 2003-01-03 18:06 c10.html
-rw-------    1 akenning users         273 2003-01-03 18:06 docbook.css
drwx------    2 akenning users         384 2003-01-03 18:06 stylesheet-images 

But "man db2html" reveals nothing.
It just didn't show up in "man -k docbook".

In retrospect, I can see that the official DocBook documentation
(from O'Reilly), at least the version which is free on the net,
must be quite a bit out of date, whereas the docbook2html script 
expects a more uptodate SGML source.

Anyway, the difficult thing is getting started.
The rest should be a doddle by comparison.

The really frustrating thing was the knowledge that DocBook has been
used for some 10 years by thousands of people in the mainstream.
So I sort of expected it to be nicely set up in the most recent
SuSE linux distribution.
(By the way, I could write a hundred lines about what's seriously
wrong with SuSE 8.1. But I shall restrain myself.)

Cheers,
Alan Kennington.

-- 
LinuxSA WWW: http://www.linuxsa.org.au/ IRC: #linuxsa on irc.openprojects.net
To unsubscribe from the LinuxSA list:
  mail linuxsa-request@linuxsa.org.au with "unsubscribe" as the subject