Upload of ubuntu-docs soon?

Kevin Godby godbyk at gmail.com
Mon Apr 15 00:24:16 UTC 2013

Hello, everyone.

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
> https://translations.launchpad.net/ubuntu-docs/raring
> 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
> https://code.launchpad.net/~ubuntu-core-doc/ubuntu-docs/help.ubuntu.com
> 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.

—Kevin Godby
-------------- next part --------------
A non-text attachment was scrubbed...
Name: update-translations.sh
Type: application/x-sh
Size: 1245 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20130414/19a2fd86/attachment.sh>

More information about the ubuntu-doc mailing list