← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/ja/user-guide/plugins.txt

  • Committer: Robert Collins
  • Date: 2007-11-18 19:56:39 UTC
  • mfrom: (3006 +trunk)
  • mto: This revision was merged to the branch mainline in revision 3038.
  • Revision ID: robertc@robertcollins.net-20071118195639-m6zf3d5ljjw88kkn
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/plugins.txt
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
 
 
29
 
http://wiki.bazaar.canonical.com/BzrPlugins ページで
30
 
プラグインのリストが見つかります。
31
 
 
32
 
プラグインをインストールする方法
33
 
---------------------------------
34
 
 
35
 
プラグインのインストール作業はとても簡単です！　まだ作られていなければ、
36
 
Bazaarの設定ディレクトリの元で ``plugins`` ディレクトリを作ります。
37
 
Unix の場合は ``~/.bazaar/`` でWindowsの場合は
38
 
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\`` です。
39
 
このディレクトリの範囲内では(下記では$BZR_HOMEとして言及される) それぞれのプラグインは独自のサブディレクトリに設置されます。
40
 
 
41
 
プラグインはとりわけBazaarのブランチとよく連携します。
42
 
たとえば、 GNU/Linux のメインのユーザーアカウント用に bzrtools
43
 
プラグインをインストールするためには、次のコマンドを実行します::
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
 
 
55
 
必要なパーミッションがあれば、プラグインをシステム全体のベースに
56
 
インストールすることもできます。
57
 
 
58
 
環境変数 ``BZR_PLUGIN_PATH`` をプラグインが含まれるディレクトリに
59
 
設定することで個人のプラグインの場所を上書きできます。
60
 
(詳細な解説は
61
 
`ユーザーリファレンス <../user-reference/configuration-help.html#bzr-plugin-path>`_ 
62
 
を参照してください。)
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
 
の項目をご覧ください。