DocBook manual pages (And: chunking of website's version of manual)

Joost van Baal joostvb at logreport.org
Sun Jun 24 14:31:09 CEST 2001


On Sun, Jun 24, 2001 at 02:19:39PM +0200, Egon Willighagen wrote:
> On Sunday 24 June 2001 14:10, Joost van Baal wrote:
> > On Sun, Jun 24, 2001 at 01:55:09PM +0200, Egon Willighagen wrote:
> > >
> > > Joost wondered about if i wanted to convert all to dbx...
> > > My answer: only the ones we want to have on the webpage...
> >
> > We don't need to:
> >
> > http://mdcc.cx/cgi-bin/dwww?type=man&location=/usr/share/man/man1/lr_run.1.
> >gz
> 
> Ok, but those are not in a user/web browser friendly HTML format...

Did you try it?  It reads:

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
            "http://www.w3.org/TR/html40/loose.dtd">
 <html>
 <head>
        <title>/usr/share/man/man1/lr_run.1.gz</title>
 </head>
 <body text="#00000" bgcolor="#FFFFFF" link="#0000CC" alink="#FF0000" vlink="#0000FF">
<snip>

<snip>
> >
> > Yes, we could e.g. make one html file per section of the Lire
> > User Manual.  We'll have to tweak
> >
> > XML2HTMLRULE = $(PATHTOJADE) -t sgml -d $(top_srcdir)/doc/html.dsl
> > $(PATHTOXMLDCL) $< > $@
> >
> > in include/rules.mk for this, I believe.
> 
> We need an unchunked version to generate the TXT version...
> I would therefore prefer is second rule specific for generation the
> website version...

Aha, ok, I see.

> 
> It would make use of a new /doc/chunckedhtml.dsl stylesheet...

I don't think we need to write our own stylesheet.  There are a
lot of tools which generate html, splitted in a chunk per section.
(Allthough I don't know of any by heart.)

Bye,

Joost


-- 
To UNSUBSCRIBE, email to development-request at logreport.org with a subject of
"unsubscribe". Trouble? Send an email with subject "help" to
development-request at logreport.org



More information about the Development mailing list