Готовый перевод Bazaar is a distributed version control system / Базар - распределенная система контроля версий: doc/en/mini-tutorial/index.txt

======================
Базар за пять минут
======================

.. contents::

Введение
========

Базар - это распределенная система контроля версий, которая упрощает совместную работу над программными проектами.

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

Если вы предпочитаете более подробное введение, обратитесь к разделу Узнать больше_.

Установка
============

Это руководство не описывает как установить Базар, потому что обычно это очень легко. Инструкции по установке вы найдете тут:

- **GNU/Linux:** скорее всего Базар уже присутствует в вашем дистрибутиве GNU/Linux.
- **Windows:** инструкции по установке для Windows_.
- **Mac OS X:** инструкции по установке для Mac OS X_.

Для других платформ и для установки из исходных кодов, обратитесь к страницам Загрузка_ и Установка_.

.. _инструкции по установке для Windows: http://bazaar-vcs.org/WindowsDownloads
.. _инструкции по установке для Mac OS X: http://bazaar-vcs.org/MacOSXBundle
.. _Загрузка: http://bazaar-vcs.org/Download
.. _Установка: http://bazaar-vcs.org/InstallationFaq

Представьтесь
====================

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

Используйте ваше имя и адрес электронной почты, вместо Васи Пупкиного, напишите:

$ bzr whoami "Vasya Pupkin <vasya.pupkin@mail.ru>"

Базар создаст или подправит файл настроек, включив в него ваше имя и адрес электронной почты.

Теперь, проверьте правильно ли установлены ваше имя и адрес электронной почты:

$ bzr whoami
Vasya Pupkin <vasya.pupkin@mail.ru>

Начинаем контролировать версии файлов
===================================

Создадим каталог и какие-нибудь файлы для использования с Базаром:

$ mkdir myproject
$ cd myproject
$ mkdir subdirectory
$ touch test1.txt test2.txt test3.txt subdirectory/test4.txt

**Замечание для пользователей Windows:** используйте Windows Explorer для создания ваших каталогов, затем нажимайте правую кнопку мыши в этих каталогах и выбирайте Новый файл, чтобы создать ваши файлы.

Теперь дадим Базару возможность самонастроиться в каталоге вашего проекта::

$ bzr init

Если всё выглядит так, как будто ничего не случилось - не волнуйтесь. Базар создал ветку_ там же, где он хранит ваши файлы и историю их изменений.

.. _ветку: http://bazaar-vcs.org/Branch

Следующим шагом нужно сказать Базару какие файлы вы хотите контролировать. Если выполнить bzr add будет добавлено все что есть в проекте::

$ bzr add
added subdirectory
added test1.txt
added test2.txt
added test3.txt
added subdirectory/test4.txt

Далее, сделаем снимок ваших файлов и зафиксируем их в вашей ветке. Добавьте сообщение с объеяснением - зачем вы их зафиксировали::

$ bzr commit -m "Initial import"

Т.к. Базар это распределенная система контроля версий, он не соединяется с центральным сервером чтобы сделать фиксацию. Вместо этого, Базар сохраняет вашу ветку и все её фиксации внутри каталога с которым вы работаете; обратите внимание на подкаталог .bzr.

Вносим изменения в ваши файлы
============================

Давайте изменим файл и зафиксируем это изменение в вашей ветке.

Отредактируйте test1.txt в своем любимом рекдакторе, потом проверьте что вы сделали::

$ bzr diff
=== modified file 'test1.txt'
--- test1.txt 2007-10-08 17:56:14 +0000
+++ test1.txt 2007-10-08 17:46:22 +0000
@@ -0,0 +1,1 @@
+test test test

Зафиксируем вашу работу в ветке Базара::

$ bzr commit -m "Added first line of text"
Committed revision 2.

Просматриваем журнал изменений
========================

Вы можете увидеть историю вашей ветки просмотрев её журнал::

$ bzr log
------------------------------------------------------------
revno: 2
committer: Vasya Pupkin <vasya.pupkin@mail.ru>
branch nick: myproject
timestamp: Mon 2007-10-08 17:56:14 +0000
message:
Added first line of text
------------------------------------------------------------
revno: 1
committer: Vasya Pupkin <vasya.pupkin@mail.ru>
branch nick: myproject
timestamp: Mon 2006-10-08 17:46:22 +0000
message:
Initial import

Публикуем вашу ветку через SFTP
================================

Есть несколько способов выложить вашу ветку в интернет. Если у вас уже есть SFTP сервер, или вы готовы его установить, можно разместить ветку на нем.

Если же нет - переходите к следующему разделу, где описана работа с бесплатным хостинговым сервисом Launchpad_.

.. _Launchpad: https://launchpad.net/

Предположим, что вы хотите опубликовать свою ветку на www.example.com/myproject::

$ bzr push --create-prefix sftp://your.name@example.com/~/public_html/myproject
2 revision(s) pushed.

Базар создаст каталог myproject на удаленном сервере и поместит в него вашу ветку.

Теперь кто угодно может создать свою личную копию вашей ветки, выполнив::

$ bzr branch http://www.example.com/myproject

**Замечание:** чтобы использовать SFTP, вы дожны установить paramiko и pyCrypto. За подробностями обращайтесь к http://bazaar-vcs.org/InstallationFaq.

Публикация собственной ветки на Launchpad
===================================

Launchpad это набор инструментов для разработки и размещения проектов свободного программного обеспечения. Вы можете использовать его для публикации своей ветки.

Если у вас нет учетной записи Launchpad, следуюйте руководству по получению учетной записи_ и зарегистрируйте SSH ключ_ в своей новой учетной записе.

.. _руководству по получению учетной записи: https://help.launchpad.net/CreatingYourLaunchpadAccount
.. _зарегистрируйте SSH ключ: https://launchpad.net/people/+me/+editsshkeys

Замените vasya.pupkin на имя вашего пользователя в Launchpad, выполнив::

$ bzr push bzr+ssh://vasya.pupkin@bazaar.launchpad.net/~vasya.pupkin/+junk/myproject

**Замечание:** +junk означает что ветка не связана с каким либо проектом на Launchpad.

Теперь кто угодно может создать свою собственную копию вашей ветки, выполнив::

$ bzr branch http://bazaar.launchpad.net/~vasya.pupkin/+junk/myproject

Вы также можете ознакомиться с информацией по вашей ветке, включая журнал изменений, по адресу https://code.launchpad.net/people/+me/+junk/myproject

Создаем личную копию другой ветки
========================================

Чтобы работать с чьим либо кодом, вы можете создать личную копию их ветки. Давайте возьмем пример из реального мира - GTK интерфейс для Bazaar::

$ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.vasya
Branched 292 revision(s).

Базар загрузит все файлы и полный журнал изменений из главной ветки проекта bzr-gtk и создаст копию с именем bzr-gtk.vasya.

Теперь, у вас есть личная копи ветки и вы можете фиксировать изменения с или без сетевого подключения. Вы можете поделиться своей веткой в любое время, опубликовав её. И если команда bzr-gtk захочет использовать вашу работу, Базар легко позволит им объеденить вашу ветку с их главной веткой.

Обновляем вашу ветку до главной
=========================================

Пока вы фиксируете изменения в вашей ветке, другие люди, скорее всего, так же продолжают фиксировать код в родительской ветке.

Чтобы быть увереным что ваша ветка остается свежей, вам следует обновлять её до родительской::

$ bzr merge
Using saved location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
All changes applied successfully.

Проверьте что изменилось:

$ bzr diff

Если изменения вас устраивают, вы можете зафиксировать их в своей личной ветке:

$ bzr commit -m "Merge from main branch"
Committed revision 295.

Обновляем родительскую ветку вашими наработками
========================================

После того как вы поработали в своей личной ветки bzr-gtk, вы можете захотеть отправить ваши изменения обратно в проект. Простейший способ заключается в использовании инструкций для объединения.

Инструкции для объединения это машиночитаемый запрос на осуществление конкретного объединения. Обычно он содержит обзор заплатки для объединения, а также содержит необходимые ревизии или указывает на ветку, откуда они могут быть получены.

Замените mycode.patch, указав свою инструкцию merge::

$ bzr send -o mycode.patch
Using saved location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk

Теперь вы можете отправить по электронной почте инструкцию merge в проект bzr-gtk. И если они согласны, то смогут использовать её чтобы объединить вашу работу с родительской веткой.

Узнать больше
=============

Больше информации о Базаре вы найдете в Руководстве пользователя Базара <../user-guide/index.html>_.

Чтобы узнать больше о Базаре из командой строки::

$ bzr help

Чтобы узнать основные команды Базара::

$ bzr help commands

Чтобы узнать о теме или команде "foo"::

$ bzr help foo

Переведено на Нотабеноиде
http://notabenoid.org/book/164/1652

Переводчики: master, AlexIljin, hdima, Takuto