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

Joost van Baal joostvb at logreport.org
Sun Jun 24 14:10:13 CEST 2001


On Sun, Jun 24, 2001 at 01:55:09PM +0200, Egon Willighagen wrote:
> On Saturday 23 June 2001 21:02, Egon Willighagen wrote:
> > I reformated the lr_xml2pdf manpage to DocBook and is now integrated
> > with the Manual...
> 
> 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

> 
> Most notably, i would like to see lr_run and lr_log2report
> as manpage in the manual and on the website... from within
> the manual we can link to it, and the same hold for the website...
> 
> if we place a "chunked" version of the manual on the website, we
> could more easily point to the manpage from other pages on the
> site...
> An second advantage would be that since the manual is not all in
> one html file, but 'chunked' into smaller webpages, it becomes 
> more friendly to people with low bandwith... this will become more
> important when the manual will grow in size...

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.

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