← Back to team overview

ubuntu-packaging-guide-team team mailing list archive

[Bug 943154] Re: Make Packaging Guide translatable

 

I've got the basics working, but it's not really ready to land yet.

One thing that I'm not sure how to handle is that in order to build the
translated files you seem to need to have the sphinx.mo files for the
languages you want. As sphinx is in main, we strip out the .mo files and
put them in language-pack-* packages instead. Build-depending on the
needed language-packs doesn't really seem right.

We're going to need to figure out the workflow after this lands. As this
project is all documentation, we're going to be breaking the
translations on nearly every commit.  Also, as we'll want the .pot file
in version control so it's available to Rosetta, "make gettext" will
probably have to be run before every push to trunk to keep it up to
date. I wonder if there is some way we can automate that. I don't think
bzr has per-branch pre-commit hooks though.

Also, how is this deployed to the website? This is going to change the
installed location slightly, so landing it will probably need to be
coordinated so as to not break the website.

-- 
You received this bug notification because you are a member of Ubuntu
Packaging Guide Team, which is subscribed to Ubuntu Packaging Guide.
https://bugs.launchpad.net/bugs/943154

Title:
  Make Packaging Guide translatable

Status in Ubuntu Packaging Guide:
  In Progress

Bug description:
  With https://bitbucket.org/birkenfeld/sphinx/issue/561/configuration-
  option-store-translations-in fixed in Sphinx 1.1 (which is in precise
  and which we could backport into our PPA), we could enable
  translations.

  One requirement we have is: one .pot file for the whole package as
  opposed to one .pot file per article. To do this we need to set
  gettext_compact and move all articles in one directory.
  (http://sphinx.pocoo.org/config.html#confval-gettext_compact)

  I prepared a couple of things in a branch at lp:~dholbach/ubuntu-
  packaging-guide/i18n which makes "make gettext" work, but
  unfortunately this will break paths for "make html", etc.

  Any help with this is appreciated, as I'm going to be too busy to
  finish the work in the next few weeks.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu-packaging-guide/+bug/943154/+subscriptions


References