Changes between Version 1 and Version 2 of TracAdmin


Ignore:
Timestamp:
May 13, 2012, 9:15:45 PM (13 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracAdmin

    v1 v2  
    1 = 管理ツール =
     1= 管理ツール = #TracAdmin
    22[[TracGuideToc]]
    33
    44Trac は強力なコマンドラインの管理ツールとともに配布されています。このツールで Trac を管理/設定し、インストールを用途に合わせてカスタマイズすることができます。
    55
    6 オプショナルの [http://trac.edgewall.org/wiki/WebAdmin WebAdmin] プラグインのおかげで、trac-admin で行う操作の中のいくつかは web インタフェースで設定できます。今のところは Trac 本体とは別に配布されています。
     6ここに挙げる操作の一部は ''管理'' (英語版では ''Admin'') Web インタフェースでも実行することができます。バージョン 0.11 以降で [http://trac.edgewall.org/wiki/WebAdmin WebAdmin] プラグインは Trac 本体に統合されました。
    77
    8 == 使い方 ==
     8== 使い方 == #Usage
    99
    10 `trac-admin` コマンドを `help` オプションつきで起動することによって、利用できるコマンド/サブコマンドの分かりやすいオプションリストを見ることができます:
    11 {{{
    12 trac-admin help
    13 }}}
    14 
    15 `help`, `about`, `version` のサブコマンドを実行しないならば、第1引数に管理したい TracEnvironment へのパスを指定する必要があります。例えば:
     10ほぼ全ての `trac-admin` コマンドにおいて、以下の例に示す通り、第1引数には管理対象とする TracEnvironment のパスを指定する必要があります:
    1611{{{
    1712trac-admin /path/to/projenv wiki list
    1813}}}
    1914
    20 == 対話モード ==
     15唯一の例外は `help` コマンドで、 Environment を指定しない場合でも動作し、使用できるコマンドの簡易なリスト (`help` や `initenv` のような) を表示します。同じリストは、引数を指定せずに `trac-admin` コマンドを使用した場合も表示されます。
     16また `trac-admin --version` を使用すると (0.12 のような形式の) Trac のバージョンを表示します。
     17
     18使用できるコマンドやサブコマンドの完全なリストを取得したい場合は、 Environment のパスを指定してください:
     19{{{
     20trac-admin /path/to/projenv help
     21}}}
     22
     23一部のコマンドでは、 `help` のサブコマンドとしてコマンド名を指定することで、より詳細なヘルプをみることができます:
     24
     25{{{
     26trac-admin /path/to/projenv help <command>
     27}}}
     28
     29=== `trac-admin <targetdir> initenv` === #initenv
     30
     31このサブコマンドは、指定された `<targetdir>` に TracEnvironment を作成する、とても重要なコマンドです。対象のディレクトリが実行時に存在するとエラーになります。
     32
     33[[TracAdminHelp(initenv)]]
     34
     35`--inherit` オプションを使用すると、グローバルな設定ファイルを指定することができます。このファイルは複数の Environment 間で共有されます。共有する設定ファイルを後から設定したい場合は、 Environment に含まれる `conf/trac.ini` ファイルに `[inherit] file` オプションを設定してください。 Environment 作成時のオプションでグローバルな設定ファイルを指定すると、自動的に `conf/trac.ini` ファイルにオプションが記載され、重複するオプションについては作成時に設定する必要がなくなるというメリットがあります。
     36詳細は [TracIni#GlobalConfiguration TracIni#グローバルな設定] を参照してください。
     37
     38Note: Trac のバージョン 0.11 では `initenv` の最終引数 `<templatepath>` が廃止されました。この引数は以前のバージョンでは `templates` ディレクトリの場所を指定するのに使用されていました。現在のコマンドはワンライナーでは '`trac-admin /path/to/trac/ initenv <projectname> <db> <repostype> <repospath>`' となるので、以前と同じ引数で起動すると ''''`Wrong number of arguments to initenv: 4`'''' というエラーが発生します。このエラーが発生した場合、 '''古い''' バージョンの Trac に同梱されている `trac-admin` スクリプトが動いていると考えられます。
     39
     40== 対話モード == #InteractiveMode
    2141
    2242`trac-admin` は TracEnvironment のパスだけを引数に指定して起動した場合、対話モードになります。
    … …  
    3151}}}
    3252
    33 Wiki に関するすべてのコマンドのヘルプを得るためには以下のように実行します:
     53Wiki に関するすべてのコマンドのヘルプを得るためには、以下のように実行します:
    3454{{{
    3555> help wiki
    3656}}}
    3757
     58== 完全なコマンドリファレンス == #FullCommandReference
     59
     60以下に示すのは `trac-admin` で標準的に使用できる全てのコマンドの詳細なヘルプです。 `trac-admin <yourenv> help` で表示されるリストとは一致しないこともありますが、 Environment で無効化されているコンポーネントに由来するコマンドは表示されず、逆に  Environment で有効化されているプラグインによって提供されるコマンドが別途表示されるためです。
     61
     62[[TracAdminHelp()]]
     63
    3864----
    39 See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni
     65See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni, [http://trac.edgewall.org/wiki/TracMigrate TracMigrate]