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的翻译。
Trac系列(4):了解trac-admin
最新推荐文章于 2024-03-12 11:17:12 发布