ubuntu下Trac的安装设置

Trac安装

sudo apt-get install trac

 

安装的版本为：Trac 0.11.7

 

Trac配置

sudo mkdir -p /var/www/trac/ecgoo

sudo trac-admin /var/www/trac/ecgoo/ initenv

 

 

输入项目名ecgoo后，一直按回车，则配置成功

 

测试：

tracd --port 8000 /var/www/trac/ecgoo

 

浏览器输入： http://127.0.0.1:8000/ecgoo

 

报错:

写道

TracError: The user liwei requires read _and_ write permissions to the database file /var/www/trac/ecgoo/db/trac.db and the directory it is located in.

 

 

给文件夹赋予权限： 

sudo chmod -R 777 /var/www/trac/ecgoo/db

 

 

重启后，浏览器正常显示

 

配置apache

sudo vim /etc/apache2/site-available/trac

 

添加

<VirtualHost *:80>
    ServerName mytrac
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/trac/ecgoo
    <Location />
        SetHandler mod_python
        PythonInterpreter main_interpreter
        PythonHandler trac.web.modpython_frontend
        PythonOption TracEnv /var/www/trac/ecgoo
        PythonOption TracUriRoot /
        SetEnv PYTHON_EGG_CACHE /tmp
    </Location>
    <Location /login>
        AuthType Basic
        AuthName "CMET_WZU Trac Server"
        AuthUserFile /var/www/trac/ecgoo/.htpasswd
        Require valid-user
    </Location>
 
    ErrorLog "/var/log/apache2/trac_errors.log"
    CustomLog "/var/log/apache2/trac_accesses.log" common   
</VirtualHost>

 

有个例子

Apache /etc/httpd-vhosts.conf

 23 <VirtualHost *:81>
 24     ServerAdmin [e-mail]
 25     DocumentRoot "/usr/local/www/trac"
 26     ServerName 113.108.68.161
 27     ServerAlias trac.ecgoo.net
 28 
 29     <Location /trac> #http://您的域名/trac
 30         #调试用，正式使用时屏蔽下面一行
 31         #PythonDebug on
 32         SetHandler mod_python
 33         PythonHandler trac.web.modpython_frontend
 34         PythonInterpreter main
 35         #trac项目位置,单项目配置
 36         #PythonOption TracEnv /usr/local/www/trac/projects/icgoo 
 37         # 多项目配置
 38         PythonOption TracEnvParentDir  /usr/local/www/trac/projects
 39         #PythonOption TracTemplateVars key1,val1 key2,val2
 40 
 41         PythonOption TracUriRoot /trac
 42         SetEnv PYTHON_EGG_CACHE /tmp
 43         SetEnv trac.locale zh_CN.UTF-8
 44     </Location>
 45 
 46     <LocationMatch "/trac/[^/]+/login">
 47        # 认证方式
 48        AuthType Basic
 49        AuthBasicProvider ldap
 50        #认证抬头
 51        AuthName "trac auth"
 52        # LDAP 认证
 53        AuthzLDAPAuthoritative on
 54        AuthLDAPURL "ldap://ldap.icinfo.net:389/ou=cxol,DC=icinfo,DC=net?uid"
 55        Require valid-user
 56     </LocationMatch>
 57 
 58     Alias   /trac/chrome/site  /usr/local/www/trac/htdocs/site
 59     AliasMatch /trac/[^/]+/chrome/(.*)  /usr/local/www/trac/htdocs/$1
 60     <LocationMatch "/trac/chrome">
 61         SetHandler None
 62     </LocationMatch>
 63     <LocationMatch "/trac/[^/]+/chrome">
 64         SetHandler None
 65     </LocationMatch>
 66 
 67     <Directory "/usr/local/www/trac/htdocs">
 68         AllowOverride all
 69         Order allow,deny
 70         Allow from all
 71     </Directory>
 72 
 73     ErrorLog "/var/log/dummy-host.example.com-error_log"
 74     CustomLog "/var/log/dummy-host.example.com-access_log" common
 75 </VirtualHost>

 

 

将域名mytrac指向本机，编辑 /etc/hosts 添加：

写道

127.0.0.1 mytrac

 

 

将该虚拟主机激活：

sudo a2ensite trac
sudo /etc/init.d/apache2 restart

 

 

重启时报错:

写道

... waiting Syntax error on line 6 of /etc/apache2/sites-enabled/trac:
Invalid command 'PythonInterpreter', perhaps misspelled or defined by a module not included in the server configuration

 

google了下，发现是由于没有安装mod_python

 

安装mod_python

sudo apt-get install libapache2-mod-python

 

安装后能正常重启apache

 

浏览器中输入： http://mytrac  报错

写道

[Errno 13] Permission denied: '/var/www/trac/.egg-cache'

 

又报权限错误，干脆将整个文件权限都打开

sudo chmod -R 777 /var/www/trac/

 

 

发现在文件权限上走了很多弯路,其实只要在创建项目之前给文件夹足够权限即可：

sudo chown -R www-data:www-data /var/www/trac/ecgoo

 

 

浏览器中输入： http://mytrac 显示正常

 

Trac的一些基本配置

 

配置文件 trac.ini的修改

sudo vim var/www/trac/ecgoo/conf/trac.ini

 

 

 ==== 1.logo图标的修改 ====

[header_logo]
...
#src = site/your_project_logo.png
src = http://www.ecgoo.net/sitemedia/img/logo_cn.gif
...

 

==== 2.简单汉化 ====

 

参考：http://markmail.org/message/pa4vky7rbnqwuxw4

 

由于trac 0.12自带有汉化，所以准备直接重新安装0.12版

 

官方下载： http://ftp.edgewall.com/pub/trac/Trac-0.12.2.tar.gz

 

解压后 安装

sudo python setup.py install

 

然后按照上述流程 重新配置trac

 

浏览器中正常显示，版本为trac0.12.2，默认显示为中文

 

==== 3.创建管理员 ====

 

采用apache文件认证

 

首先用Apache 提供了一个工具 htpasswd，生成用户文件

sudo htpasswd -c /var/www/trac/ecgoo/.htpasswd admin

 

 

然后创建管理员

sudo trac-admin /var/www/trac/ecgoo/ permission add admin TRAC_ADMIN

 

则用户admin拥有了管理员权限

 

==== 4.添加版本库 ====

 

首先在本地安装并配置SubVersion服务

 

本地svn服务搭建好后，配置trac

 

点左侧菜单最下面的 “版本库” ，增加一个本地的SVN版本库 /home/svn/myproject 名称为myproject

 

同步 subversion

%sudo trac-admin /var/www/trac/ecgoo repository resync "myproject"

 

 

设置subversion 的钩子： 

 

进入版本库目录 /home/svn/myproject/hooks

 

vim /home/svn/myproject/hooks/post-commit.tmpl 

 

最后添加

trac-admin /var/www/trac/ecgoo changeset add "myproject" $REV

 

 

Trac的用户手册

 

与上面以管理员身份配置Trac不同，用户手册主要说明怎么使用Trac

 

参考文档：

 

http://trac.edgewall.org/wiki/TracGuide

 

==== 1.Wiki系统 ====

 

原英文官方文档：http://trac.edgewall.org/wiki/TracWiki

 

写道

Trac系统有一个内置的wiki系统，你可以使用一个非常灵活的方式组织知识和信息，并创建包含直观的文本标记的页面 。 这个文本标记不仅可用于wiki页面 ，也可用于该系统的所有其他部分，如ticket的说明和评论， check-in log messages，里程碑式的描述(milestone ，报告描述的扩展(report descriptions)，甚至在第三方扩展中。 它允许为格式化的文本和Trac所有模块之间的超链接。

编辑维基文本是容易的，使用任何Web浏览器和简单的 格式化系统 的HTML，而不是标记语言一样复杂。 设计背后的推理是HTML，其可嵌套标签的大集合，太复杂，让快节奏的编辑和页面分散从实际内容。 需要注意的是Trac系统还支持 HTML的 ， reStructuredText的 和 纺织 作为替代标记的格式，可能最终定）用“维基”块部分页面（所谓的。

维基的主要目标是使文本更易于编辑和 鼓励 人们贡献和注释文本内容的项目。 Trac系统也提供了一个简单的文本格式工具栏，使更容易，并支持 通用编辑按钮， 您的浏览器。

同时，wiki本身并没有任何结构，而是像一摞摞的空文件，在这里您可以组织您认为合适的信息和文件，后来改写。