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