Trac系列(4)：了解trac-admin

trac-admin是Trac中一个功能强大的命令行配置工具，这个工具可以配置和自定义trac，满足用户的需求。

trac-admin中的一些功能可以通过WebAdmin这个trac插件，在web界面上完成，当然，这是插件是可选的，在以后会说说它。虽然WebAdmin可以完成trac-admin的大部分功能，而且

跟方便，但了解下trac-admin的行命令操作还是有必要的。有个好消息是，在trac 0.11版本中，内置了WebAdmin，不用装插件了。

调用trac-admin help可以查看trac-admin的选项、命令、子命令列表
C:\Python24\Scripts>..\python trac-admin help

trac-admin用法: trac-admin </path/to/projenv> [command [subcommand] [option ...]]

除了执行help，about或者version子命令，不需要指定trac环境的路径（也就是/path/to/projenv）外，其他的子命令都需要将trac环境的路径作为第一个参数。比如
trac-admin /path/to/projenv wiki list

当调用trac-admin，只传递了环境路径参数，没有指定命令和子命令时，trac-admin将启动交互模式，我们可以根据每一步的提示输入命令执行。在交互模式下，也可以获取指定

命令或子命令的帮助，例如
> help resync
获取‘resync’命令的说明
> help wiki
获取所有和Wiki相关的命令集的说明

命令索引：
about
    -- 显示trac-admin的关于信息

help
    -- 显示帮助信息

initenv
    -- 在交互模式下，创建并初始化一个新的trac环境

initenv <projectname> <db> <repostype> <repospath> <templatepath>
    -- 使用指定的参数创建和初始化一个新的trac环境

hotcopy <backupdir>
    -- 生成trac环境的热拷贝（hot backup copy）

resync
    -- 同步trac环境和版本仓库

resync <rev>
    -- Re-synchronize only the given <rev>

upgrade
    -- 升级数据库到当前版本

wiki list
    -- 列出所有的wiki页面

wiki remove <name>
    -- 删除指定名称wiki页面

wiki export <page> [file]
    -- 导出wiki页面到指定的文件或标准输出

wiki import <page> [file]
    -- 从文件或标准输入中导入wiki页面

wiki dump <directory>
    -- 导出所有的wiki页面到指定的目录

wiki load <directory>
    -- 从指定的目录中导入wiki页面

wiki upgrade
    -- 升级默认wiki页面到当前版本

permission list [user]
    -- 列出所有的权限或指定用户的权限

permission add <user> <action> [action] [...]
    -- 向指定用户添加新的权限

permission remove <user> <action> [action] [...]
    -- 取消指定用户的权限

component list
    -- 显示可利用的模块

component add <name> <owner>
    -- 添加一个新的模块

component rename <name> <newname>
    -- 重命名指定的模块
component remove <name>
    -- 移除指定的模块

component chown <name> <owner>
    -- 改变模块拥有者

ticket remove <number>
    -- 删除ticket

ticket_type list
    -- 显示所有可利用的ticket类型

ticket_type add <value>
    -- 添加一个ticket类型

ticket_type change <value> <newvalue>
    -- 改变指定的ticket类型

ticket_type remove <value>
    -- 移除指定的ticket类型

ticket_type order <value> up|down
    -- 向上或向下移动指定的ticket类型在类型列表中的位置

priority list
    -- 显示所有可利用的ticket优先级

priority add <value>
    -- 添加优先级

priority change <value> <newvalue>
    -- 重命名优先级

priority remove <value>
    -- 移除优先级

priority order <value> up|down
    -- 向上或向下移动指定的ticket优先级在列表中的位置

severity list
    -- 显示所有可能的严重度

severity add <value>
    -- 添加严重度

severity change <value> <newvalue>
    -- 重命名严重度

severity remove <value>
    -- 移除严重度

severity order <value> up|down
    -- 向上或向下移动指定的ticket严重度在列表中的位置

version list
    -- 显示所有可利用的版本

version add <name> [time]
    -- 添加版本

version rename <name> <newname>
    -- 重命名版本

version time <name> <time>
    -- 设定指定版本的日期(格式: "YYYY-MM-DD" or "now")

version remove <name>
    -- 移除版本

milestone list
    -- 显示所有可利用的里程碑

milestone add <name> [due]
    -- 添加里程碑

milestone rename <name> <newname>
    -- 重命名里程碑

milestone due <name> <due>
    -- 设定指定里程碑的到期日期 (格式: "YYYY-MM-DD" or "now")

milestone completed <name> <completed>
    -- 设定指定里程碑的完成日期 (格式: "YYYY-MM-DD" or "now")

milestone remove <name>
    -- 移除里程碑

参考文献：
       Trac的官方指南，本文基本上是其中的TracAdmin的翻译。