Re: generating standalone html with gnome xsl stylesheets (gtkmm)

[Jonathon Jongsma <jonathon jongsma gmail com>]

Thanks, Peter.  I tried out the htmlweb stylesheet a bit but I noticed
that it took forever.  I haven't looked to try to determine what the
issue is (maybe some excessive recursion or something?).  Here are the
timings using the different stylesheets with everything else the same:

using db2html.xsl
real    0m3.079s
user    0m2.685s
sys     0m0.284s

using db2htmlweb.xsl
real    1m43.518s
user    1m39.855s
sys     0m0.974s

So clearly there's something going on there.  I like what you've done
in general, though.  There's a couple things I might change, and a
couple css issues like you mentioned, but other than that, it's a good
start.  If I get some time I'll try to tackle some of the issues I
found, but I'm pretty much an xsl novice.  Would it be helpful for you
if I provided a more detailed list of issues I've found?   (also, if
this is off-topic for gnome-doc-devel, please let me know.  I've only
just joined)

Jonathon


On 12/28/05, Peter Williams <peter newton cx> wrote:
> I actually started thinking about this same issue not too long ago. I
> wrote a few patches, but the email to the list that I sent didn't seem
> to go through. You can find what I worked up here:
>
>         http://www.newton.cx/~peter/files/db2htmlweb.diff
>
> Basically it creates a new XSL directory in
> gnome-doc-utils/xslt/docbook/htmlweb/ that replaces a few key elements
> of the db2html code. You would run xsltproc on your DocBook file with
> the xslt/docbook/htmlweb/db2htmlweb.xsl stylesheet. (Hopefully this will
> get integrated into the gnome-doc-process script I posted a little while
> ago).
>
> I hope to get these stylesheets integrated into gnome-doc-utils
> eventually, though I've had other things to do lately. But I'd like it
> if you gave these stylesheets a try and told me what you thought of
> them. There are still a few issues with them, but the CSS tweaks that
> I've made improve things a lot, I think.
>
> Peter
>
> On Wed, 2005-12-28 at 13:25 -0600, Jonathon Jongsma wrote:
> > Hello,
> >
> > I've been doing some work on improving the gtkmm tutorial recently.
> > The tutorial is in docbook format and uses the standard docbook xsl
> > stylesheets to create the online html tutorial documentation [1].
> > This works fine, but the presentation leaves something to be desired.
> >  I toyed around with customizing the output with css, but then I
> > thought that perhaps we could just make use of the GNOME XSL
> > stylesheets that are used for yelp, etc.  If we used the GNOME
> > stylesheets, we could improve the look of the tutorial and make it
> > look more similar to other GNOME help documents, and also get the
> > benefit of not duplicating effort by creating our own customizations.
> > I tried doing it several ways but was unsuccessful doing so.  Is
> > generating static html files an intended usage scenario for the GNOME
> > XSL stylesheets?  If so, could anybody give me pointers on how to go
> > about doing it?
> >
> > Thanks,
> > Jonathon
> >
> > [1] http://www.gtkmm.org/docs/gtkmm-2.4/docs/tutorial/html/index.html
> > _______________________________________________
> > gnome-doc-devel-list mailing list
> > gnome-doc-devel-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gnome-doc-devel-list
> --
> Peter Williams / peter newton cx
>
>