~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: John Arbash Meinel
  • Date: 2010-02-10 17:52:08 UTC
  • mfrom: (5021 +trunk)
  • mto: This revision was merged to the branch mainline in revision 5023.
  • Revision ID: john@arbash-meinel.com-20100210175208-bubuwav4uqigu291
Merge bzr.dev 5021 to resolve NEWS

Show diffs side-by-side

added added

removed removed

Lines of Context:
7
7
イントロダクション
8
8
===================
9
9
 
10
 
Bazaarは分散型バージョン管理システムで、ソフトウェアプロジェクトの
11
 
共同作業を楽にしてくれます。
 
10
Bazaarは分散型バージョン管理システムで、ソフトウェアプロジェクトの共同作業を楽にしてくれます。
12
11
 
13
 
これから5分ほどで、ファイルをバージョン管理下に置き、変更を記録して、
14
 
作業内容を確認し、公開して作業内容をマージしてもらうためにプロジェクトの
15
 
trunk に送る方法などを学びます。
 
12
これから5分ほどで、ファイルをバージョン管理下に置き、変更をそれらに記録して、\
 
13
作業内容を確認し、公開して作業内容をマージしてもらうためにプロジェクトのtrunkに\
 
14
送る方法などを学びます。
16
15
 
17
16
詳細な紹介内容を望むのであれば、 `さらに学ぶ`_ をご覧ください。
18
17
 
30
29
別のプラットフォームとソースコードからインストールする方法に関しては、 ダウンロード_
31
30
と インストール方法_ のページを参照してください。
32
31
 
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
 
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
37
36
 
38
37
 
39
38
まずは自己紹介
75
74
何も起きていないように見えても心配しないでください。
76
75
Bazaarはファイルとリビジョンの履歴を保存する branch_ を作りました。
77
76
 
78
 
.. _branch: http://wiki.bazaar.canonical.com/Branch
 
77
.. _branch: http://bazaar-vcs.org/Branch
79
78
 
80
79
次のステップはBazaarに管理して欲しいファイルを教えることです。
81
80
``bzr add`` を実行するとすべてのディレクトリとファイルがプロジェクトに\
82
 
再帰的に追加されます。 ::
 
81
再帰的に追加されます::
83
82
 
84
83
 $ bzr add
85
84
 added subdirectory
89
88
 added subdirectory/test4.txt
90
89
 
91
90
次に、これらをブランチにコミットしてスナップショットをとります。
92
 
コミットを行った理由を説明するメッセージを追加します。 ::
 
91
コミットを行った理由を説明するメッセージを追加します::
93
92
 
94
93
  $ bzr commit -m "Initial import"
95
94
 
96
95
Bazaarは分散型バージョン管理システムなので、コミットするために\
97
96
サーバーに接続する必要はありません。
98
97
代わりに、Bazaarはブランチとすべてのコミットをあなたが作業している\
99
 
ディレクトリ内部に ``.bzr`` というサブディレクトリを作ってそこに
100
 
保存します。
 
98
ディレクトリ内部に保存します;
 
99
``.bzr`` というサブディレクトリをご覧ください。
101
100
 
102
101
 
103
102
ファイルを変更する
105
104
 
106
105
ファイルを変更してブランチにその変更をコミットしてみましょう。
107
106
 
108
 
好きなエディタで ``test1.txt`` を編集し、何を行ったのかを確認します。 ::
 
107
好きなエディタで ``test1.txt`` を編集し、何を行ったのかを確認します::
109
108
 
110
109
 $ bzr diff
111
110
 === modified file 'test1.txt'
123
122
リビジョンのログを眺める
124
123
=========================
125
124
 
126
 
ログを閲覧することでブランチの履歴を調べることができます。 ::
 
125
ログを閲覧することでブランチの履歴がわかります::
127
126
 
128
127
  $ bzr log
129
128
  ------------------------------------------------------------
142
141
    Initial import
143
142
 
144
143
 
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
 
 
 
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
でも見ることができます。
176
196
 
177
197
別のブランチから自分用のコピーを作る
178
198
=====================================
180
200
他人のコードに取り組むために、ブランチのコピーを作ることができます。
181
201
実際の世界の例として、BazaarのGTKインターフェイスを見てみましょう::
182
202
 
183
 
  $ bzr branch lp:~bzr/bzr-gtk/trunk bzr-gtk.john
 
203
  $ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john
184
204
  Branched 292 revision(s).
185
205
 
186
 
Bazaarはbzr-gtkのtrunkブランチからすべてのファイルをダウンロードして
 
206
Bazaarはbzr-gtkのtrunkブランチからすべてのファイルをダウンロードして\
187
207
リビジョンの履歴をそろえ、bzr-gtk.johnというコピーを作ります。
188
208
 
189
 
これで、ブランチのコピーを手に入れたのでネットの接続のあるなしに
 
209
これで、ブランチのコピーを手に入れたのでネットの接続のあるなしに\
190
210
関わらず変更をコミットできます。
191
 
ブランチはいつでも公開することで共有でき、bzr-gtkチームがあなたの作品を
192
 
使いたいと思ったときにBazaarは彼らがあなたのブランチから彼らのブランチに
 
211
ブランチはいつでも公開することで共有でき、bzr-gtkチームがあなたの作品を\
 
212
使いたいと思ったときにBazaarは彼らがあなたのブランチから彼らのブランチに\
193
213
マージし直す作業を簡単にしてくれます。
194
214
 
195
215
 
196
216
メインのブランチから自分のブランチを更新する
197
217
=============================================
198
218
 
199
 
変更を自分のブランチにコミットしている間に、他の人がコードを元のブランチに\
 
219
変更を自分のブランチにコミットする一方で、他の人がコードを親のブランチに\
200
220
コミットしているということもよくあります。
201
221
 
202
222
自分のブランチを最新に維持するには、親ブランチから自分のブランチへと変更を\
253
273
''foo'' トピックもしくはコマンドを学ぶには::
254
274
 
255
275
  $ 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
 
日本語訳に着いて間違いや質問等ありましたらこちらへお願いします。