Перевод Ubuntu Server Guide

Ubuntu Server Guide - это официальное руководство по серверным возможностям Ubuntu. Его можно перевести на русский через Launchpad. На этой странице описан порядок сборки готовых русских версий руководства в различных форматах.

Самые свежие готовые версии руководства можно загрузить с Launchpad:

Тестовые версии для вычитки и проверки:

Установка необходимых для сборки пакетов

Для начала потребуется поставить несколько пакетов, необходимых для сборки руководства:

sudo aptitude install bzr fop ttf-dejavu gnome-doc-utils 

Возможно, это не полный список. Если кто проверит - исправьте этот раздел и либо допишите необходимые пакеты, либо уберите это предупреждение.

Для сборки ePub версии нужно будет ещё кое что:

sudo aptitude install dbtoepub 

Получение исходного кода

Теперь необходимо получить исходный код руководства. Версии для всех выпусков Ubuntu можно посмотреть на странице проекта.

Для скачивания текущей активной версии (обычно - для последнего выпуска Ubuntu) выполните

bzr branch lp:serverguide

Для скачивания версии для предыдущих выпусков Ubuntu немного другая команда1). Например, для precise:

bzr branch lp:serverguide/precise serverguide-precise

Параметр serverguide-precise, который отсутствует в команде со страницы с исходниками, всего лишь указывает папку, в которую будет производиться загрузка. Без него будет создан использоваться каталог precise.

Получение файла с переводом

Теперь необходимо получить файл с переводом. Для этого нужно войти на Launchpad, перейти на основную страницу переводов проекта и выбрать нужную серию, соответствующую выпуску Ubuntu. На странице нужной серии будет ссылка на русский перевод. Переходим по ней и нажимаем на «Download translation» слева над списком строчек для перевода. В качестве формата оставляем «PO format» и нажимаем на «Request download». В течение некоторого времени вам на почту придёт письмо с запрашиваемым файлом.

Этот файл необходимо скачать, переименовать в ru.po и скопировать в папку po/ исходного кода руководства.

Правка скриптов сборки

Перед тем, как собирать руководство, возможно придётся подкорректировать скрипты сборки. В противном случае PDF, например, может собраться с решётками вместо русских букв.

Все необходимые исправления можно скачать со страницы проекта перевода официальной документации на русский язык. Как и в случае с основными исходными кодами выбираете релиз Ubuntu и выполняете соответствующую команду. Для precise она будет примерно такой:

bzr branch lp:ubuntu-ru-docs/precise ru-docs-precise

В скачанных файлах переходите в директорию serverguide и читаете файл README. В нём описывается порядок действий, которые необходимо выполнить перед сборкой русскоязычных версий руководства.

Сборка

Сборка PDF

Для сборки PDF достаточно выполнить следующую команду из каталога с исходными файлами руководства:

make serverguide-pdf LN=ru 

Если что-то пошло не так, убедитесь, что вы положили в нужное место файл ru.po и применили необходимые правки из проекта ubuntu-ru-docs.

Сборка ePub

Для сборки ePub выполняем из каталога с исходными кодами:

make serverguide-epub LN=ru

Спасибо неравнодушным с форума the-ebook.org.

Сборка HTML

Будет чуть позже

Технические комментарии

Чем обусловлены правки Makefile, для чего нужен fop, какие проблемы в основном англоязычном бранче руководства и т.д. и т.п.

Актуальные баги:

1)
Вообще говоря, команда, которую нужно выполнить, написана на странице с исходным кодом