[ubuntu] shipping html

Matthew East mdke at ubuntu.com
Sat Jan 28 18:14:07 UTC 2006


Hi all,

I was quite pushy earlier in the release cycle about shipping html as
our primary format for display in yelp. A couple of things have changed
since then:

First, I played around with some translated docs and it looks like there
might be a bug in scrollkeeper (or more likely me) that means that the
translated documents don't appear as they should. This is probably
fixable if we poke around a bit.

Second, and more importantly, yelp is now 300 times faster at loading
xml. This has really taken away one of the most important reasons for
shipping html.

Also, Jeff Waugh pointed out that to be coherent with gnome docs,
shipping xml is a good idea. He also suggested that we could customise
the yelp stylesheets a bit to give them an Ubuntu look. I've been
looking into this a bit and it looks feasible.

So those things have really convinced me that in fact we should still be
shipping xml with yelp. It might be a good idea to include html in the
distribution anyway (especially for the serverguide) but I think that
yelp should still be displaying xml.

What do others think? Is it ok to remove the html entries in the Yelp
TOC?

Matt
-- 
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060128/98ec97f1/attachment.pgp>


More information about the ubuntu-doc mailing list