LinuxSir.cn,穿越时空的Linuxsir!

 找回密码
 注册
搜索
热搜: shell linux mysql
查看: 1611|回复: 6

新版本校园Debian之wiki服务器的安装

[复制链接]
发表于 2006-4-26 00:19:49 | 显示全部楼层 |阅读模式
新版本校园Debian:wiki服务器的安装

一 wikid和教育
    林君一直鼓捣我建设一个教育教学方面wiki服务器,也符合我一向认为的“wiki比blog更适合于教育教学”的观点,便应允。至于我们准备建设一个如何的wiki网站,它不同于目前已有的与教育相关的wiki网站的特色在哪里等问题,将另文叙述。以下只谈技术方面的问题。

二 wiki服务器的选择
    由于开源世界的博大精深,反而使得这个选择非常的困难,这个网页(http://www.allwiki.com/wiki/Wiki ... ,结果如下:
    几种主要wiki发布程序的最新版本:(2006年4月)
      mediawiki  1.6.3
      twiki  4.0.2
      phpwiki   1.3.12 p2
      docuwiki  20060305
      moinmoin 1.5.3


    而在Debian(Etch)中依次是:
      mediawiki    1.4.15-1
      twiki     20040902(? 没有人维护?)
      phpwiki    1.3.11 p1
      docuwiki     无
      moinmoin    1.5.2-6

    我不可能一一测试,最后只选择安装mediawiki和moinmoin两个进行安装测试。
    考虑到sarge中这些软件的版本确实太老,而且按计划应该今年年底发布Etch,因此我安装mediawiki和moinmoin都是在Etch上进行,但是都没有使用Debian自己的包管理系统来安装,而是都选择了源代码安装。

三 基本系统LAMP的安装:
    1 下载Sarge的netinst.iso安装光盘安装,我今天使用的是Sarge3.1r2。
    2 安装Sarge系统。
    3 进入新的系统,修改/etc/apt/sources.list文件,将其中的stable都修改为etch。
    4 #apt-get update
    5 #apt-get dist-upgrade
      至此,etch系统已经安装完成。以上是当前官方推荐的安装etch的方式。
    6 #apt-get install apache2 php5 mysql-server-5.0 mysql-client-5.0
      构建LAMP系统,已经抛弃了经典的apache+php4+mysql4,现在用的都是新版本。也不用修改什么配置文件,现在都可以跑起来了。
    7 #apt-get install php5-gd phpmyadmin
      这一步并不是一定要,前者使得php可以处理图形,后者方便使用mysql数据库,因为我对mysql的命令行并不是很熟悉。

四 mediawiki的安装使用:
    1 简介
    MediaWiki全球最著名的开源wiki引擎,运行于PHP+MySQL环境。从2002年2月25日被作为维基百科全书---这个最著名的网络百科全书目前应该在国内无法访问---的系统软件,并有大量其他应用实例。目前MediaWiki的开发得到维基媒体基金会的支持。
    mediawiki的优点主要体现在:能经受重量级应用的考验,功能丰富却架设简单,如全世界最大的wiki项目维基百科是使用mediawiki的成功范例,数据量、访问量都超级庞大;mediawiki的功能非常丰富,支持多语言版本,充分满足知识站点的需要;运行环境要求很低,架设过程简洁,即使新手也可以迅速建立自己的站点;具有最大的wiki程序社区的支持;持续开发,程序特性功能不断完善,保证未来的支持,因为mediawiki是受到维基媒体基金会支持的开源项目,在功能、性能、安全方面将不断优化。

    2 源码安装----显然以下安装过程适合任何一种Linux发行版本:
    2.1) 下载源码,2M多,官方网站上不了就找镜像网站!
    2.2) 解压到apache2的缺省目录,一般是:
         # cd /var/www
         # tar zxvf ...../mediawiki-1.6.3.tar.gz
         # ln -s mediawiki-1.6.3 mediawiki  (我的习惯都做一个符号连接)
         # cd mediawiki
         然后最好仔细读读其中的README和INSTALL文件。
     2.3) 将其中的config目录属性修改为可写:
         # chmod a+w config
     2.4) 在客户端打开浏览器,在浏览器的地址栏输入该wiki的地址,在我的环境下是:
         http://192.168.1.203/mediawiki/
     2.5) 第一使用的话,浏览器里面显示要求你先安装(setup)mediawiki。
     2.6) 那就填表吧,一些重要的填表项目列于下:
         之后,根据页面提示填写相应的内容:(请对以下内容做好记录,以便升级时使用)
         * Site name:你的wiki站点名称。注意:这与网站本身的名字空间有关,建议使用简短的英文(以后可修改)
         * Language:语种选择。建议选择zh-cn简体中文或zh-tw繁体中文;没必要就不要选支持繁简体自动转换的zh中文,否则此后网站提示的本地化工作量将增加很多
         * Copyright/license medadata:版权类型。其中GNU为公开的自由版权,允许他人复制、修改;不确定该用什么版权时选no license metadata
         * Sysop account name:站长的名字。这是建立wiki后的第一个管理员用户,以后无法改名。可考虑使用英文名字
         * Shared memory caching:网站缓冲机制,建议选择Turck MMCache,将大幅提高整站的整体性能。
         * MySQL server:填写空间服务商提供的MySQL服务器名称,一般为localhost
         * Database table prefix:数据表前缀。建议设置前缀,以便与本站的其他软件公用MySQL数据库,甚至同时架设多个wiki(需放在不同目录)。
         * DB root password:数据库超级用户root密码,缺省为空密码。
     2.7) 执行了以上浏览器安装过程后,在config目录下会自动生成一个LocalSettings.php的本地配置文件,把它拷贝到wiki的主目录中---即config的上层目录。然后需要取消config目录的写权限,推荐直接删除,这是网站安全性的需要。   
     2.8) 享受mediawiki吧。

     3 Debian安装
     Etch中的mediawiki如果采用apt安装的话,要求使用php4+mysql4,在我的上述php5+mysql5系统中安装失败。

五 Moinmoin的安装使用:
     1 简介:
     MoinMoin是一个基于Python环境的wiki引擎程序,支持包括中文在内的多语种特性。Moin是德国北部方言“好”、“早上好”的意思,MoinMoin就是很好之意。
     MoinMoin的特点主要是:完全使用文件来存储内容,不使用数据库;实现了全部Wiki规范,Unicode编码支持多语种;完整实用的wiki文本约定,编辑规则比较轻巧易学;支持多种扩展方式: 如宏,插件,预处理等;为数众多的插件中包括Tex科技文本输入、FreeMind思维导图、GraphViz示意图、gnuplot数据图表绘图等,这是我觉得非常重要的;真正跨平台实现等。

     2 源码安装:
     21) 本来我想先升级系统的Python到新的2.4版本,因为无论是Sarge还是Etch,其缺省使用的python都是2.3版本的,但由于我想使用mod_python的方式来运行MoinMoin,而目前的Etch中,没有libapache2-mod-python2.4这个包,但是有libapache2-mod-python2.3,所以我放弃了升级Python到2.4的计划。
    如果以cgi的方式来运行MoinMoin,应该可以使用Python2.4

     22) 下载MoinMoin源码并解压,以下是我的:
     # cd
     # wget http://...../moinmoin-1.5.3.tar.gz
     # tar zxvf moinmoin-1.5.3.tar.gz
     # cd moinmoin-1.5.3

     以下23-25是MoinMoin官方要求的安装的三个步骤:
     23) 基本安装
     # apt-get install python2.3-dev (这步不可少,否则无法继续)
     # python setup.py --quiet install
     (如果是非root用户安装到/home下,则做法有所不同,详见官方文档,使用虚拟主机并采用cgi方式的用户这里注意)
     MoinMoin被安装到 /usr/lib/python2.3/site-packages/MoinMoin和 /usr/share/moin目录下。

     24) 创建实例
     这个步骤实际上就是要把一些系统制作好的模版复制到用户的www目录去,并进行相应的文件权限设置,我假设要把自己的wiki建设在apache缺省目录的mymoin目录下。
     # cd /var/www
     # mkdir mymoin
     # cd mymoin
     # cp -R /usr/share/moin/data .       # copy template data directory
     # cp -R /usr/share/moin/underlay .   # copy underlay data directory
     # cp /usr/share/moin/config/wikiconfig.py .   # copy wiki configuration sample file
     (以上复制必要的文件和目录,最后那个小圆点不可忘记)

     # cd /var/www
     # chown -R www-data.www-data mymoin   # check that USER and GROUP are correct
     # chmod -R ug+rwx mymoin         # USER.GROUP may read and write
     # chmod -R o-rwx mymoin          # everybody else is rejected
     (以上是按官方要求设置文件和目录权限)

     # cd mymoin
     # nano wikiconfig.py
     编辑这个配置文件主要是修改两个地方:使其使用绝对路径:
     data_dir = '/var/www/mymoin/data/'
     data_underlay_dir = '/var/www/mymoin/underlay/'

     25) 配置MoinMoin的运行方式和修改apache配置文件
     MoinMoin必须运行在Apache下,有四种不同的运行方式,分别是cgi,fast-cgi,mod_python,twisted,他们之间的区别在此略。我选择采用mod_python方式。
     # apt-get install libapache2-mod-python2.3
     (不知道Etch正式发布时是否会有mod_python2.4)
     # apache2ctl restart
     这里要结合查看log文件确定apache的mod_python已经启动。

     修改apache的配置文件(分别是/etc/apache/httpd.conf和/etc/apache2/apache2.conf),在其中加入:
        <Location /mymoin>
          SetHandler python-program
          # Add the path of your wiki directory
          PythonPath "['/var/www/moin/mywiki'] + sys.path"
          PythonHandler MoinMoin.request::RequestModPy.run
        </Location>

     26) 在客户端浏览器中输入:
         http://your_server_ip/mymoin/
      就可以了。

     3 Debian安装:
     使用 #apt-get install python2.3-moinmoin代替上述的22和23就可以,其余步骤相同。

     以上只是两个Wiki服务器的安装,实际中,更为重要的工作是对服务器进行更精细的配置和修改,下回分解。
发表于 2006-4-26 06:16:13 | 显示全部楼层
谢谢分享,非常期待 wen 兄的配置篇续集
回复 支持 反对

使用道具 举报

发表于 2006-4-28 10:14:47 | 显示全部楼层
赞一个,不知wen老兄还认得我么?;p
回复 支持 反对

使用道具 举报

发表于 2006-5-7 09:40:21 | 显示全部楼层
对了wen兄,为什么上不了你的那个论坛了呢
回复 支持 反对

使用道具 举报

发表于 2006-5-7 09:41:10 | 显示全部楼层
我是说用我的帐号,好长时间都不能上了(自从你改版后)
回复 支持 反对

使用道具 举报

发表于 2006-5-7 11:41:50 | 显示全部楼层
看过...
谢谢lz分享!
回复 支持 反对

使用道具 举报

发表于 2006-5-7 15:33:22 | 显示全部楼层
我的wiki怎么总是没有css显示的效果呢?
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

快速回复 返回顶部 返回列表