Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
translate:команда_перевода_документации [2013/04/02 00:01] [Работа с 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, подготовка релизов переводов ===== | ||
Строка 96: | Строка 96: | ||
**Series** - это глобальные этапы разработки, в нашем случае каждый релиз Ubuntu - одна серия. Именоваться они должны по кодовым именам соответствующих версий Ubuntu. Например, для //Ubuntu 12.04 LTS «Precise Pangolin»// серия должна называться **precise**. | **Series** - это глобальные этапы разработки, в нашем случае каждый релиз Ubuntu - одна серия. Именоваться они должны по кодовым именам соответствующих версий Ubuntu. Например, для //Ubuntu 12.04 LTS «Precise Pangolin»// серия должна называться **precise**. | ||
- | **Milestones** - это этапы разработки в рамках одной серии. В нашем случае в рамках каждой серии всегда должен быть один специальный ''milestone'' с именем серии и приставкой **current** (например, **precise-current**) для того, чтобы прилинковывать к нему все баги для данной серии. Кроме этого после подготовки финальной версии перевода для каждого из руководств нужно создавать отдельный milestone с именем вида //"руководство-кодовое имя-версия перевода"//. Например, **serverguide-precise-r1**. Версии перевода нумеруются от **1** с приставкой **r** (r1, r2, r3 и т.д.) | + | **Milestones** - это этапы разработки в рамках одной серии. В нашем случае в рамках каждой серии всегда должен быть один специальный всегда активный ''milestone'' с именем серии и приставкой **current** (например, **precise-current**) для того, чтобы прилинковывать к нему все баги для данной серии. Кроме этого после подготовки финальной версии перевода для каждого из руководств нужно создавать отдельный неактивный milestone с именем вида //"руководство-кодовое имя-версия перевода"//. Например, **serverguide-precise-r1**. Версии перевода нумеруются от **1** с приставкой **r** (r1, r2, r3 и т.д.) |
Таким образом все баги (и блюпринты при наличии) всегда будут прилинковываться к 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]] | ||
+ | |||
+ | * G+ |