1. 安装介绍
第一步 下载并安装SetupTools
(1)SetupTools是一个使我们更加方便的安装和部署Python包的工具集,其下载地址为http://pypi.python.org/pypi/setuptools,在这个页面中有exe形式的安装包,直接下载安装即可
(2)安装完成后,我们会在\Python24\Scripts目录中找到一个名为easy_install.exe的文件,它是SetupTools工具集的一员,我们就是使用它完成Trac插件的安装。
第二步 下载WebAdmin
(1)WebAdmin是一个对Trac进行权限控制的插件,安装完成后可以在Trac页面中直接对权限进行控制,其下载地址为http://trac.edgewall.org/wiki/WebAdmin,页面中有许多版本,根据自己需要下载即可
NOTE: (i)Trac 0.11以后的版本会自动集成WebAdmin,只有0.11之前的版本需要手动下载安装
(ii)WebAdmin只向拥有TRAC_ADMIN权限用户开放,所以建议在安装WebAdmin之前先设置一个TRAC_ADMIN权限的用户
(2)下载后得到一个压缩包,解压得到一个*.egg的文件夹
第三步 安装
(1)拷贝刚才解压得到的*.egg文件夹,粘贴到你所要配置的Trac目录下的plugins目录,例如D:\EasyCM\trac_projs\testtrac\plugins,其中D:\EasyCM\trac_projs\testtrac\为我所要配置的Trac目录;
(2)在控制台进入\Python24\Scripts,执行easy_install D:\EasyCM\trac_projs\testtrac\plugins\TracWebAdmin-0.1.2dev_r4240-py2.4.egg;
(3)在Trac.ini文件中加上以下代码:
[components]
webadmin.* = enabled
(4)执行Trac-Admin的Upgrade命令;
(5)重启Apache;
第四步 完成
使用TRAC_ADMIN权限的用户登陆,即可看到Admin目录。
2. 使用介绍
在Admin目录中,有两个模块,分别为General和Ticket System,下面对他们进行分别介绍
General模块
(1)Basic Settings:这个目录主要用于对当前项目的基本信息进行配置,其中包括Name,URL和Description三个字段,说明项目名称,项目URL地址,以及项目的描述信息,这几个字段也可以到trac.ini文件中的project代码段进行修改;
(2)Logging:这个目录用来配置日志记录的一些参数,其中包括Type,Log Level和Log File三个字段,Type说明日志记录的类型,分为Console,File,Syslog和Windows Event Log四种,Log Level分为Debug,Info,Warning,Error和Ctitical五种,Log File用于指定日志文件的位置;
(3)Permissions:用于控制用户权限,在这个目录中,可以方便的进行用户组添加,用户添加,用户权限管理等功能;
(4)Plugins:用于管理Trac的插件,可以对插件进行删除,添加(这里可以直接添加*.egg类型的插件至本项目中,而不必再去进行控制台操作);
Ticket System模块
这个模块的功能是控制Ticket相关的属性,例如创建一个Ticket时,需要设定这个Ticket所属的Component,Milestone,Prioritie,Ticket Type和Version等,在这里便可以对这些属性进行配置。
(1)Components:这个目录的功能是管理Components,在这里可以对Components进行添加,删除和修改;
(2)Milestones:这个目录的功能是管理Milestones,在这里可以对Milestones进行添加,删除和修改;
(3)Priorities:这个目录用来管理可用的优先级别,可以新建一个优先级,设定某个优先级的级别,设定默认优先级,删除某个优先级;
(4)Ticket Types:这个目录用来管理Ticket Types,在这里可以对Ticket Types进行添加删除和修改;
(5)Versions:这个目录用来管理版本,同样可以进行添加删除和修改。
注:(i) WebAdmin的所有功能均可以通过操作TracAdmin或者修改trac.ini来实现,在附录1中列出了TracAdmin的所有命令及功能;
(ii) 对Ticket相关的某些属性的具体意义还没弄清,有待完善。
附录1
TracAdmin的所有命令及其功能
about
-- Shows information about trac-admin
help
-- Show documentation
initenv
-- Create and initialize a new environment interactively
initenv <projectname> <db> <repostype> <repospath> <templatepath>
-- Create and initialize a new environment from arguments
hotcopy <backupdir>
-- Make a hot backup copy of an environment
resync
-- Re-synchronize trac with the repository
resync <rev>
-- Re-synchronize only the given <rev>
upgrade
-- Upgrade database to current version
wiki list
-- List wiki pages
wiki remove <name>
-- Remove wiki page
wiki export <page> [file]
-- Export wiki page to file or stdout
wiki import <page> [file]
-- Import wiki page from file or stdin
wiki dump <directory>
-- Export all wiki pages to files named by title
wiki load <directory>
-- Import all wiki pages from directory
wiki upgrade
-- Upgrade default wiki pages to current version
permission list [user]
-- List permission rules
permission add <user> <action> [action] ...
-- Add a new permission rule
permission remove <user> <action> [action] ...
-- Remove permission rule
component list
-- Show available components
component add <name> <owner>
-- Add a new component
component rename <name> <newname>
-- Rename a component
component remove <name>
-- Remove/uninstall component
component chown <name> <owner>
-- Change component ownership
ticket remove <number>
-- Remove ticket
ticket_type list
-- Show possible ticket types
ticket_type add <value>
-- Add a ticket type
ticket_type change <value> <newvalue>
-- Change a ticket type
ticket_type remove <value>
-- Remove a ticket type
ticket_type order <value> up|down
-- Move a ticket type up or down in the list
priority list
-- Show possible ticket priorities
priority add <value>
-- Add a priority value option
priority change <value> <newvalue>
-- Change a priority value
priority remove <value>
-- Remove priority value
priority order <value> up|down
-- Move a priority value up or down in the list
severity list
-- Show possible ticket severities
severity add <value>
-- Add a severity value option
severity change <value> <newvalue>
-- Change a severity value
severity remove <value>
-- Remove severity value
severity order <value> up|down
-- Move a severity value up or down in the list
version list
-- Show versions
version add <name> [time]
-- Add version
version rename <name> <newname>
-- Rename version
version time <name> <time>
-- Set version date (Format: "YYYY-MM-DD" or "now")
version remove <name>
-- Remove version
milestone list
-- Show milestones
milestone add <name> [due]
-- Add milestone
milestone rename <name> <newname>
-- Rename milestone
milestone due <name> <due>
-- Set milestone due date (Format: "YYYY-MM-DD" or "now")
milestone completed <name> <completed>
-- Set milestone completed date (Format: "YYYY-MM-DD" or "now")
milestone remove <name>
-- Remove milestone