如何安裝TWiki(最新版本中文TWiki 4.0安裝)
作者:Winter
1 前言:關于TWiki
關于Wiki，大家肯定聽說了不少，TWiki只是Wiki的一種實現形式。不過在眾多的wiki版本中，
TWiki聲名遠揚，按照twiki.org的解釋是，一個靈活、強大、簡單的企業級共同協作平臺。目前著名的網絡公司
Yahoo內部的平臺就是使用的TWiki, 另外Motorola 和SAP 等國際大公司都在使用TWiki，這也是我為什么選擇TWiki的原因。
TWiki的文檔很多，也很細致，不過剛開始看還有些不習慣，文檔中所以的WikiName都加上了鏈接，有時候經常點來點去就不知道自己點到哪里去了。目前關于TWiki的中文文檔是少之又少，關于TWiki安裝文檔，更是鳳毛麟角。當然安裝TWiki并不是什么難事，不過，許多事情都是說起來容易，做起來難......
也許是因為Twiki自己是一個新生產品，因此也有一些不完善的地方，特別是版本升級的時候會有一些不兼容的地方。本文的第一版是在2005年年中寫的，一年之后，twiki升級到4了。安裝也變得有些不同，在我升級過程中，記錄了一些注意事項，供大家參考。不過還是建議大家查看TWiki網站上的文檔，那是相當的豐富。如果是安裝舊的版本，查看這兒的鏈接http://www.stlchina.org/twiki/bin/view.pl/Main/InstallWiki?rev=7
2 安裝流程
- 下載TWiki . TWiki的官方網站是twiki.org，其下載頁面是:twiki download,目前的版本是Twiki4.04。下載其安裝包：TWiki-4.0.4.tgz, 或者TWiki-4.0.4.zip。解開壓縮包以后，你會發現在目錄中有一個文件INSTALL.html文件，其中詳細告訴你如何操作。
- 配置LocalSite.cfg . 在twiki/bin目錄下，你會發現LocalSite.cfg.txt文件，里面唯一需要修改的是:$twikiLibPath ，把他改成twiki/lib的絕對路徑。如:$twikiLibPath=/home/winter/twiki/lib 。
- 配置config twiki4比以前的配置簡單多了，以前你會發現有很多變量需要你去定義，而且需要你修改后上傳。現在你可以通過web頁面進行配置。那個文件在你的twiki/bin/configure. 在你開始安裝，或者以后進行插件(plugin)的管理，都會是通過這個頁面進行。第一次安裝，你只需要設置:"General path settings"部分。看看我的配置:http://www.stlchina.org/twiki/bin/configure.pl。里面的配置很簡單，因此，不用多講......
3 設置用戶訪問權限.
Wiki本來是講究自由、協作和信任。因此在安裝后，任何人都有權限訪問、修改所有的文章。但是在網絡上，為了安全起見，還是希望有用戶認證。可以按照以下步驟實施:
- 把twiki/bin目錄下的.htaccess.txt改名為.htaccess .了解apache配置的人肯定知道這是干什么:)
- 設置
AuthUserFile /home/winter/twiki/data/.htpasswd
AuthName 'twiki'
AuthType Basic
其中AuthUserFile 是twiki/data/.htpasswd的絕對路徑。
ErrorDocument 401 http://www.stlchina.org/twiki/bin/oops.pl/TWiki/TWikiRegistration?template=oopsauth
- 這時需要把注冊頁面換成帶輸入密碼的注冊頁面: 在twiki/data/TWiki/下有TWikiRegistration.txt和TWikiRegistrationPub.txt, 用后者把前者覆蓋(cp TWikiRegistrationPub.txt TWikiRegistration.txt)
你現在測試每個頁面的'Edit'，你會發現需要輸入用戶名和密碼。如果你按照這個方式改了，發現還不行的話，那就是服務器的設置有一些問題。我在安裝的時候就遇到了這樣的問題(51.net的G型服務，開始少裝了幾個安全認證的包)
不過我在升級的時候遇到一個問題，以前的用戶名和密碼通過彈出式對話框，總是告訴我密碼無效。后來我發現twiki4提供了一個用戶登陸頁面：http://www.stlchina.org/twiki/bin/login.pl. 這樣也可以實現類似如BBS的用戶登陸。在STL中文站上面就提供這樣的鏈接, 看看左側。
如果還是遇到無法編輯的頁面，你可以看看 TWikiAccessControl , 里面列出了所有的twiki權限，管理員可以自己設置。真正的設置頁面在這里：http://www.stlchina.org/twiki/bin/view.pl/TWiki/SitePermissions
4 TWiki的有用的技巧設置
- 用戶登陸 。前面已經說了，可以通過兩種方式。
- 個性化 . 全網站的一些鏈接、圖標等個性化設置都在: TWikiPreferences 。 你可以設置你的網頁背景顏色、個性圖標、網站logo等。
- 插件管理 你可以在twiki的官方網站上找到一些有用的插件，這里是twiki4中測試用過的插件列表。下載以后，按照使用步驟安裝到你的twiki目錄，然后通過 twiki/bin/configure 進行配置。
- robots.txt 對于twiki來說，每個網頁是動態生成，對于服務器來說有很大負載，特別是在搜索引擎的spider進行抓取網頁的時候。spider會跟蹤每個鏈接，包括edit, rdiff,attach,save.......等等操作，而且這些十分消耗服務器資源，對于用戶來說沒有任何用處，還常常導致一些不必要的流量。因此需要設置robots.txt，告訴spider哪些網頁你不要抓取。在twiki安裝時就有一個默認的robots.txt, 在twiki根目錄下，你把它copy到你的網站域名的根目錄下即可。查看STL中文站的robots.txt: http://www.stlchina.org/robots.txt. 此操作可以讓你的網站負載降低到以前的20%.
- 反惡意抓取 . 個人和一些不道德的公司，經常會對你的網站進行流氓抓取(即短時間內頻繁抓取你的每個鏈接, 而且不顧robots協議), 這樣也會導致你的服務器負載過大。這時你需要一個插件：TWiki.BlackListPlugin. 我安裝兩周，過濾了15個惡意IP.
- 中文標題 這是一個很有意思的工作，TWiki默認的標題格式是：'Topic Name < Web Name < TWki Name', 如果你使用的是英文，估計還好一點，你可以是你們Topic Name包含有意義的詞。但是你的文章內容是中文，這種方式對于搜索引擎很不友好。因此如何讓標題顯示成中文，這需要一些技巧。我采用的方式是：
- 在TWiki.TWikiPreferences設置一個全局變量: $MYTITLE. 變量的設置方法查看：TWiki變量設置方法
- 修改twiki/templates中的page.pattern.tmpl 在< title>中加入 %MYTITLE％ - ％TOPIC％
- 然后在每個頁面設置自己的Title. 設置格式也需要注意，3個空格+ Set + MYTITLE = 你想要的網頁標題。看看本文設置的是：
- Set MYTITLE = 如何安裝TWiki(最新版本中文TWiki安裝 TWiki4.0)
5 其他參考
順利的安裝會有同樣的順利，而失敗的安裝卻各有各的原因。如果你仍然有問題，選擇下列途徑：
- 首先選擇參考TWiki安裝向導，
- 對于中文TWiki的安裝,當然要參考如何安裝TWiki(中文TWiki的安裝).
- 對于英文比較好的朋友，可以直接到TWiki.org官方網站上去。
- 對于twiki4的安裝，還有種玉堂的文章：http://gztw.com/2006/03/twiki.html。里面記錄了很多詳細信息。
- 還有CheDong的TWiki的安裝備忘, 竹筍炒肉的TWIKI手記