~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Patch Queue Manager
  • Date: 2011-09-15 15:37:20 UTC
  • mfrom: (6140.1.3 trunk)
  • Revision ID: pqm@pqm.ubuntu.com-20110915153720-n17t6m5oh5bblqad
(vila) Open 2.5b2 for bugfixes (Vincent Ladeuil)

Show diffs side-by-side

added added

removed removed

Lines of Context:
7
7
イントロダクション
8
8
===================
9
9
 
10
 
Bazaarは分散型バージョン管理システムで、ソフトウェアプロジェクトの共同作業を楽にしてくれます。
 
10
Bazaarは分散型バージョン管理システムで、ソフトウェアプロジェクトの
 
11
共同作業を楽にしてくれます。
11
12
 
12
 
これから5分ほどで、ファイルをバージョン管理下に置き、変更をそれらに記録して、\
13
 
作業内容を確認し、公開して作業内容をマージしてもらうためにプロジェクトのtrunkに\
14
 
送る方法などを学びます。
 
13
これから5分ほどで、ファイルをバージョン管理下に置き、変更を記録して、
 
14
作業内容を確認し、公開して作業内容をマージしてもらうためにプロジェクトの
 
15
trunk に送る方法などを学びます。
15
16
 
16
17
詳細な紹介内容を望むのであれば、 `さらに学ぶ`_ をご覧ください。
17
18
 
29
30
別のプラットフォームとソースコードからインストールする方法に関しては、 ダウンロード_
30
31
と インストール方法_ のページを参照してください。
31
32
 
32
 
.. _Windowsのためのインストールの手引き: http://bazaar-vcs.org/WindowsDownloads
33
 
.. _Mac OS Xのためのインストールの手引き: http://bazaar-vcs.org/MacOSXBundle
34
 
.. _ダウンロード: http://bazaar-vcs.org/Download
35
 
.. _インストール方法: http://bazaar-vcs.org/InstallationFaq
 
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
36
37
 
37
38
 
38
39
まずは自己紹介
74
75
何も起きていないように見えても心配しないでください。
75
76
Bazaarはファイルとリビジョンの履歴を保存する branch_ を作りました。
76
77
 
77
 
.. _branch: http://bazaar-vcs.org/Branch
 
78
.. _branch: http://wiki.bazaar.canonical.com/Branch
78
79
 
79
80
次のステップはBazaarに管理して欲しいファイルを教えることです。
80
81
``bzr add`` を実行するとすべてのディレクトリとファイルがプロジェクトに\
81
 
再帰的に追加されます::
 
82
再帰的に追加されます。 ::
82
83
 
83
84
 $ bzr add
84
85
 added subdirectory
88
89
 added subdirectory/test4.txt
89
90
 
90
91
次に、これらをブランチにコミットしてスナップショットをとります。
91
 
コミットを行った理由を説明するメッセージを追加します::
 
92
コミットを行った理由を説明するメッセージを追加します。 ::
92
93
 
93
94
  $ bzr commit -m "Initial import"
94
95
 
95
96
Bazaarは分散型バージョン管理システムなので、コミットするために\
96
97
サーバーに接続する必要はありません。
97
98
代わりに、Bazaarはブランチとすべてのコミットをあなたが作業している\
98
 
ディレクトリ内部に保存します;
99
 
``.bzr`` というサブディレクトリをご覧ください。
 
99
ディレクトリ内部に ``.bzr`` というサブディレクトリを作ってそこに
 
100
保存します。
100
101
 
101
102
 
102
103
ファイルを変更する
104
105
 
105
106
ファイルを変更してブランチにその変更をコミットしてみましょう。
106
107
 
107
 
好きなエディタで ``test1.txt`` を編集し、何を行ったのかを確認します::
 
108
好きなエディタで ``test1.txt`` を編集し、何を行ったのかを確認します。 ::
108
109
 
109
110
 $ bzr diff
110
111
 === modified file 'test1.txt'
122
123
リビジョンのログを眺める
123
124
=========================
124
125
 
125
 
ログを閲覧することでブランチの履歴がわかります::
 
126
ログを閲覧することでブランチの履歴を調べることができます。 ::
126
127
 
127
128
  $ bzr log
128
129
  ------------------------------------------------------------
141
142
    Initial import
142
143
 
143
144
 
144
 
sftpでブランチを公開する
145
 
=========================
146
 
 
147
 
ブランチを公開する方法は複数あります。
148
 
SFTPサーバーがすでにあるもしくは容易にセットアップできるのであれば、\
149
 
ブランチをそこで公開できます。
150
 
 
151
 
そうでなければ、このセクションをとばして、Bazaarのための無料ホスティング\
152
 
サービスである、 Launchpad_ で公開しましょう。
153
 
 
154
 
.. _Launchpad: https://launchpad.net/
155
 
 
156
 
``www.example.com/myproject`` でブランチを公開することを前提とします::
157
 
 
158
 
 $ bzr push --create-prefix sftp://your.name@example.com/~/public_html/myproject
159
 
 2 revision(s) pushed.
160
 
 
161
 
Bazaarはリモートサーバー上で ``myproject`` ディレクトリを作りブランチを\
162
 
そこにpushします。
163
 
 
164
 
これで誰でも次のコマンドを入力すればあなたのブランチをコピーできます::
165
 
 
166
 
 $ bzr branch http://www.example.com/myproject
167
 
 
168
 
**注:** sftpを使うためには、 ``paramiko`` と ``pyCrypto`` をインストールする必要があります。
169
 
詳細は http://bazaar-vcs.org/InstallationFaq を参照してください。
170
 
 
171
 
 
172
 
Launchpadでブランチを公開する
173
 
==============================
174
 
 
175
 
Launchpadはフリーソフトウェアのための開発とホスティングのためのツールが\
176
 
ひとまとめになったものです。これをブランチを公開するために利用できます。
177
 
 
178
 
Launchpadのアカウントを持っていなければ、 `アカウントのサインアップのガイド`_
179
 
に従ってアカウントを作り、 `SSHキーを登録`_ してください。
180
 
 
181
 
.. _アカウントのサインアップのガイド: https://help.launchpad.net/CreatingYourLaunchpadAccount
182
 
.. _SSHキーを登録: https://launchpad.net/people/+me/+editsshkeys
183
 
 
184
 
次のコマンドを(``john.doe`` を自分のLaunchpadアカウント名に変更して)実行してください::
185
 
 
186
 
 $ bzr push bzr+ssh://john.doe@bazaar.launchpad.net/~john.doe/+junk/myproject
187
 
 
188
 
**注:** ``+junk`` はこのブランチがLaunchpad上の特定のプロジェクトに関連していないことを意味します。
189
 
 
190
 
これで、誰でも次のコマンドを入力することでブランチのコピーを作ることができます::
191
 
 
192
 
 $ bzr branch http://bazaar.launchpad.net/~john.doe/+junk/myproject
193
 
 
194
 
ブランチとリビジョンの履歴に関する情報は https://code.launchpad.net/people/+me/+junk/myproject
195
 
でも見ることができます。
 
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
 
196
176
 
197
177
別のブランチから自分用のコピーを作る
198
178
=====================================
200
180
他人のコードに取り組むために、ブランチのコピーを作ることができます。
201
181
実際の世界の例として、BazaarのGTKインターフェイスを見てみましょう::
202
182
 
203
 
  $ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john
 
183
  $ bzr branch lp:~bzr/bzr-gtk/trunk bzr-gtk.john
204
184
  Branched 292 revision(s).
205
185
 
206
 
Bazaarはbzr-gtkのtrunkブランチからすべてのファイルをダウンロードして\
 
186
Bazaarはbzr-gtkのtrunkブランチからすべてのファイルをダウンロードして
207
187
リビジョンの履歴をそろえ、bzr-gtk.johnというコピーを作ります。
208
188
 
209
 
これで、ブランチのコピーを手に入れたのでネットの接続のあるなしに\
 
189
これで、ブランチのコピーを手に入れたのでネットの接続のあるなしに
210
190
関わらず変更をコミットできます。
211
 
ブランチはいつでも公開することで共有でき、bzr-gtkチームがあなたの作品を\
212
 
使いたいと思ったときにBazaarは彼らがあなたのブランチから彼らのブランチに\
 
191
ブランチはいつでも公開することで共有でき、bzr-gtkチームがあなたの作品を
 
192
使いたいと思ったときにBazaarは彼らがあなたのブランチから彼らのブランチに
213
193
マージし直す作業を簡単にしてくれます。
214
194
 
215
195
 
216
196
メインのブランチから自分のブランチを更新する
217
197
=============================================
218
198
 
219
 
変更を自分のブランチにコミットする一方で、他の人がコードを親のブランチに\
 
199
変更を自分のブランチにコミットしている間に、他の人がコードを元のブランチに\
220
200
コミットしているということもよくあります。
221
201
 
222
202
自分のブランチを最新に維持するには、親ブランチから自分のブランチへと変更を\
273
253
''foo'' トピックもしくはコマンドを学ぶには::
274
254
 
275
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
日本語訳に着いて間違いや質問等ありましたらこちらへお願いします。