|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
1 |
プラグインを利用する |
2 |
===================== |
|
3 |
||
4 |
.. Information on how to use plugins in Bazaar. |
|
5 |
||
6 |
プラグインとは？ |
|
7 |
----------------- |
|
8 |
||
9 |
プラグインは主にサードパーティによって作られたBazaarのための外部コンポーネントです。 |
|
10 |
プラグインは新しい機能を追加することでBazaarを補強する能力があります。 |
|
11 |
プラグインは現在の機能を置き換えることでBazaarのふるまいを変更することもできます。 |
|
12 |
プラグインのサンプルのアプリケーションは次のとおりです: |
|
13 |
||
14 |
* コマンドをオーバーライドする |
|
15 |
* 新しいコマンドを追加する |
|
16 |
* 追加のネットワーク転送機能を提供する |
|
17 |
* ログの出力をカスタマイズする |
|
18 |
||
19 |
プラグインを通してできるカスタマイズの可能性は際限がありません。 |
|
20 |
実際、開発者が新しい機能を公式のコードベースに含める前にテストするための方法としてプラグインは機能します。 |
|
21 |
プラグインは機能の引退時でも同様に役立ちます。たとえば廃止されたファイルのフォーマットがある日Bazaarのコアから除外されるかもしれませんが\ |
|
22 |
代わりにプラグインとして利用できます。 |
|
23 |
||
24 |
プラグインはユーザーにとって、外部の開発者にとっても、Bazaar自身にもよいものです。 |
|
25 |
||
26 |
プラグインが見つかる場所 |
|
27 |
------------------------- |
|
28 |
||
|
5875.1.1
by INADA Naoki
Update Japanese docs. |
29 |
http://wiki.bazaar.canonical.com/BzrPlugins ページで |
30 |
プラグインのリストが見つかります。 |
|
|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
31 |
|
32 |
プラグインをインストールする方法 |
|
33 |
--------------------------------- |
|
34 |
||
35 |
プラグインのインストール作業はとても簡単です！ まだ作られていなければ、 |
|
36 |
Bazaarの設定ディレクトリの元で ``plugins`` ディレクトリを作ります。 |
|
|
5875.1.1
by INADA Naoki
Update Japanese docs. |
37 |
Unix の場合は ``~/.bazaar/`` でWindowsの場合は |
|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
38 |
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\`` です。 |
39 |
このディレクトリの範囲内では(下記では$BZR_HOMEとして言及される) それぞれのプラグインは独自のサブディレクトリに設置されます。 |
|
40 |
||
41 |
プラグインはとりわけBazaarのブランチとよく連携します。 |
|
|
5875.1.1
by INADA Naoki
Update Japanese docs. |
42 |
たとえば、 GNU/Linux のメインのユーザーアカウント用に bzrtools |
43 |
プラグインをインストールするためには、次のコマンドを実行します:: |
|
|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
44 |
|
45 |
bzr branch http://panoramicfeedback.com/opensource/bzr/bzrtools |
|
46 |
~/.bazaar/plugins/bzrtools |
|
47 |
||
48 |
プラグインをインストールするディレクトリの名前はPythonの有効な識別子でなければなりません。 |
|
49 |
このことはディレクトリは特定の文字だけを含まなければならないことを意味します。とりわけハイフン (``-``) を含んではなりません。 |
|
50 |
``bzr-gtk`` を ``$BZR_HOME/plugins/bzr-gtk`` にインストールするよりも、 ``$BZR_HOME/plugins/gtk`` にインストールします。 |
|
51 |
||
52 |
プラグインの代替用の場所 |
|
53 |
------------------------- |
|
54 |
||
|
5875.1.1
by INADA Naoki
Update Japanese docs. |
55 |
必要なパーミッションがあれば、プラグインをシステム全体のベースに |
56 |
インストールすることもできます。 |
|
57 |
||
58 |
環境変数 ``BZR_PLUGIN_PATH`` をプラグインが含まれるディレクトリに |
|
59 |
設定することで個人のプラグインの場所を上書きできます。 |
|
60 |
(詳細な解説は |
|
61 |
`ユーザーリファレンス <../user-reference/configuration-help.html#bzr-plugin-path>`_ |
|
62 |
を参照してください。) |
|
|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
63 |
|
64 |
||
65 |
インストールされたプラグインの一覧を表示する |
|
66 |
--------------------------------------------- |
|
67 |
||
68 |
これを行うためには、次のようにpluginsコマンドを使います:: |
|
69 |
||
70 |
bzr plugins |
|
71 |
||
72 |
それぞれのプラグインの名前、場所とバージョンが表示されます。 |
|
73 |
||
74 |
プラグインによって追加された新しいコマンドは ``bzr help commands`` を実行することで見ることができます。 |
|
75 |
プラグインによって提供されたコマンドはブラケットの中のプラグインの名前に従って表示されます。 |
|
76 |
||
77 |
人気のあるプラグイン |
|
78 |
-------------------- |
|
79 |
||
80 |
次の表は人気のあるプラグインのサンプルです。 |
|
81 |
||
82 |
================ ================= ================================== |
|
83 |
カテゴリ 名前 説明 |
|
84 |
================ ================= ================================== |
|
85 |
GUI QBzr QtベースのGUIツール |
|
86 |
GUI bzr-gtk GTKベースのGUIツール |
|
87 |
GUI bzr-eclipse Eclipseとの統合 |
|
88 |
General bzrtools その他。shelfを含めた機能の強化 |
|
89 |
General difftools 外部の差分ツールヘルパー |
|
90 |
General extmerge 外部のマージツールヘルパー |
|
91 |
Integration bzr-svn Subversionをリポジトリとして利用する |
|
92 |
Migration cvsps CVSパッチセットを移行させる |
|
93 |
================ ================= ================================== |
|
94 |
||
95 |
あなた独自のプラグインを書きたい場合、難しいことではありません。 |
|
96 |
始めるためには付録の `プラグインを書く <writing_a_plugin.html>`_ |
|
97 |
の項目をご覧ください。 |