Upload of ubuntu-docs soon?
godbyk at gmail.com
Mon Apr 15 00:24:16 UTC 2013
On Sun, Apr 14, 2013 at 3:16 PM, Jeremy Bicha <jbicha at ubuntu.com> wrote:
> We need someone to commit to uploading the final ubuntu-docs package
> for the 13.04 release images Tuesday morning. The final language packs
> are generated from the archive packages Tuesday so that it will be
> complete by final freeze on Thursday.
I tried building the docs but failed to get everything working. I've
never created a .deb package before either, and don't expect to have
time to learn how to do all that before Tuesday.
I have included a few notes below that may help out others that want
to give it a shot, though.
> Doing the upload involves these steps:
> 1. Download the translation tarball from
> 2. Rename the updated translation files you downloaded to match the
> already existing naming convention in the po/ folder. The
> ubuntu-manual team has a script to help with this or you can see the
> note in the README in the ubuntu-docs repository.
I've attached a shell script that will handle the renaming for you.
Download the launchpad-export.tar.gz file to the ubuntu-docs project
root. Drop the shell script in the same directory. Then run the shell
$ ./update-translations.sh launchpad-export.tar.gz
This will extract the translation files from the tarball, rename them,
move them to their proper subdirectories, and update the HELP_LINGUAS
variable in the ubuntu-help/Makefile.am file.
> After all that is done, it would be good to update
> http://help.ubuntu.com/ with an offline copy of the documentation. The
> branch for that is at
> You can generate the html for ubuntu-docs by running 'make html' from
> the ubuntu-help/ directory. This will create a html/ directory with
> the files you need. It looks like for the serverguide you just need to
> run 'make serverguide-html' from lp:serverguide. I never figured out
> how to correctly generate the installation guide HTML which was why it
> was not included for 12.10.
Before running 'make html', you'll need to edit the html/Makefile and
html/ubuntu.xsl files to bump the version number from 12.10 to 13.04.
In the html/Makefile, you should also copy the HELP_LINGUAS line from
the ubuntu-help/Makefile.am file. Finally, you'll get loads of
complaints if you haven't taken all the required screenshots for each
of the translated languages.
I will continue to work on all of this later, but it's unlikely that
I'll have time to figure everything out by the Tuesday deadline.
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 1245 bytes
Desc: not available
More information about the ubuntu-doc