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 -- ubuntu-devel mailing list [email protected] Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-devel
