← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/ja/mini-tutorial/index.txt

Turn completion assertions into separate methods.

Many common assertions used to be expressed as arguments to the complete
method.  This makes the checks more explicit, and the code easier to read.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/mini-tutorial/index.txt
1
 
=================
2
 
5分でわかるBazaar
3
 
=================
4
 
 
5
 
.. _introduction:
6
 
 
7
 
イントロダクション
8
 
===================
9
 
 
10
 
Bazaarは分散型バージョン管理システムで、ソフトウェアプロジェクトの
11
 
共同作業を楽にしてくれます。
12
 
 
13
 
これから5分ほどで、ファイルをバージョン管理下に置き、変更を記録して、
14
 
作業内容を確認し、公開して作業内容をマージしてもらうためにプロジェクトの
15
 
trunk に送る方法などを学びます。
16
 
 
17
 
詳細な紹介内容を望むのであれば、 `さらに学ぶ`_ をご覧ください。
18
 
 
19
 
 
20
 
インストール方法
21
 
=================
22
 
 
23
 
このガイドではBazaarをインストールする方法を説明しませんが、通常はとても簡単です。
24
 
インストール方法の手引きは次の通りです:
25
 
 
26
 
- **GNU/Linux:** おそらくBazaarはあなたのGNU/Linuxディストリビューションに含まれています。
27
 
- **Windows:** `Windowsのためのインストールの手引き`_.
28
 
- **Mac OS X:** `Mac OS Xのためのインストールの手引き`_.
29
 
 
30
 
別のプラットフォームとソースコードからインストールする方法に関しては、 ダウンロード_
31
 
と インストール方法_ のページを参照してください。
32
 
 
33
 
.. _Windowsのためのインストールの手引き: http://wiki.bazaar.canonical.com/WindowsDownloads
34
 
.. _Mac OS Xのためのインストールの手引き: http://wiki.bazaar.canonical.com/MacOSXBundle
35
 
.. _ダウンロード: http://wiki.bazaar.canonical.com/Download
36
 
.. _インストール方法: http://wiki.bazaar.canonical.com/InstallationFaq
37
 
 
38
 
 
39
 
まずは自己紹介
40
 
=================
41
 
 
42
 
作業にとりかかる前に、まずあなたが誰なのかをBazaarに教えてあげましょう。
43
 
そうすることで、履歴の中からあなたの作業を正確に識別することができます。
44
 
 
45
 
次のように入力してください(もちろん、あなたの名前とEメールアドレスで)::
46
 
 
47
 
  $ bzr whoami "John Doe <john.doe@gmail.com>"
48
 
 
49
 
こうするとBazaarは、あなたの名前やEメールアドレスが入った設定ファイルを作成\
50
 
もしくは修正します。
51
 
 
52
 
名前とEメールアドレスが正しく登録されているか確認しましょう ::
53
 
 
54
 
  $ bzr whoami
55
 
  John Doe <john.doe@gmail.com>
56
 
 
57
 
 
58
 
ファイルをバージョン管理する
59
 
=============================
60
 
 
61
 
Bazaarで扱うディレクトリといくつかのファイルを作りましょう::
62
 
 
63
 
 $ mkdir myproject
64
 
 $ cd myproject
65
 
 $ mkdir subdirectory
66
 
 $ touch test1.txt test2.txt test3.txt subdirectory/test4.txt
67
 
 
68
 
**Windowsユーザーのための注意:** Windows Explorerを使ってディレクトリを作成し、\
69
 
そのディレクトリの中で右クリックをして ``新規作成`` を選択し、ファイルを作成します。
70
 
 
71
 
Bazaarにあなたのプロジェクトディレクトリを初期化させましょう::
72
 
 
73
 
  $ bzr init
74
 
 
75
 
何も起きていないように見えても心配しないでください。
76
 
Bazaarはファイルとリビジョンの履歴を保存する branch_ を作りました。
77
 
 
78
 
.. _branch: http://wiki.bazaar.canonical.com/Branch
79
 
 
80
 
次のステップはBazaarに管理して欲しいファイルを教えることです。
81
 
``bzr add`` を実行するとすべてのディレクトリとファイルがプロジェクトに\
82
 
再帰的に追加されます。 ::
83
 
 
84
 
 $ bzr add
85
 
 added subdirectory
86
 
 added test1.txt
87
 
 added test2.txt
88
 
 added test3.txt
89
 
 added subdirectory/test4.txt
90
 
 
91
 
次に、これらをブランチにコミットしてスナップショットをとります。
92
 
コミットを行った理由を説明するメッセージを追加します。 ::
93
 
 
94
 
  $ bzr commit -m "Initial import"
95
 
 
96
 
Bazaarは分散型バージョン管理システムなので、コミットするために\
97
 
サーバーに接続する必要はありません。
98
 
代わりに、Bazaarはブランチとすべてのコミットをあなたが作業している\
99
 
ディレクトリ内部に ``.bzr`` というサブディレクトリを作ってそこに
100
 
保存します。
101
 
 
102
 
 
103
 
ファイルを変更する
104
 
===================
105
 
 
106
 
ファイルを変更してブランチにその変更をコミットしてみましょう。
107
 
 
108
 
好きなエディタで ``test1.txt`` を編集し、何を行ったのかを確認します。 ::
109
 
 
110
 
 $ bzr diff
111
 
 === modified file 'test1.txt'
112
 
 --- test1.txt   2007-10-08 17:56:14 +0000
113
 
 +++ test1.txt   2007-10-08 17:46:22 +0000
114
 
 @@ -0,0 +1,1 @@
115
 
 +test test test
116
 
 
117
 
作業をBazaarのブランチにコミットします::
118
 
 
119
 
  $ bzr commit -m "Added first line of text"
120
 
  Committed revision 2.
121
 
 
122
 
 
123
 
リビジョンのログを眺める
124
 
=========================
125
 
 
126
 
ログを閲覧することでブランチの履歴を調べることができます。 ::
127
 
 
128
 
  $ bzr log
129
 
  ------------------------------------------------------------
130
 
  revno: 2
131
 
  committer: John Doe <john.doe@gmail.com>
132
 
  branch nick: myproject
133
 
  timestamp: Mon 2007-10-08 17:56:14 +0000
134
 
  message:
135
 
    Added first line of text
136
 
  ------------------------------------------------------------
137
 
  revno: 1
138
 
  committer: John Doe <john.doe@gmail.com>
139
 
  branch nick: myproject
140
 
  timestamp: Mon 2006-10-08 17:46:22 +0000
141
 
  message:
142
 
    Initial import
143
 
 
144
 
 
145
 
ブランチを Launchpad で公開する
146
 
===================================
147
 
 
148
 
Launchpad はソフトウェアプロジェクトの開発と運営のためのツールをまとめた
149
 
サイトです。自分のブランチを公開するために Launchpad を利用することができます。
150
 
(もちろん、自分のサーバーや他のホスティングサービス上で公開することもできます)
151
 
 
152
 
まだ Launchpad のアカウントを持っていないのであれば、 `account signup guide`_
153
 
に従ってアカウントを作成し、 `SSH 鍵を登録`_ してください。
154
 
 
155
 
.. _account signup guide: https://help.launchpad.net/CreatingYourLaunchpadAccount
156
 
.. _SSH 鍵を登録: https://launchpad.net/people/+me/+editsshkeys
157
 
 
158
 
次のように、 (``john.doe`` は自分のアカウントのユーザー名に置き換えて)
159
 
タイプしてください。 [#]_ ::
160
 
 
161
 
 $ bzr push lp:~john.doe/+junk/myproject
162
 
 
163
 
.. [#] ``lp:`` という URL スキーマは bzr 0.92 以降でサポートされています。
164
 
 
165
 
**注意**: ``+junk`` の部分は、このブランチが Launchpad 上の特定のプロジェクトに
166
 
属していないことを意味しています。
167
 
 
168
 
これで、誰でもあなたのブランチのコピーを、次のようなコマンドで入手できるようになりました。 ::
169
 
 
170
 
 $ bzr branch lp:~john.doe/+junk/myproject
171
 
 
172
 
ブランチの情報を、履歴も含めて
173
 
https://code.launchpad.net/people/+me/+junk/myproject
174
 
から閲覧することができます。
175
 
 
176
 
 
177
 
別のブランチから自分用のコピーを作る
178
 
=====================================
179
 
 
180
 
他人のコードに取り組むために、ブランチのコピーを作ることができます。
181
 
実際の世界の例として、BazaarのGTKインターフェイスを見てみましょう::
182
 
 
183
 
  $ bzr branch lp:~bzr/bzr-gtk/trunk bzr-gtk.john
184
 
  Branched 292 revision(s).
185
 
 
186
 
Bazaarはbzr-gtkのtrunkブランチからすべてのファイルをダウンロードして
187
 
リビジョンの履歴をそろえ、bzr-gtk.johnというコピーを作ります。
188
 
 
189
 
これで、ブランチのコピーを手に入れたのでネットの接続のあるなしに
190
 
関わらず変更をコミットできます。
191
 
ブランチはいつでも公開することで共有でき、bzr-gtkチームがあなたの作品を
192
 
使いたいと思ったときにBazaarは彼らがあなたのブランチから彼らのブランチに
193
 
マージし直す作業を簡単にしてくれます。
194
 
 
195
 
 
196
 
メインのブランチから自分のブランチを更新する
197
 
=============================================
198
 
 
199
 
変更を自分のブランチにコミットしている間に、他の人がコードを元のブランチに\
200
 
コミットしているということもよくあります。
201
 
 
202
 
自分のブランチを最新に維持するには、親ブランチから自分のブランチへと変更を\
203
 
マージします::
204
 
 
205
 
  $ bzr merge
206
 
  Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
207
 
  All changes applied successfully.
208
 
 
209
 
何が変更されたのか確認します::
210
 
 
211
 
  $ bzr diff
212
 
 
213
 
変更に満足したら、それらを自分のブランチにコミットします::
214
 
 
215
 
  $ bzr commit -m "Merge from main branch"
216
 
  Committed revision 295.
217
 
 
218
 
 
219
 
作業を親のブランチにマージする
220
 
==============================
221
 
 
222
 
bzr-gtkの個人ブランチに取り組んだ後で、あなたの変更を上流のプロジェクトに\
223
 
戻したいことがあるかもしれません。
224
 
最も簡単な方法はマージディレクティブを使うことです。
225
 
 
226
 
マージディレクティブ(merge directive)とは、コンピュータに特定のマージを実行\
227
 
させるためのリクエストです。
228
 
マージディレクティブは大抵、マージをレビューするためのパッチと、マージを実行する\
229
 
のに必要となるリビジョン、もしくはリビジョンを取得できるブランチを含みます。
230
 
 
231
 
次のコマンドの ``mycode.patch`` を適当な名前に書き換えて、マージのディレクティブを作ります::
232
 
 
233
 
 $ bzr send -o mycode.patch
234
 
 Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
235
 
 
236
 
これでbzr-gtkのプロジェクトにマージディレクティブをEメールで送ることが可能に\
237
 
なりました。彼らが納得すれば、親ブランチにマージすることができます。
238
 
 
239
 
 
240
 
さらに学ぶ
241
 
==========
242
 
 
243
 
Bazaarに関する詳細な内容は `Bazaarのユーザーガイド <../user-guide/index.html>`_ で調べることができます。
244
 
 
245
 
コマンドラインでBazaarを学ぶには::
246
 
 
247
 
  $ bzr help
248
 
 
249
 
Bazaarのコマンドを学ぶには::
250
 
 
251
 
  $ bzr help commands
252
 
 
253
 
''foo'' トピックもしくはコマンドを学ぶには::
254
 
 
255
 
  $ bzr help foo
256
 
 
257
 
 
258
 
Licence
259
 
=============
260
 
 
261
 
Copyright 2007-2011 Canonical Ltd. Bazaar is free software, and you
262
 
may use, modify and redistribute both Bazaar and this document under
263
 
the terms of the GNU General Public License version 2 or later. See
264
 
<http://www.gnu.org/licenses/>.
265
 
 
266
 
 
267
 
日本語訳について
268
 
-----------------
269
 
この日本語訳は、 `Bazaar-jaグループ <https://groups.google.com/group/bazaar-ja>`_
270
 
がメンテナンスしています。
271
 
 
272
 
日本語訳に着いて間違いや質問等ありましたらこちらへお願いします。