Re: Help: gnome-doc-tools
[debian-sgml people: I'm the maintainer for balsa, which has its docs
in gdp-both.dsl format, so I'm asking how to package the DSL
stylesheet and friends]
On Tue, Mar 06, 2001 at 03:38:34PM -0500, Mark Johnson wrote:
> Hi Jules,
>
> I'm package some debian docbook xml stuff, and just read the thread on
> the gnome-doc-tools list re the packaging of the gdp-tools for
> debian. I made a package of the gdp-tools a long time ago and faced
> the same questions, so I think I can answer yours.
>
> > 2) Eliot's packages install the .dsl in
> > /usr/lib/sgml/stylesheet/gnome-doc-tools, but the balsa build system
> > is looking for them in .../stylesheet/docbook-gnome. I made a symlink
> > to fix it. Is that sensible? Shall I put the symlink in the
> > gnome-doc-tools package?
>
> Eliot's package is broken.
>
> Don't make a symlink, just fix the paths at the top of gdp-both.dsl so
> they point to the debian location for the docbook dsssl stylesheet
> installation. The correct paths are:
>
> /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl
>
> /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl
Ah. Here you have misunderstood me.
The top of gdp-both.dsl is OK, in fact:
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY % html "IGNORE">
<![%html;[
<!ENTITY % print "IGNORE">
<!ENTITY docbook.dsl SYSTEM "/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl" CDA
TA dsssl>
]]>
<!ENTITY % print "INCLUDE">
<![%print;[
<!ENTITY docbook.dsl SYSTEM "/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl" CD
ATA dsssl>
]]>
]>
At least, I assume that's what you meant.
The question is more how should sgml documents which /use/
gdp-both.dsl refer to it. I discovered (after I sent that email) that
balsa uses
GDP_STYLESHEET = \
stylesheet/dsssl/docbook-gnome/gdp-both.dsl
in its Makefile, and calls db2html as follows:
-db2html -d $(GDP_STYLESHEET) $< || db2html $<
So, the question is really:
What is the correct identifier for gdp-both.dsl? Is it
stylesheet/dsssl/docbook-gnome/gdp-both.dsl
or
stylesheet/dsssl/gnome-doc-tools/gdp-both.dls
?
>
> Play it safe for now and put everything in /usr/lib/sgml.
Roger.
>
> > 3) The packages provide their own db2html called gnome-db2html. It
> > doesn't seem to make any difference (although I didn't check too
> > carefully) whether or not I use the db2html on my system (which comes
> > from cygnus-stylesheetts 0.10.2-3) or the gnome-db2html one. At the
> > moment I'm using the former, since that's what the upstream balsa
> > makefile does.
>
> It doesn't really matter, but if you use db2html you'll need to
> specify gdp-both.dsl with the -d option. It's aso easy to modify the
> scripts--see below.
I plan to upload this gnome-doc-tools to unstable, though. Which do
you think makes sense? Should it even provide its own db2html? Here
is the current contents of the .deb, with the really boring bits
snipped:
./usr/lib/sgml/dtd/gnome-doc-tools/catalog
./usr/lib/sgml/dtd/gnome-doc-tools/png-support-3.0.dtd
./usr/lib/sgml/dtd/gnome-doc-tools/png-support-3.1.dtd
./usr/lib/sgml/stylesheet/dsssl/gnome-doc-tools/gdp-both.dsl
./usr/bin/dbnochunks
./usr/bin/gnome-db2html
>
>
> > > cygnus-stylesheets/db2html by default uses the default DocBook DTD and
> > > cygnus' stylesheets while gnome-doc-tools/db2html uses the GNOME PNG
> > > DocBook DTD and Gnome's own stylesheets.
> >
> > Right. But most documents explicitly specify the DTD, so it doesn't
> > matter for most documents?
> >
> > Certainly I managed to use the cygnus db2html on the balsa docs, which
> > do use PNGs, so I assume it's all working out somehow...
> >
>
> Maybe. You should either include the gnome png-support dtds in your
> package, or put them in another package and have the gdp-both package
> depends on the dtd package. (I believe the dtds are at Dave's page,
> too.)
Yes. Those dtds are included, as you can see from my list above.
> > Oh well, I'll just upload packages which seem to work, and I'm sure
> > I'll get bug reports from people who understand sgml better than me if
> > they're wrong.
>
> Why do it that way? You can get help from debian packagers before you
> upload it...
Well, only because no useful help seemed to be forthcoming. I did
post a request for help to -devel and -gtk-gnome not long ago...
>
> The debian-sgml list is probably a better place to post questions
> about packaging docbook stuff. Please post any follow-ups to the
> list. We can help you get it right.
Duly cc:Ed.
>
> > Does gnome-doc-tools want to depend on cygnus-stylesheets?
>
> I think it only uses the css stylesheet.
css? As in cascading stylesheets?
It needs access to docbook.dsl, doesn't it? So that presumably means
it should depend on cygnus-stylesheets?
>
> > Does it need any of the other stuff there?
> Don't think so.
>
> Take a look at the gdp-tools package I made, it should help you figure
> out how to do it. I put in scripts and the dtds - but it's sort of
> kludgey. (And there's no source package for it.) You can grab it here:
>
> http://people.debian.org/~mrj/jules/
>
Hmm.
I have a feeling the way forward is not a profileration of
xyz2abc
programs, where xyz is one of the (growing number) of docbook
dialects, and abc is on of many output formats.
Surely one program ought to be able to do all that?
Jules
Reply to: