Команда перевода документации Сравнение версий

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
translate:команда_перевода_документации [2013/04/02 00:05]
[Работа с Series and Milestones на Launchpad, подготовка релизов переводов]
translate:команда_перевода_документации [2013/04/02 17:46] (текущий)
Строка 90: Строка 90:
 </​code>​ </​code>​
  
-После выполнения этой команды на странице [[lpcode>​ubuntu-ru-docs|кода проекта переводов документации]] появится новая ветка. Осталось лишь привязать её к соответствующей серии.+После выполнения этой команды на странице [[lpcode>​ubuntu-ru-docs|кода проекта переводов документации]] появится новая ветка. Осталось лишь привязать её к соответствующей серии ​(см. ниже).
  
 ===== Работа с Series and Milestones на Launchpad, подготовка релизов переводов ===== ===== Работа с Series and Milestones на Launchpad, подготовка релизов переводов =====
Строка 99: Строка 99:
  
 Таким образом все баги (и блюпринты при наличии) всегда будут прилинковываться к current milestone, остальные же milestones нужны только для выкладывания финальных подготовленных версий руководств и должны создаваться только по ходу их появления. Таким образом все баги (и блюпринты при наличии) всегда будут прилинковываться к current milestone, остальные же milestones нужны только для выкладывания финальных подготовленных версий руководств и должны создаваться только по ходу их появления.
 +
 +Для создания новой серии на [[lpproj>​ubuntu-ru-docs|главной странице проекта]] нужно просто нажать //"​Register a series"//​. Обязательно нужно что-то написать в ''​Summary'',​ например,​ "​Документация для Ubuntu 13.04 "​Raring Ringtail""​.
 +
 +После создания новой серии сразу же создаём **current** milestone (см. выше объяснение зачем это надо). Дату ему не указываем,​ но снова не забываем про ''​Summary''​. Туда можно написать что-то по типу "​Milestone для сбора багов и прочей текущей работы над переводами документации для 13.04"​.
 +
 +Не забываем прилинковывать к серии соответствующий Bazaar бранч (см. выше).
 +
 +===== Выкладывание релизов переводов =====
 +
 +После тестирования,​ вычитки и подготовки готовых сборок переводов в различных форматах,​ их нужно выкладывать на Launchpad в [[lpproj>​ubuntu-ru-docs|проект перевода документации на русский язык]].
 +
 +Для этого для начала нужно зарегистрировать ''​milestone'',​ в котором затем сделать ''​release''​ и собственно к релизу приложить файлы для скачивания.
 +
 +Для каждого типа руководства нужно создавать отдельный milestone в соответствующей серии с номером релиза перевода (если в будущем перевод обновиться - номер увеличится). Например,​ **serverguide-precise-r1**. **Обратите внимание:​** имена milestones должны быть уникальны в рамках проекта. И от них зависят различные пути для скачивания файлов. Поэтому давайте сразу же правильные имена. Подробнее про именование см. выше.
 +
 +При создании milestone указывайте текущую дату в качестве //"​Date Targeted"//​. Не забывайте про Summary. Например,​ //"​Перевод Ubuntu Server Guide на русский язык, первая финальная версия."//​.
 +
 +Затем нужно перейти во вновь созданный milestone и нажать на //"​Create release"//​. В качестве даты указываем текущую дату (дату релиза перевода),​ не забываем про //"​Release notes"//​ и, при выкладывании обновлённых версий переводов,​ про //"​Changelog"//​. //Не устанавливайте//​ галочку //"​Keep the precise-current milestone active"//​! Если её поставить,​ то milestone останется активным и к нему можно будет прикреплять баги и блюпринты. Поскольку мы уже сделали релиз, то нам это не надо. Для багов существует отдельный **current** milestone.
 +
 +После создания релиза к нему, наконец,​ можно приложить файлы для загрузки. Для этого на странице соответствующего milestone нужно нажать //"Add download file"//​. PDF и ePub версии выкладываются напрямую,​ скомпилированная HTML - в архиве (если вообще такая будет создаваться).
 +
 +В качестве //"​Description"//​ указывайте что-то по типу "​Ubuntu Server Guide 12.04 на русском (PDF)"​. Обязательно меняйте //"​File content type"//​ на //"​Installer file"//​. Кроме этого, по возможности подписывайте выкладываемые файлы своим PGP ключом из профиля. Подробнее про процесс подписи можно почитать на самом Launchpad.
 +
 +==== Публикация на сайте ====
 +
 +После выкладывания релизов переводов того или иного руководства на [[lpproj>​ubuntu-ru-docs|Launchpad]],​ обязательно нужно добавить (или обновить) ссылки на загружаемые файлы на нашем ресурсе документации на страничке [[http://​help.ubuntu.ru/​doc|Официальной документации]]. Для каждого релиза создаётся отдельный подраздел по номеру версии,​ в этом подразделе на главной выкладываются ссылки на загружаемые файлы.
 +
 +См. страницу для precise для примера:​
 +
 +  * [[http://​help.ubuntu.ru/​doc/​12.04/​главная]]
 +
 +HTML версии руководств могут быть выложены только администраторами сайта. Обращайтесь к [[user>​Malamut]] по всем вопросам,​ связанным с их выкладыванием.
 +
 +===== Публикация новостей =====
 +
 +После добавления ссылок на страницу [[http://​help.ubuntu.ru/​doc|Официальной документации]] нужно написать новости о новом переводе на различные ресурсы. Для добавления новостей на некоторые нужно связаться с администрацией,​ на некоторые же можно выложить новость самостоятельно.
 +
 +<note important>​**Обратите внимание:​** всегда в качестве страницы загрузки указывайте либо основной адрес переводов официальной документации [[http://​help.ubuntu.ru/​doc]],​ либо страничку для конкретного релиза (например,​ [[http://​help.ubuntu.ru/​doc/​12.04/​главная]]). **Никогда** не публикуйте в новостях ссылки на файлы на Launchpad. Это связано с тем, что при выпуске новых версий переводов ссылки на Launchpad потеряют актуальность,​ в то время как адрес страницы с переводами документации на ''​help.ubuntu.ru''​ всегда остаётся неизменным. И уж тем более не добавляйте в новости ссылки на тестовые сборки,​ размещённые на team.ubuntu.ru,​ поскольку они в любой момент могут быть перезалиты или вообще удалены.</​note>​
 +
 +Ресурсы,​ на которые можно добавить новость самостоятельно:​
 +
 +  * [[http://​opennet.ru]]
 +  * [[http://​linux.org.ru]]
 +
 +Ресурсы,​ на которые новость должен добавить администратор (связывайтесь по этому вопросу с [[user>​Malamut]]):​
 +
 +  * [[http://​ubuntu.ru]]
 +  * Twitter
 +  * G+