~bzr-pqm/bzr/bzr.dev : contents of doc/ja/user-guide/branching_a

~bzr-pqm/bzr/bzr.dev : (revision 6621)

4634.99.1 by Naoki INADA import doc-ja rev90	1	プロジェクトをブランチする
	2	===========================
	3
	4	ブランチのURL
	5	--------------
	6
	7	誰かがあなたの作品のコピーを手に入れる前に、転送プロトコルを理解する必要があります。
	8	ブランチのトップレベルのディレクトリを、Windowsユーザーが慣れ親しんだ方法で、\
	9	ネットワーク上で共有することを決定するとします。
	10	LinuxとOS Xのユーザーは、大抵のSSHサーバーに組み込まれているセキュアなプロトコルである、\
	11	SFTPを通してアクセスする方が望ましいです。
	12	Bazaarは下記で一部が示されるたくさんのプロトコルのサポートに関してとても柔軟です。
	13
	14	=========== ==========================================================================
	15	スキーム説明
	16	=========== ==========================================================================
5875.1.1 by INADA Naoki Update Japanese docs.	17	\file:// 標準ファイルシステムを利用してアクセスする (デフォルト)
	18	\bzr+ssh:// SSH ごしのアクセス (リモートで最良の選択肢).
	19	\sftp:// SFTPを利用してアクセスする (大抵のSSHサーバーはSFTPを提供する)
	20	\bzr:// Bazaarのスマートサーバーを利用した高速のアクセス
	21	\ftp:// パッシブFTPを利用してアクセスする
	22	\http:// Webサーバーによって公開されたブランチへのアクセス
	23	\https:// Webサーバーによって公開されたブランチへの、暗号化されたアクセス
4634.99.1 by Naoki INADA import doc-ja rev90	24	=========== ==========================================================================
	25
	26	上記で示されるように、ブランチは転送プロトコルを示すスキームを伴うURLを使用して識別されます。
	27	スキームが無ければ、通常のファイルの名前が想定されます。
	28	サポートされるプロトコルの完全なリストに関しては、
	29	``urlspec`` のオンライントピックもしくはBazaarのユーザーリファレンスの
5875.1.1 by INADA Naoki Update Japanese docs.	30	`URLの識別子 <../user-reference/index.html#url-identifiers>`_
4634.99.1 by Naoki INADA import doc-ja rev90	31	のセクションを参照してください。
4634.99.1 by Naoki INADA import doc-ja rev90	32
5875.1.1 by INADA Naoki Update Japanese docs.	33	URL は通常サーバーのルートディレクトリから解決されます。
	34	なので、 ``ftp://example.com/repo/foo`` はそのホストの ``/repo/foo``
	35	ディレクトリを意味しています。(「通常」といっているのは、Apacheの
	36	ようないくつかのサーバーソフトウェアはURLを任意の場所にリマップ
	37	できるからです。この場合はサーバーの設定ファイルを確認して、
	38	どのURLがどのディレクトリを参照しているかを探さないといけないでしょう)
	39
	40	サーバー上の自分のホームディレクトリからの相対パスを使うには、チルダを
	41	使います。たとえば ``bzr+ssh://example.com/~/public_html`` と書くと、
	42	ホームディレクトリの中の ``public_html`` ディレクトリにマップされます。
	43
	44	.. note:: HTTP や HTTPS ごしのアクセスはデフォルトでは読み込み専用です。
	45	読み書き両方に対応するための設定については、
	46	`HTTP スマートサーバーごしの push <http_smart_server.html#pushing-over-the-http-smart-server>`_
	47	を参照してください。
	48
4634.99.1 by Naoki INADA import doc-ja rev90	49	.. _a-reminder-about-shared-repositories:
	50
	51	共用レポジトリに関するリマインダ
	52	---------------------------------
	53
	54	ブランチのコピーを手に入れる前に、ファイルシステム上に設置する場所を少し考えて\
	55	みましょう。
	56	最大限のストレージの効率性のために、共用リポジトリとしてセットアップされた\
	57	ディレクトリの元でブランチを作ることを推奨します。
	58	(よく使われるレイアウトについては、 `作業スペースを構成する
	59	<organizing_your_workspace.html>`_ の中の `ブランチの機能
	60	<organizing_your_workspace.html#feature-branches>`_
	61	を参照してください)
	62	たとえば::
	63
	64	bzr init-repo my-repo
	65	cd my-repo
	66
	67	誰からでもブランチを入手して好きなようにする準備ができました。
	68
	69	ブランチのコマンド
	70	-------------------
	71
	72	既存のブランチに基づいたブランチを手に入れるためには、 ``branch``
	73	コマンドを使用してください。構文は次のとおりです::
	74
	75	bzr branch URL [directory]
	76
	77	ディレクトリの名前が渡されない場合、URLの最後の部分に基づいてディレクトリが作成されます。
	78	ドライブ名 (M:/) とSFTPのURLを示すそれぞれの例は次のとおりです::
	79
	80	bzr branch M:/cool-trunk
	81	bzr branch sftp://bill@mary-laptop/cool-repo/cool-trunk
	82
	83	新しいブランチを使うために明示的にディレクトリの名前を渡す例は次のとおりです::
	84
	85	bzr branch /home/mary/cool-repo/cool-trunk cool
	86
	87	時間とスペースへの考慮
	88	-----------------------
	89
	90	転送されるブランチのサイズとコンピュータとソースのブランチの間のネットワーク帯域と
	91	レイテンシによっては、この初期の転送は少し時間がかかります。
	92	その後の更新は変更のみが転送されるので遙かに速くなります。
	93
	94	Bazaarは最新のスナップショットではなくブランチの完全な履歴を転送することを覚えておいてください。
	95	結果として、 ``branch`` を完了させた後でネットワークから離脱しても、
	96	ブランチの履歴に対して ``log`` と ``diff`` を好きなだけ行うことができます。
	97	さらに、履歴がローカルで保存されているのでこれらのオペレーションは速いです。
	98
	99	Bazaarはバージョンの履歴を保存するために求められるディスクスペースの総量を\
	100	最小限にするスマートな圧縮技術を使うことに注意してください。
	101	多くの場合、プロジェクトの完全な履歴は最新バージョンの作業コピーよりも少ない\
	102	ディスクスペースを占めます。
	103
	104	後の章で説明するように、Bazaarはブランチの軽量チェックアウト、
	105	すなわち履歴のローカルなストレージなしの作業ツリーもサポートします。
	106	もちろん、接続しない使い方は利用できませんが、ローカルディスクスペースが\
	107	本当に厳しいのであればそれはあなたが決めることができるトレードオフです。
	108	現在、制限された履歴の振り返りのためのサポート - 履歴の水平線(history horizon) -
	109	は開発段階にあります。
	110
	111	ブランチの情報を閲覧する
	112	-------------------------
113
114	配布元も含むブランチの情報を見たいのであれば、 ``info`` コマンドを使います::
115
116	bzr info cool
117
118	ブランチが引数として渡されなければ、現在のブランチの情報が表示されます。