Revamping the Packaging Guide

[Daniel Holbach]

On 13.12.2010 11:06, Daniel Holbach wrote:
>  * Sphinx:
>   - PRO: ReStructured text
>   - PRO: variety of output formats (.html, single .html, pdf, epub,
>          .txt, etc.)
>   - PRO: supports gettext infrastructure
>   - CON: only supports gettext in 1.1 (trunk), we're on 1.0 in natty now
>          (Barry talked to sphinx upstream and they might be able to
>           release 1.1 before Feature Freeze.)
> 
> I had a look at sphinx and I'm quite happy with it. Not only is it used
> by lots of python projects already, but also is it very easy to write in
> ReStructured text, and the output looks great too.
> 
> I packaged current trunk of sphinx in ppa:dholbach/ppa [7] and put up a
> couple of short articles at lp:~dholbach/+junk/ubuntu-packaging-guide [8].

To clarify the point about Sphinx 1.1 above: getting Sphinx 1.1 into
Ubuntu is not a real blocker. If we don't manage to get it it in time
(and [1] fixed), we can still set up the project with a few first
articles and translate the documents later. (In fact we could generate
the .pot file locally with a sphinx snapshot from PPA and push that into
Launchpad.)

Sphinx 1.1 for Natty is only relevant in terms of having the packaging
guide package available in the archive.

[1]
http://bitbucket.org/birkenfeld/sphinx/issue/561/configuration-option-store-translations-in

Have a great day,
 Daniel