twiki安装使用手记

twiki安装使用手记

先从网上down下twiki的5.02版，开始配置。

准备工作：
==========
1. Ubuntu已经安装了开发环境，包括make, cc, gcc等
2. Ubuntu已经安装了apache2和perl

安装
=====
1. 下载twiki
    /

2. Ubuntu: 使apache2支持perl
    sudo apt-get install libapache2-mod-perl2 rcs

3. 将.zip文件ftp到Ubuntu，解压缩到/usr/local/twiki
    解压缩命令：unzip *.zip
    如果没有unzip，则按照：apt-get install unzip
    设置文件权限: chown -R -h www-data.www-data twiki

4. Apache: 配置Twiki连接
    建立符号链接: ln -s/usr/local/twiki/ /var/www/twiki


5. Apache: 配置f
    编辑/usr/local/twiki/twiki_
    设置正确的路径，并配置configure文件的访问权限。
    【非常重要，负责在浏览器访问configure是将提示用户名密码，无法登入】
    查找：
    <FilesMatch"^configure.*">
              SetHandler cgi-script
              Order Deny,Allow
              Deny from all
              Allow from 127.0.0.1 192.168.1.10
              Require user JohnDoe
              Satisfy Any
      </FilesMatch>
      修改两个地方：允许的IP地址和"Require user"为你自己的用户名。
      关于用户名设置稍后说明。
      编辑/etc/f
      将/usr/local/twiki/twiki_追加到f最后，
      重新启动apache2，命令：/etc/init.d/apache2 restart

6. Twiki: 配置访问用户
    在/usr/local/twiki/twiki_查找到
    <Directory"/usr/local/twiki/bin">
              AllowOverride None
              Order Allow,Deny
              Allow from all
              Deny from env=blockAccess

              Options ExecCGI FollowSymLinks
              SetHandler cgi-script

              # Password file for TWiki users
              AuthUserFile /usr/local/twiki/data/.htpasswd
              。。。
      注意：密码文件为/usr/local/twiki/data/.htpasswd，将允许访问的用户（上一步提到的用户）添加到密码文件，命令如下：
      htpasswd/usr/local/twiki/data/.htpasswd 你的用户名


7. 在浏览器地址栏输入你的网站/twiki/bin/configure，将进入Twiki安装过程，
    清理所有警告和错误。

8. 辅助工具安装
    确定make, gcc, g++,cc等开发环境已经安装，如果没有，使用apt-get安装。
    apt-get installbuild-essential

    CPAN::Unicode::String
    安装命令：
    # perl -MCPAN -eshell
   cpan> install Bundle::CPAN
   cpan> reload cpan
   cpan> installUnicode::String

9. twiki的中文支持

在configure时

Localisation这一项内的

{UseLocale}选中

{Site}{Locale} 配置成zh_CN.utf8

{Site}{CharSet}配置成utf-8

在后面创建topic时，先创建一个英文页面，然后再重命名标题名。

选择允许使用Allow non WikiWord for the new topic name即可以以中文作为标题。

10. 添加管理员

先新建一个帐户。然后在twiki/bin/view/Main/TWikiAdminGroup页面中找到：

How to login as TWikiAdminUser

点开下面的链接，用户名不改，密码为你config时设置的密码。然后把GROUP中加上你自己的登录名。