电子产品说明书范文200:安装TWiki最新版本的详细方法 (种玉堂)

  有朋友希望我介绍一下TWiki最新版本（4.01）的安装方法，说是目前在互联网上找到的中文介绍都有点过时，又或者介绍的不太准确。实际上，在TWiki最新版本的压缩包中，有一个“INSTALL.html”文件，该文件从安装到安装之后如何选择自己喜欢的外观，管理和分配用户权限，从为TWiki安装插件到如何着手定制TWiki都有涉及，需要的朋友可以参考该文件，下面我只是简单的介绍一下一些安装过程中需要注意，而“INSTALL.html”文件有可能没有涉及，或者说的不太清楚的地方，供需要中文安装说明的朋友参考。

      首先，当然是下载和解压缩TWiki软件包了，下载和解压缩TWiki软件包到你的电脑上，又或者直接在服务器上使用wget下载并tar，视乎你个人的习惯，之后的步骤下面分步骤为你介绍。

1、在下载并解压缩TWiki软件包之后，检查一下bin目录下各脚本文件的文件头指向的Perl程序路径（#!/usr/bin/perl-wT）是否正确，如果不正确就逐一将其修正。当然了，如果你所使用的服务器不需要根据脚本第一行指定Perl路径，你可以跳过这一步。

2、编辑lib/LocalSite.cfg.txt和bin/LocalLib.cfg.txt，需要编辑的地方不多，都是修改网站地址和文件路径的设置，你只需按照自己的服务器路径、域名等修改文件中的设置，使其对应于你所使用的域名和路径路径正确，并在修改之后将它们另存为lib/LocalSite.cfg和bin/LocalLib.cfg即可。

3、如果你使用自己的服务器，并且使用的是Apache服务器，拥有编辑管理 httpd.conf的权限，那么可以参考根目录下的twiki_httpd_conf.txt，对服务器设置进行修改。如果你没有这样的权限也不要强求，可以跳过这一步，通过下面的数字，你的TWiki仍然可以工作的很正常。

4、编辑pub-htaccess.txt、root-htaccess.txt、subdir-htaccess.txt，它们是TWiki为pub目录、根目录和其他子目录准备的.htaccess文件范本，你可以编辑它们，然后另存为对应目录下的.htaccess，通过它们可以避免子目录下的文件被直接读取等一系列可能存在的危险。特别是在你不能够编辑管理 httpd.conf 之时，发挥很大作用。

5、如果你是在自己的电脑上做准备工作的，这会可以开始上传所有的文件到你准备使用的服务器上。注意如果你使用类Uinx系统，那么需要设置bin目录下的脚本可运行，data、pub目录和 lib/LocalSite.cfg文件为可读写，而其他文件与目录这需要是可读的就可以了。

6、使用浏览器打开bin目录下的configure，例如http://drler.com/bin/configure，顺利的话，你应该能够进入TWiki的设置管理程序，程序会仔细检查服务器中的设置，以及TWiki中你的各项设置是否正确，并提示你可能存在的问题，让你逐一进行修正和设置。而如果程序为法正常运行，有可能是你的服务器只有特定扩展名的程序才能够被运行，你可以将configure改名为configure.cgi或configure.pl试一下，或者直接咨询服务器的管理人员。

7、如果希望使用中文界面（大概不希望的少吧？），在configure中的Localisation设置需要特别注意，需要选中{UserInterfaceInternationalisation}、{Languages}{'zh-cn'}{Enabled}、{UseLocale}这几项设置的复选框，并设置{Site}{Locale}为“zh_CN.UTF-8”，设置{Site}{CharSet}为“UTF-8”，{Site}{Lang}和{Site}{FullLang}为“zh-CN”，这样保存设置之后，打开Wiki就会是中文，并且能够正常的使用和编辑中文了。

8、设置好之后，通过bin目录下的view打开Wiki，例如http://drler.com/bin/view，接下来你就可以按照“INSTALL.html”文件的介绍，尝试一下外观设置、插件安装之类的工作了。

9、如果没有管理 httpd.conf的权限，使用的也不是Windows下的只需指定那一个目录可运行就能够使用Perl的服务器，又不希望逐一修改bin目录下的脚本，给它们都添上扩展名，那么可以编辑bin目录下的htaccess.txt，将其另存为.htaccess，在大部分Apache服务器上，通过该文件中的SetHandlercgi-script，可以使该目录下并不是.cgi、.pl的脚本可运行。但需要注意，该文件另外的代码，将要求使用密码保护bin目录下的edit等文件的使用权限，如果不希望使用这些功能，可以用#注译掉自己认为不需要的代码。而如果希望使用密码保护功能，需要将AuthUserFile修改为你的服务器上的路径，例如 AuthUserFile/home/data/.htpasswd，而为无法通过密码验证时出现的401错误页面设置，需要修改为你的TWiki注册页面的本地路径，注意是本地路径不是http开头的URL，例如应该设置为ErrorDocument 401/bin/view/TWiki/TWikiRegistration。

注：在整个安装调试的过程中，强烈建议你多注意服务器的错误记录，TWiki的代码编写的不错，作者大多也很严谨，通过错误记录你可以发现一些通过浏览器测试过程中无法发现的问题，及时的修正错误，使TWiki能够安全、高效的运行。