Сборка справки Ubuntu для проверки правильности перевода

Сборка в формате HTML

1) Создайте локальную копию нужной ветки bzr. Например, чтобы получить исходники текущей разрабатываемой версии справки, выполните команду:

bzr branch lp:ubuntu-docs

Для отслеживания обновлений в дальнейшем можно будет воспользоваться командой bzr update

2) В этой скачанной ветке, как правило, устаревший русский перевод, поэтому нужно экспортировать с Launchpad свежий .po-файл с переводом (например, для Ubuntu 13.10 его можно получить по ссылке https://translations.launchpad.net/ubuntu-docs/saucy/+export), переименовать в ru.po и заменить им устаревший ru.po, который находится в подкаталоге ubuntu-help/ru каталога с исходниками справки.

3)Установите следующие пакеты: make, gettext, docbook-xsl, yelp-tools, gnome-common, и yelp-xsl. Возможно, некоторые из них у вас уже установлены.

4) Перейдите в каталог исходников документации (например, ~/ubuntu-docs) и выполните команду:

./autogen.sh

5) Если нужна не только английская html, следует предварительно собрать .page-файлы для других языков. Наберите:

cd ubuntu-help

make

Если вам нужна только русская справка, для значительного ускорения процесса уберите перед сборкой в файле Makefile все языки, кроме русского, из строки HELP_LINGUAS=…, т.е. оставьте только HELP_LINGUAS=ru

В общем-то, после этого мы уже получаем готовую справку в формате xml, которую можно просмотреть в yelp (обозревателе справки Gnome):

yelp ./ru

6) Теперь сгенерируем HTML. Наберите:

cd ..

cd html

make

Опять-таки перед сборкой можете оставить и в Makefile из этого каталога только HELP_LINGUAS=ru

Готовая справка будет в каталоге html/build/ru. Для её просмотра откройте index.html.