htmlhelp generation

Andreas Pflug <pgadmin@pse-consulting.de> writes:

The attached Makefile patch together with stylesheet-hh.xsl allows "make
htmlhelp". stylesheet-hh.xsl is derived from stylesheet.xsl, after some
advise from PeterE.

Um ... what's an htmlhelp?

regards, tom lane

Am Montag, 22. November 2004 22:23 schrieb Tom Lane:

Um ... what's an htmlhelp?

It's the kind of format the Windows'ish programs use for their internal help
browsers. It consists of regular HTML plus some index files. pgAdmin needs
it, and maybe the Windows binary package would like it as well.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

Am Montag, 22. November 2004 18:34 schrieb Andreas Pflug:

The attached Makefile patch together with stylesheet-hh.xsl allows "make
htmlhelp". stylesheet-hh.xsl is derived from stylesheet.xsl, after some
advise from PeterE.

Installed.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

Peter Eisentraut <peter_e@gmx.net> writes:

Am Montag, 22. November 2004 18:34 schrieb Andreas Pflug:

The attached Makefile patch together with stylesheet-hh.xsl allows "make
htmlhelp". stylesheet-hh.xsl is derived from stylesheet.xsl, after some
advise from PeterE.

Installed.

It would be nice if "make clean" would get rid of what this produces.

regards, tom lane

The attached Makefile patch together with stylesheet-hh.xsl

allows "make

htmlhelp". stylesheet-hh.xsl is derived from stylesheet.xsl,

after some

advise from PeterE.

Installed.

From what I can tell, this XSL will download and import another XSL from
docbook.sourceforge.net every time you run "make" on it. Perhaps a copy
of this file should be included in cvs to make sure we can still build
when sourceforge is down?

//Magnus

Magnus Hagander wrote:

From what I can tell, this XSL will download and import another XSL from

docbook.sourceforge.net every time you run "make" on it. Perhaps a copy
of this file should be included in cvs to make sure we can still build
when sourceforge is down?

Using xsl:import here is not a good idea even if sourceforge isn't down
- the imported file could change without our knowing, and thus the
principle of least surprise would be violated, ISTM.

cheers

andrew

Magnus Hagander wrote:

From what I can tell, this XSL will download and import another XSL
from docbook.sourceforge.net every time you run "make" on it.

Normally, you or your operating system should set up an XML catalog
that maps that URI to a local copy. For example, my system has

/etc/xml/catalog:
...
<delegateSystem systemIdStartString="http://docbook.sourceforge.net/release/xsl/&quot; catalog="file:///etc/xml/docbook-xsl.xml"/>

and

/etc/xml/docbook-xsl.xml:
...
<delegateSystem systemIdStartString="http://docbook.sourceforge.net/release/xsl/&quot; catalog="file:///usr/share/xml/docbook/stylesheet/nwalsh/catalog.xml"/>

This is no different from the public identifier mapping in the SGML
world, only that in the XML case it is possible, as a fallback, to
fetch the data over the net. Whether you actually do that is between
you and your XSLT processor.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

From what I can tell, this XSL will download and import another XSL
from docbook.sourceforge.net every time you run "make" on it.

Normally, you or your operating system should set up an XML catalog
that maps that URI to a local copy. For example, my system has

/etc/xml/catalog:
...

Hmm. Never seen that in any of the XSL systems I've used. There is
certainly no such system in the XSLT processors that are included in
Windows these days. But since those aren't used to build the docs,
that's not a good reference point I guess. If there is a standard way to
do it, there is less need to include anything in our cvs. IIRC, we don't
include the docbook stylesheets either, right?

Which brings up a different point - has anybody managed to set up a
system to build the docs *on win32*?

//Magnus

Magnus Hagander wrote:

Hmm. Never seen that in any of the XSL systems I've used. There is
certainly no such system in the XSLT processors that are included in
Windows these days.

I don't know what's "included" in Windows, but all the usual ones you
can download from the net support XML catalogs.

Which brings up a different point - has anybody managed to set up a
system to build the docs *on win32*?

Cygwin includes openjade, and xsltproc runs natively, so there shouldn't
be much of a problem.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

Um ... what's an htmlhelp?

It's the kind of format the Windows'ish programs use for their internal help
browsers. It consists of regular HTML plus some index files. pgAdmin needs
it, and maybe the Windows binary package would like it as well.

I've trivially generated them from docbook xml using the htmlhelp.xsl
stylesheet that comes with docbook and the free html help compiler from MS.

Chris