安装与使用 Trac 来管理项目

1. 安装 Python 2.7；
2. 安装 Python Setupfile；
3. 安装 Genshi，可以用下面的命令用 Setupfile 来安装。

easy_install Genshi

我的做法是先在d盘新建一个trac目录，然后执行：

$ trac-admin d:/trac/mytest initenv    

然后根据提示输入项目的名字(myproject)，数据库连接字符串（默认），你的源代码资源库路径，根据相应的提示，输入相关信息即可。

如果提示如下错误：

C:\Python27\Scripts>tracd -p 8080 e:/trac/MyTest
Traceback (most recent call last):File "C:\Python27\Scripts\tracd-script.py", line 5, in <module>from pkg_resources import load_entry_pointFile "C:\Python27\lib\site-packages\pkg_resources.py", line 2603, in <module>working_set.require(__requires__)File "C:\Python27\lib\site-packages\pkg_resources.py", line 666, in requireneeded = self.resolve(parse_requirements(requirements))File "C:\Python27\lib\site-packages\pkg_resources.py", line 565, in resolveraise DistributionNotFound(req)  # XXX put more info here
pkg_resources.DistributionNotFound: Genshi>=0.6

则表明没有安装 Genshi。

可以通过 tracd 命令来开启 Trac 服务，命令如下：

tracd --port 8000 E:\Trac\MyTest

启动成功后，即可通过网址：

http://localhost:8000/MyTest

来访问相关的 Trac 服务，这时即访问 MyTest 这个工程。

其它机器也可以通过访问这台机器的 IP 加端口来访问这个服务。最基本、最简单的使用，可以不用 Apache 来搭建 Web 服务器。

刚安装好的 Trac，并没有提供一个用户注册面板，也没有设置管理员权限，这个时候，我们需要自己来添加用户。

这一点经常让我这种习惯了用其它管理系统的人摸不着头脑，系统怎么没有让我设置相关的管理员用户名和密码呢？

最简单的方法是这样的：

直接用 Generating Passwords Without Apache 里提到的方法：

$ python trac-digest.py -u username -p password >> c:\digest.txt
$ tracd --port 8000 --auth=proj_name,c:\digest.txt,trac c:\path\to\proj_name

直接就可以把 username 添加到某个工程里，并可以登陆了。

单纯把某个用户添加到了工程里，并不能让这个用户有管理工程的权限，所以，需要单独分配权限给这个用户：

比如说，我要分本给 admn 这个用户管理员权限，可以用下面的语句：

$ trac-admin /path/to/projenv permission add admin TRAC_ADMIN

现在重启一下 Trac 服务器，你再用 admin 登陆，就可以看到右边有一个 Admin 的控制面板了。

最好的办法，你给不同的 projects，添加不同的用户名，为不同的 project，开启不同的端口，这样就不会相互影响了。

• 不让匿名用户看到任何内容

  出于对工作及公司的安全性考虑，我们完全有理由不让匿名用户看到 Trac 里的任何内容。

  只需要在管理面板 Admin ==> General ==> Permissions 里，把 Subject 为 anonymous 的相应权限全部去掉即可。

CANNOT INCLUDE FILE ../addon/ads-bar.org

用第4种方法开启的服务，只能在本机使用，如果需要让一个团队都能访问的话，需要开启一个 Apache 服务器。

http://trac.edgewall.org/wiki/TracInstall#RunningTraconaWebServer

1. 先安装一个 Trac Account Manager Plugin 工具

   可以直接用 easy_install 来安装

2. 重启服务器，在 Plugins 里开启本功能即可。

   注意一定要像图中一样，开启那个右上角的 1 字符。

realm 的用处是区分这个用户名属于哪里的，现在这样，很容易地区分出来。和之前 tracd 命令启动时带的参数一样。

还可以针对不同的工程，设定不同的密码文件，这样可以有效地隔离不相干人群。

使用这个还有一个需要注意的，就是，公司内部使用的话，可以把烦人的 Email Verification 关掉。

用 Gmail 的话，可查看这篇日志，有关如何设置用 Gmail 来发提醒邮件的功能。

默认情况下，Trac 需要你在分 Ticket 时，自己填空。在项目人员过多的情况下，这显示是不现实的办法。

还好，可以使用 AutocompleteUsersPlugin 这个来自动补全与提示，使用后感觉不错。

可以导出数据为 CSV 或 Text 格式：

Trac also exports reports and custom queries to CSV, which will open in Excel directly. Click the "Comma-delimited Text" link near the bottom.

对于 Trac 这种团队用的东西，备份是非常重要的。成一数据丢了，项目也就完蛋了。

Trac 支持热备份，可以很方便地用下面的命令来对某个工程进行备份：

$ trac-admin /path/to/projenv hotcopy /path/to/backupdir

注意，这个只能是对工程一个一个的进行备份，其实就是把 Trac 工程的所有文件都打了一个包。

所以，为了备份简单，应该要把密码文件也放到 projenv 的目录里，这样备份起来，会一起把用户名和密码文件打包的。

只要备份完全，你完全可以在别外一台机器上，在另一台机器上配置好 Python 环境，再安装好 Trac ，再把这些备份的文件，扔到一个运行目录里，再用同样的命令就可以直接把该 project 跑起来了。

非常便利！

默认的 Trac 主题并不算十分好看，这里有大把主题可以换：

http://trac-hacks.org/wiki/theme

可以通过这个博客系统及时通知团队有什么新的更新内容之类的。

安装插件：Self-contained Blog plugin

对于 Linux 系统来说，需要添加一个开机启动程序，还是很简单的。可以使用 /etc/init.d 目录下的脚本来完成这个任务。

详细的脚本可以参考这个文章：Start Trac on Startup – Init.d Script for tracd

注意修改里面的 IP、端口以及目录参数。我这里好像把IP设置成 127.0.0.1 好像并不能让别人访问，所以还是设成你电脑的正式 IP 比较好。或是有一个技巧，在这里直接把 IP 设为 0.0.0.0。

有了这个脚本，你只需要用如下命令重启 tracd 服务器即可：

$ sudo /etc/init.d/trac start
$ sudo /etc/init.d/trac stop

如果是在 Windows 下，则有三种选择来让它开机启动。我喜欢用 cygwin 的 cygrunsrv.exe 来安装该服务。例如，如果我 Windows 本地的 Trac 启动命令是：

tracd --port 8999 --auth=All-in-Trac,E:\water\Basket\Trac\All-in-Trac\conf\password.digest,trac E:\water\Basket\Trac\All-in-Trac

则在 Cygwin 里可用如下命令来把 tracd 注册成 Windows 系统服务：

cygrunsrv --install tracd --path /cygdrive/c/Python27/Scripts/tracd.exe --args '--port 8999 --auth=All-in-Trac,E:\water\Basket\Trac\All-in-Trac\conf\password.digest,trac E:\water\Basket\Trac\All-in-Trac'