← Back to branch summary

~bzr/ubuntu/lucid/bzr/beta-ppa

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2010-07-02 07:29:40 UTC
  • mfrom: (129.1.7 packaging-karmic)
  • Revision ID: mbp@sourcefrog.net-20100702072940-hpzq5elg8wjve8rh
http://bugs.debian.org/452024
http://bugs.debian.org/464688
http://bugs.debian.org/523595
http://bugs.debian.org/526233
http://bugs.debian.org/537708
http://bugs.debian.org/555336
http://bugs.debian.org/555343
https://launchpad.net/bugs/249452
https://launchpad.net/bugs/385074
* PPA rebuild.
* PPA rebuild for Karmic.
* PPA rebuild for Jaunty.
* PPA rebuild for Hardy.
* From postinst, actually remove the example bash completion scripts.
  (LP: #249452)
* New upstream release.
* New upstream release.
* New upstream release.
* Revert change to Build-depends: Dapper does not have python-central.
  Should be python-support..
* Target ppa..
* Target ppa..
* Target ppa..
* Target ppa..
* New upstream release.
* Switch to dpkg-source 3.0 (quilt) format.
* Bump standards version to 3.8.4.
* Remove embedded copy of python-configobj. Closes: #555336
* Remove embedded copy of python-elementtree. Closes: #555343
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* debian/control: Fix obsolete-relation-form-in-source
  lintian warning. 
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split out docs into bzr-doc package.
* New upstream release.
* Added John Francesco Ferlito to Uploaders.
* Fix install path to quick-reference guide
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again, again.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to path changes.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Bump standards version to 3.8.3.
* Remove unused patch system.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix copy and paste tab error in .install file
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
 + Fixes compatibility with Python 2.4. Closes: #537708
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream version.
* Bump standards version to 3.8.2.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add python-pyrex to build-deps to ensure C extensions are always build.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix API compatibility version. (Closes: #526233)
* New upstream release.
  + Fixes default format for upgrade command. (Closes: #464688)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add missing dependency on zlib development library. (Closes:
  #523595)
* Add zlib build-depends.
* Add zlib build-depends.
* Add zlib build-depends.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Move to section vcs.
* Bump standards version to 3.8.1.
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Recommend ca-certificates. (Closes: #452024)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Update watch file. bazaar now uses launchpad to host its sources.
* Remove patch for inventory root revision copy, applied upstream.
* New upstream release.
* New upstream release.
* New upstream release
* Force removal of files installed in error to /etc/bash_completion.d/
  (LP: #249452)
* New upstream release.
* New upstream release
* New upstream release.
* Bump standards version.
* Include patch for inventory root revision copy, required for bzr-svn.
* New upstream release.
* Remove unused lintian overrides.
* Correct the package version not to be native.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Final 1.5 release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add myself as a co-maintainer.
* Add a Dm-Upload-Allowed: yes header.
* New upstream bugfix release.
* New upstream release.
* Final 1.3 release.
* New upstream release.
* First release candidate of the upcoming 1.3 release.
* Rebuild to fix the problem caused by a build with a broken python-central.
* New upstream release.
* Rebuild for dapper PPA.
* Apply Lamont's patches to fix build-dependencies on dapper.
  (See: https://bugs.launchpad.net/bzr/+bug/189915)

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://bazaar-vcs.org/BzrPlugins ページでプラグインのリストが見つかります。
 
30
 
 
31
プラグインをインストールする方法
 
32
---------------------------------
 
33
 
 
34
プラグインのインストール作業はとても簡単です！　まだ作られていなければ、
 
35
Bazaarの設定ディレクトリの元で ``plugins`` ディレクトリを作ります。
 
36
Linuxの場合は ``~/.bazaar/`` でWindowsの場合は
 
37
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\`` です。
 
38
このディレクトリの範囲内では(下記では$BZR_HOMEとして言及される) それぞれのプラグインは独自のサブディレクトリに設置されます。
 
39
 
 
40
プラグインはとりわけBazaarのブランチとよく連携します。
 
41
たとえば、Linuxのメインのユーザーアカウント用にbzrtoolsプラグインをインストールするためには、次のコマンドを実行します::
 
42
 
 
43
    bzr branch http://panoramicfeedback.com/opensource/bzr/bzrtools
 
44
    ~/.bazaar/plugins/bzrtools
 
45
 
 
46
プラグインをインストールするディレクトリの名前はPythonの有効な識別子でなければなりません。
 
47
このことはディレクトリは特定の文字だけを含まなければならないことを意味します。とりわけハイフン (``-``) を含んではなりません。
 
48
``bzr-gtk`` を ``$BZR_HOME/plugins/bzr-gtk`` にインストールするよりも、 ``$BZR_HOME/plugins/gtk`` にインストールします。
 
49
 
 
50
プラグインの代替用の場所
 
51
-------------------------
 
52
 
 
53
必要なパーミッションがあれば、プラグインをシステム全体のベースにインストールすることもできます。
 
54
現在2つの場所がプラグインのためにチェックされます:
 
55
 
 
56
 1. システムの場所 - bzrlib/plugins
 
57
 2. 個人の場所 - $BZR_HOME/plugins.
 
58
 
 
59
Linuxにおいて、これらの典型的な場所は
 
60
``/usr/lib/python2.4/site-packages/bzrlib/plugins/`` と
 
61
``$HOME/.bazaar/plugins/`` です。
 
62
Windowsにおいて、システムの場所は
 
63
``C:\\Program Files\\Bazaar\\plugins`` になり、
 
64
個人の場所は ``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\plugins`` です。
 
65
 
 
66
環境変数 ``BZR_PLUGIN_PATH`` をプラグインが含まれるディレクトリに設定することで\個人のプラグインの場所を上書きできます。
 
67
 
 
68
 
 
69
インストールされたプラグインの一覧を表示する
 
70
---------------------------------------------
 
71
 
 
72
これを行うためには、次のようにpluginsコマンドを使います::
 
73
 
 
74
    bzr plugins
 
75
 
 
76
それぞれのプラグインの名前、場所とバージョンが表示されます。
 
77
 
 
78
プラグインによって追加された新しいコマンドは ``bzr help commands`` を実行することで見ることができます。
 
79
プラグインによって提供されたコマンドはブラケットの中のプラグインの名前に従って表示されます。
 
80
 
 
81
人気のあるプラグイン
 
82
--------------------
 
83
 
 
84
次の表は人気のあるプラグインのサンプルです。
 
85
 
 
86
  ================ ================= ==================================
 
87
  カテゴリ         名前              説明
 
88
  ================ ================= ==================================
 
89
  GUI              QBzr              QtベースのGUIツール
 
90
  GUI              bzr-gtk           GTKベースのGUIツール
 
91
  GUI              bzr-eclipse       Eclipseとの統合
 
92
  General          bzrtools          その他。shelfを含めた機能の強化
 
93
  General          difftools         外部の差分ツールヘルパー
 
94
  General          extmerge          外部のマージツールヘルパー
 
95
  Integration      bzr-svn           Subversionをリポジトリとして利用する
 
96
  Migration        cvsps             CVSパッチセットを移行させる
 
97
  ================ ================= ==================================
 
98
 
 
99
あなた独自のプラグインを書きたい場合、難しいことではありません。
 
100
始めるためには付録の `プラグインを書く <writing_a_plugin.html>`_
 
101
の項目をご覧ください。