Различия

Здесь показаны различия между двумя версиями данной страницы.

--- translate:serverguide [2013/03/18 23:32]
создано
+++ translate:serverguide [2013/03/20 00:06] (текущий)
[Технические комментарии]
@@ Строка 2: / Строка 2: @@
 [[lpproj>serverguide|Ubuntu Server Guide]] - это официальное руководство по серверным возможностям Ubuntu. Его можно [[docs|перевести на русский]] через [[lptranslations>serverguide|Launchpad]]. На этой странице описан порядок сборки готовых русских версий руководства в различных форматах.
+Самые свежие готовые версии руководства можно загрузить с [[lp>|Launchpad]]:
+  * [[lp>ubuntu-ru-docs/+download|Страница загрузок русскоязычного проекта перевода документации]]
+Тестовые версии для вычитки и проверки:
+  * **Quantal**: {{:translate:docs:serverguide-quantal-ru.pdf|PDF}}
+  * **Precise**: {{:translate:docs:serverguide-precise-ru.pdf|PDF}}, {{:translate:docs:serverguide-precise-ru.epub|ePub}}
+===== Установка необходимых для сборки пакетов =====
+Для начала потребуется поставить несколько пакетов, необходимых для сборки руководства:
+<code bash>
+sudo aptitude install bzr fop ttf-dejavu gnome-doc-utils
+</code>
+<note important>Возможно, это не полный список. Если кто проверит - исправьте этот раздел и либо допишите необходимые пакеты, либо уберите это предупреждение.</note>
+Для сборки ePub версии нужно будет ещё кое что:
+<code bash>
+sudo aptitude install dbtoepub
+</code>
 ===== Получение исходного кода =====
-FIXME
+Теперь необходимо получить исходный код руководства. Версии для всех выпусков Ubuntu можно посмотреть на [[lpcode>serverguide|странице проекта]].
+Для скачивания текущей активной версии (обычно - для последнего выпуска Ubuntu) выполните
+<code bash>
+bzr branch lp:serverguide
+</code>
+Для скачивания версии для предыдущих выпусков Ubuntu немного другая команда((Вообще говоря, команда, которую нужно выполнить, написана на странице с исходным кодом)). Например, для **precise**:
+<code bash>
+bzr branch lp:serverguide/precise serverguide-precise
+</code>
+Параметр ''serverguide-precise'', который отсутствует в команде со [[lpcode>~ubuntu-core-doc/serverguide/precise|страницы с исходниками]], всего лишь указывает папку, в которую будет производиться загрузка. Без него будет создан использоваться каталог **precise**.
+===== Получение файла с переводом =====
+Теперь необходимо получить файл с переводом. Для этого нужно войти на [[lp>Launchpad]], перейти на [[lptranslations>serverguide|основную страницу переводов проекта]] и выбрать нужную серию, соответствующую выпуску Ubuntu. На странице нужной серии будет ссылка на русский перевод. Переходим по ней и нажимаем на "Download translation" слева над списком строчек для перевода. В качестве формата оставляем "PO format" и нажимаем на "Request download". В течение некоторого времени вам на почту придёт письмо с запрашиваемым файлом.
+Этот файл необходимо скачать, переименовать в **ru.po** и скопировать в папку ''po/'' исходного кода руководства.
+===== Правка скриптов сборки =====
+Перед тем, как собирать руководство, возможно придётся подкорректировать скрипты сборки. В противном случае PDF, например, может собраться с решётками вместо русских букв.
+Все необходимые исправления можно скачать со [[lpcode>ubuntu-ru-docs|страницы проекта перевода официальной документации на русский язык]]. Как и в случае с основными исходными кодами выбираете релиз Ubuntu и выполняете соответствующую команду. Для **precise** она будет примерно такой:
+<code bash>
+bzr branch lp:ubuntu-ru-docs/precise ru-docs-precise
+</code>
+В скачанных файлах переходите в директорию **serverguide** и читаете файл ''README''. В нём описывается порядок действий, которые необходимо выполнить перед сборкой русскоязычных версий руководства.
+===== Сборка =====
+==== Сборка PDF ====
+Для сборки **PDF** достаточно выполнить следующую команду из каталога с исходными файлами руководства:
+<code bash>
+make serverguide-pdf LN=ru
+</code>
+Если что-то пошло не так, убедитесь, что вы положили в нужное место файл **ru.po** и применили необходимые правки из проекта [[lpproj>ubuntu-ru-docs]].
+==== Сборка ePub ====
+Для сборки **ePub** выполняем из каталога с исходными кодами:
+<code bash>
+make serverguide-epub LN=ru
+</code>
+Спасибо [[http://www.the-ebook.org/forum/viewtopic.php?t=26452|неравнодушным с форума the-ebook.org]].
+==== Сборка HTML ====
+//Будет чуть позже//
+===== Технические комментарии =====
+//Чем обусловлены правки Makefile, для чего нужен fop, какие проблемы в основном англоязычном бранче руководства и т.д. и т.п.//
+Актуальные баги:
+  * [[lpbug>1157023]]
+  * [[lpbug>922251]]
+  * [[lpbug>1148616]]

Перевод Ubuntu Server Guide Сравнение версий

Различия