Overlays on trac

If creating Gentoo overlays and managing them with trac is a sickness then I got infected last week. PHP is doing it, web-apps is doing it, and science also joined the club. There are probably more that I don't know about.

As a web-apps herd member I have been working with the web-apps overlay and I cannot say that this made me fall in love with trac. There are definitely some features missing especially concerning bug tracking. But the integration with subversion is pretty nice.

So I wrapped my personal overlay into a trac site. I documented the setup process here and the site is accessible here.

One thing I did not like in the web-apps overlay was editing the contents page once we added or removed an ebuild. It somehow feels redundant and I am not exactly a fan of editing stuff through the web. But at this point trac provides something that makes me like it: you can plug in your own python macros.

It was pretty easy to generate a small macro that would automatically fetch information from the overlay and display it on the wiki page. You can download the macro here and store it in your wiki-macros directory of the trac site. Then add a statement like this

[[lay2wiki(/trunk/overlay)]]

to your wiki page. The argument is the path to the overlay within the repository. The result should look like this.

Most of the information is automatically retrieved from the ebuild files, but you can add an info.trac file to a package directory to provide additional information. See my trac setup page for more details.

Looks like I won't be able to avoid the trac infection.

Posted at: 17:34 | Permalink | category: /english/technical/gentoo