Proposal to use meinproc for Kubuntu

Matthew East mdke at ubuntu.com
Wed Nov 23 18:00:22 UTC 2005


On Wed, 2005-11-23 at 11:52 +0000, Matthew East wrote:

> We were already using the built-in KDE stylesheets from kdelibs-data (I
> copied them into our tree to avoid the necessity for users to install
> that package).

I should start by saying I'm no expert on this stuff, however I am
currently of the idea that we can think about using xsltproc for all
Kubuntu docs, even the offline ones, by supplying the kde-default.css
with the package and unifying the stylesheets we use. I don't think
Riddell agrees with me on this, but it is something that we can discuss
gradually. I certainly thing that it has these advantages:

* no separate build system for online/offline documents in Kubuntu
* support for xinclude (which in turn has advantages of being able to
pick and choose which files to translate and which do not need
translating, and that we can include the licences easily)
* same build system for Ubuntu and Kubuntu docs, same xsl stylesheets,
different css.
* no kde-specific libraries required to build the documents, only
docbook-xsl.

The disadvantages, AFAICS, would be:

* Meinproc makes compressed copies of the html documents, which thus
save space in packaging (query whether xsltproc can do this?)
* Riddell mentioned that there was an aesthetic problem with the html
documents we shipped in Breezy created with xsltproc, I'll install
Kubuntu and take a look at this hopefully this weekend.

We can talk about this, do some reading, and see if we can iron out what
is the best way. Obviously, we need to focus on actually getting the
docs written, and we have enough time to sort this build business out.

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/20051123/bed16880/attachment.pgp>


More information about the ubuntu-doc mailing list