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

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

master 17.08.08 в 12:31

.. содержание::

AlexIljin 17.08.08 в 15:07

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

master 17.08.08 в 12:31

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

master 17.08.08 в 12:32

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

master 17.08.08 в 12:34

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

master 17.08.08 в 12:34

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

master 17.08.08 в 12:34

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

master 17.08.08 в 12:35

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

master 17.08.08 в 12:36

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

master 17.08.08 в 12:36

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

master 17.08.08 в 12:37

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

master 17.08.08 в 12:38

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

master 17.08.08 в 12:38

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

master 17.08.08 в 12:39

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

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

master 17.08.08 в 12:40

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

master 17.08.08 в 12:41

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

master 17.08.08 в 12:41

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

master 17.08.08 в 12:41

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

master 17.08.08 в 12:42

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

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

master 17.08.08 в 12:43

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

master 17.08.08 в 12:44

$ bzr init

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

master 17.08.08 в 12:46

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

master 17.08.08 в 12:47

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

master 17.08.08 в 12:48

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

AlexIljin 17.08.08 в 15:07

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

master 17.08.08 в 12:50

$ bzr commit -m "Initial import"

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

master 17.08.08 в 12:52

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

master 17.08.08 в 12:52

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

master 17.08.08 в 12:52

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

master 17.08.08 в 12:53

$ 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

AlexIljin 17.08.08 в 15:07

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

master 17.08.08 в 12:53

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

AlexIljin 17.08.08 в 15:07

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

master 17.08.08 в 12:54

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

master 17.08.08 в 12:56

$ 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

master 17.08.08 в 12:57

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

master 17.08.08 в 12:57

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

master 17.08.08 в 12:57

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

master 17.08.08 в 12:58

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

AlexIljin 17.08.08 в 15:07

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

master 17.08.08 в 12:59

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

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

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

master 17.08.08 в 13:00

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

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

master 17.08.08 в 13:01

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

master 17.08.08 в 12:30

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

master 17.08.08 в 13:01

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

master 17.08.08 в 13:02

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

master 17.08.08 в 13:02

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

master 17.08.08 в 13:03

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

master 17.08.08 в 13:03

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

master 17.08.08 в 13:03