[dokuwiki] Packaging Angua for Debian

Happy new year all!

A bit late, I have started packaging the Angua release candidate for
Debian. I am almost done so I should be able to send this new package to
Debian experimental [1].

    [1] http://wiki.debian.org/DebianExperimental

As you may know, the Debian Policy requires that common libraries are
shared using common packages rather than included, for several reasons,
the most important being that it is easier to correct security flaws in
a single library package than in many packages embedding it, for
instance in bug #504682 [2]. This affects my dokuwiki package since
DokuWiki originally uses GeSHI, SimplePie and, starting with Angua,
jQuery. Following the Policy, I maintain some Debian-specific patches
[3] that modify DokuWiki so that it uses packaged versions of these
libraries instead of the embedded ones.

    [2] http://bugs.debian.org/504682
    [3] http://patch-tracker.debian.org/package/dokuwiki/0.0.20110525a-2
        (experimental version corresponding to Angua soon to come)

That has worked rather well so far, although it caused one annoying bug
[4] with an API incompatibility between an outdated version of SimplePie
used in DokuWiki and the up-to-date one in Debian.

    [4] http://bugs.debian.org/603390


Just to be sure that I am not missing anything that would cause some
integration bugs, I would like to detail what I did to “detach” jQuery.
I found that jQuery was referred to in:
* lib/exe/js.php:43-45: from the filesystem;
* lib/exe/css.php:66: both from the filesystem and from the Web.
Am I forgetting something?

The second reference, in lib/exe/css.php, is trickier, because for some
reason the equivalent of jquery/jquery-ui-theme/smoothness.css in Debian
is called jquery-ui/themes/smoothness/jquery.ui.all.css, and it uses CSS
@includes instead of a huge concatenation. For what I have seen,
replacing the file path and name works fine, correct?

So, I am replacing the filesystem paths by the ones where the
corresponding Debian packages install their files, and the Web paths by
the one where the JavaScript libraries are exposed [5]. I did not have
time to test it very well but it seems to work. Do you know what I
should test to be sure?

    [5] http://tanguy.ortolo.eu/tmp/dokuwiki/use_packaged_jquery.diff

There is one more thing I have to report: while DokuWiki originally uses
jQuery 1.6.4, in Debian we have the version 1.7.1. On the contrary,
DokuWiki uses jQuery UI 1.8.16 while we have the version 1.8.16. There
seems to be a difference between the headers of our jQuery Cookie, but
no difference in their code. I hope that there will not be
incompatibilities, but as a general rule I would recommend that DokuWiki
would stick to the last available version of jQuery as far as possible,
since this is what Debian does too. :-)


Sorry for the long text, and good luck with that release!

-- 
 ,--.
: /` )   Tanguy Ortolo <xmpp:tanguy@xxxxxxxxx> <irc://irc.oftc.net/Elessar>
| `-'    Debian Developer
 \_

-- 
DokuWiki mailing list - more info at
http://www.dokuwiki.org/mailinglist

Other related posts: