Trac系列(1)：Windows下Trac的安裝與基本配置

Windows下Trac的安裝與基本配置
        Trac是一個基於Web的，輕量級的項目管理工具，它使用python語言編寫。在本文中，將介紹windows下安裝、集成配置一個簡單的Trac環境，並通過瀏覽器訪問和使用Trac站點。Trac環境中，默認的版本控制工具是Subversion，在這裏我假定大家已經安裝和部署了SVN倉庫。

安裝前要說的
1. 關於本文中Trac的版本  
        Trac目前最新的Release版本是0.10.4版本，0.11版本正在開發。本文針對的是0.10.4版本，0.11版本做了大量的更新，使用了新的模板，並集成了配置工具，預計近期發佈，但目前的成熟度還不高，建議大家使用0.10.4版本。
2. 必須的組件
        Python，版本 >= 2.3。目前最新版本是2.5，因爲Trac 0.10.x是在2.4版本下開發的，並且2.5版本是新發布的，在Trac的官方文檔中也說在Python2.5環境下使用0.10.x理論上可以工作，爲了避免不必要的麻煩，建議大家使用2.4版本，本文就以2.4版來介紹。
       ClearSilver，版本 >= 0.9.3，目前最新版是0.10.4（注意，0.10.4版本需要Python2.5）。這是一套快速、強大、語言無關的html模板系統，在Trac0.11版本中被Genshi取代。
       數據庫，Trac需要一個數據庫來集中存放數據，目前支持的數據庫包括SQLite，PostgreSQL和MySQL。默認使用SQLite，我個人非常喜歡SQLite這個小東西，功能夠用，部署方便，配置簡單（簡單到不需要配置），對於小團隊完全夠用。本文就使用SQLite，如果使用其他的數據庫，請參照Trac官方文檔。SQLite需要3.3.4版本或以上。
       使用SQLite，必須安裝 PySQLite, 需要版本2.x。
3. 可選的組件
       版本控制系統，Trac功能上的一個亮點就是和版本控制工具的集成，默認使用Subversion，本文使用Subversion。但是從本質上講，版本控制系統，並不是Trac所必須的，只是集成了版本控制系統，使Trac更強大，這也是爲什麼Subversion是可選組件的原因。使用Subversion還需要相應的Python綁定(the corresponding Python bindings)。
       Web服務器，在支持CGI或FastCGI的Web服務器上，Trac可以通過腳本和接口作爲一個CGI來運行。還可以使用Apache服務器，但需要安裝mod_python或mod_wsgi。以上的Web服務器部署方式，可能對大部分人都太複雜，所以Trac內置了一個單獨運行的Web服務器，Tracd。在Trac官方的文檔中說，Tracd是一個輕量級的、獨立的Trac web服務器，在大多數情況下，它比CGI腳本更容易安裝，並且更快。在本文中，我將使用Tracd作爲Web服務器。（我不懂CGI和Apache，Tracd拯救了我，這個小東東對我完全夠用了）

開始安裝
1. 下載程序
        根據上面所說，我下載的程序包括
        Python 2.4：http://www.python.org/ftp/python/2.4.4/python-2.4.4.msi
        Trac 0.10.4：http://ftp.edgewall.com/pub/trac/trac-0.10.4.win32.exe
        ClearSilver 0.9.14（我只找到了這個版本的安裝包，其他版本都是源碼，我不會安裝，抱歉）：http://www.clearsilver.net/downloads/win32/clearsilver-0.9.14.win32-py2.4.exe
        SQLite：不用下載，就一個文件而已，Trac裏面已經包含了。
        pysqlite 2.3.4（注意，使用for Python2.4的版本）：http://initd.org/pub/software/pysqlite/releases/2.3/2.3.4/pysqlite-2.3.4.win32-py2.4.exe
        Subversion：需要注意，Trac需要python綁定。如果你已經安裝了Subversion，沒有python綁定，可以下載單獨的python綁定，並安裝，具體在http://subversion.tigris.org/files/documents/15/38210/svn-win32-1.4.4_py24.zip。也可以卸載subversion，安裝subversion的python綁定安裝包，在http://subversion.tigris.org/files/documents/15/38216/svn-python-1.4.4.win32-py2.4.exe。如果未安裝，直接安裝綁定安裝包即可。以上都是subversion1.4.4版本

        下載時注意，請下載Windows平臺的二進制安裝包(Windows binaries)，不要下載源代碼，那個需要重新編譯，很麻煩，反正我不會。。。我給的鏈接都是安裝包，大家下載安裝即可（請首先安裝Python）。

2. 安裝
        首先安裝Python，然後其他幾個安裝程序能夠自動識別Python的安裝，從而只需要按照默認安裝即可。默認安裝目錄是C:/Python24/，在本文中我使用默認路徑安裝。

3. 給我們的項目配置Trac環境
        Trac環境就是一個存放wiki頁面、tickets、報表、設置等等信息的後臺存儲器。一個環境在windows裏就是一個目錄，包含了配置文件和其他相關的文件、目錄。
        假設，我們有個項目，代號叫Angel，現在我們爲這個項目配置Trac環境。
        爲了介紹方便，先介紹項目目錄。假定項目配置都放在/SCM/Angel/下，建立的Subversion倉庫在/SCM/Angel/SVN，我們將建立的Trac環境目錄是/SCM/Angel/Angel_Trac/。我一般將/SCM目錄放在非C盤，但這次我是在虛擬機上演示，虛擬機只有一個C盤，所以，所有的目錄在C盤裏。
        總結下，我們要使用到的目錄：
      C:/Python24/（python環境目錄），C:/SCM/Angel/SVN/（Angel項目的倉庫），C:/SCM/Angel/Angel_Trac/（Angel項目的Trac環境目錄）。

        點擊開始->運行，輸入“cmd”，確認，打開Dos命令窗口，進入Python安裝目錄下的Scripts子目錄。在我這裏是C:/Python24/Scripts/。我們要使用trac-admin來創建並初始化一個Trac環境。先看看用法
        用法: trac-admin </path/to/projenv> [command [subcommand] [option ...]]
   我們要使用的command是
   initenv
        -- Create and initialize a new environment interactively（創建和初始化一個新的環境）
  
        下面來創建和初始化Angel項目的Trac環境，如下圖，綠色不分是我們輸入的命令，黃色部分是我們在Dos窗口中需要交互的地方，白色窗口中給出了相應的解釋。

Ok，我們在C:/SCM/Angel/Angel_Trac/建立了Trac環境，下面就是用tracd建立web站點，通過瀏覽器訪問了。看圖說話

現在，我們就使用tracd建立了項目的web站點，可以在瀏覽器中打開如下的網址進行訪問
http://（trac環境所在的機器名或者ip地址）:tracd使用的端口
比如，本例中使用的http://127.0.0.1:8001
注意，在此期間不要關閉tracd運行的窗口，因爲關閉了窗口，tracd就停止運行了。難道我們需要一直開着tracd窗口嗎？目前是的。但後面我會講到將tracd封裝成windows服務。
瀏覽器訪問圖片如下

上圖中的“歡迎訪問Angel項目"是我修改了wiki頁。

        ok，現在我們已經爲項目Angel配置了Trac環境，並啓動了web站點。今後，我們就可以使用瀏覽器來訪問它了，可以使用ticket、roadmap、timeline，可以瀏覽subversion容器，還可以使用強大的wiki豐富我們的站點，共享知識。這些都很簡單，大家多點點，多看看就明白了。
       第一次如此認真在blog上寫技術文章，希望能讓大家看明白。如果有什麼問題，可以留言或者email我，知無不言。我也會一直寫下去的，個人覺得trac真是個好東西，希望大家從我的文章中能有所收益。
       下一部分打算寫基本使用，或是權限設置，不過可能得下週了。

參考文獻：
       Trac的官方指南，主要是其中的安裝說明。
       Subversion中文站中的一篇文章——《 Windows下安裝配置集成Trac》。