Re: Location of SGML versions of www.gnome.org/learn/ ?

[Alexander Kirillov <kirillov math sunysb edu>]

make and autogen.sh do not produce html or pdf version - they are not
supposed to: as I mentioned, it is the docbook source that is installed
on users machine. Conversion docbook->html happens when you select
"help" in an application's menu. 

If you want to create html/pdf versions of the docs, html version is
easiest created using xsltproc (this is how yelp does it); this should
be discussed in the latest GDP handbook. John or Eric can provide a
link. If you just want to see the result in yelp,  run
yelp ghelp:/path/to/docbookxmlfile
(yelp will automatically call xsltproc with appropriate stylesheets)

As for PDF conversion, I must admit that in the past I had problems with
it myself. Someone else can share his positive experience?


You could also take a look at Tim Waugh's web page (he is the one
responsible for pacakging/configuring etc docbook-related pacakges in
Red Hat):
http://cyberelk.net/tim/docbook/index.html

God luck!

Sasha



On Sat, 2003-05-03 at 11:51, Simos Xenitellis wrote:
> > Message: 2
> > Subject: Re: Location of SGML versions of www.gnome.org/learn/ ?
> > From: Alexander Kirillov <kirillov math sunysb edu>
> > To: GNOME Doc List <gnome-doc-list gnome org>
> > Organization: 
> > Date: 01 May 2003 17:17:54 -0400
> > 
> > They are available in DocBook 4.1.2 XML form, in CVS module
> > gnome-user-docs. In fact, the same docs - in DocBook XML form - are also
> > in the gnome-user-docs package for GNOME 2.2.1 (HTML is generated on the
> > fly from docbook source).
> 
> Thanks for the e-mail.
> 
> I tried the {./autogen.sh, make} series of commands but there was no
> generation of DVI/PS/PDF documents, nor HTML files.
> 
> I suppose that 
> 	% docbook2dvi glossary.sgml
> is used to create, for example, DVI versions.
> 
> With the version of the tools found in at least RH8.0, several warnings
> occur and the script (docbook2dvi) does not complete.
> Thus, one would need to run subsequently,
> 	% jadetex glossary.tex
> 	% dvi2ps -o glossary.ps glossary.dvi
> 
> Any pointers as to how to solve this situation?
> 
> simos
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list