Questions Regarding doc.ubuntu.com (Re: Announcing Kubuntu Desktop Guide preview)

Matthew East mdke at ubuntu.com
Tue Mar 7 12:17:00 UTC 2006


On Tue, 2006-03-07 at 09:10 +0000, Matthew East wrote:
> On Mon, 2006-03-06 at 18:14 -0500, Venkat Raghavan wrote:
> > ><snip>
> > > I just had a quick read over the Kubuntu Desktop Guide and I noticed a
> > > couple of typos (most likely my fault) in the Common Tasks -> Games
> > > section, notice the two "the":
> > >
> > > Ensure you have hardware accelerated 3D drivers installed for your video
> > > card. For more information see *the the* section called “Hardware”.
> > 
> > I have fixed this in the commit 2520. 
> > 
> > Also i had question about doc.ubuntu.com. Does it have a directory 
> > "/usr/share/doc/kde/HTML/en/common" installed by the kdelibs-data package so 
> > that we can build better looking web-documents. 
> 
> Yes it does.
> 
> > Compare: 
> > http://doc.ubuntu.com/kubuntu/desktopguide-web/C/index.html to 
> > http://www.robotgeek.org/kubuntu/desktopguide/index.html
> 
> There are some issues with the second one, but it is definitely better
> than the current thing. I think our aim should be to have documents
> which are identical to how they appear in khelpcenter. Whether this can
> be done or not in xsltproc has been a tricky issue: if it can, then we
> can build all kde documents with xsltproc, use xincludes, and generally
> eat our cake and have it at the same time.

Right, I've managed to produce some nice shiny kde docs using xsltproc.
I haven't uploaded it yet because I'm ironing out some minor issues and
sorting everything out before I do so. But, see here:
http://doc.ubuntu.com/test/kde.png

We can now:
 * Build prettier versions of the kubuntu server guide and kubuntu
packaging guide for the distribution
 * Build prettier versions of everything on the website
 * Make a similar blingy top bar for Ubuntu documentation

We _could_ also move to xsltproc for the kubuntu specific documentation.
I'd strongly suggest that we do this. This will enable us to use
xincludes, and make translating much happier. It will also ensure that
the same toolset is used for the kubuntu-specific and generic
(server/packaging guides) documents.

As far as I was aware, the objection to using xsltproc was that we
couldn't create the nice kde look. Now that this is done, Jonathan: are
there any other barriers to using xsltproc to generate the kubuntu
documentation?

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/20060307/f8c56e25/attachment.pgp>


More information about the ubuntu-doc mailing list