折腾了一个月，水木的论坛终于装得差不多了，在这期间居然让我碰上了前所未有的事
件。庆幸自己在3月初把水木精华区关于安装的文档都保存了，否则真不知道要装到什么时候
。现在赶快把安装步骤写下来，给想安装的朋友留点参考。
我用的是FC3的系统，这里就以此为例。安装前请用rpm -qa xxx命令检查系统所需的软
件包是否已安装。需要的软件包有：zlib，autoconf，automake，libtool，libxml2，
libiconv，libjpeg，libjpeg-devel, libpng，libpng-devel, freetype2，gd，gd-
devel,openssl，gmp-4.X,这些系统盘就有，装全就是了。
下面安装libesmtp，首先下载到源代码包，然后执行如下命令：
tar xzvf libesmtp-1.0.tar.gz //解压libesmtp
cd libesmtp-1.0 //进入libesmtp源码目录
./configure --disable-pthreads
make
make install
这样libesmtp就安装成功了。
安装mysql没有什么特别要求，按mysql文档安装即可。
现在做一些约定：
$(BBSHOME) 表示 bbs 的安装目录，缺省为 /home/bbs，在本文中指定
为/usr/local/bbs
$(WWWHOME) 表示 apache 的安装目录，在本文中指定为 /usr/local/www
$(PHPHOME) 表示 php 的安装目录，在本文中按缺省的 /usr/local
安装apache和php：
我下载到的是httpd-2.0.52和php4.3.10，以此为例。需要注意的是，apache直接编译安装后
最大上线人数为256，修改httpd.conf也没用，我经过查资料发现这个办法，就是修改源代码
。修改源代码目录中的/include/httpd.h,加上下面的条件定义语句：
#ifdef HARD_SERVER_LIMIT
#define HARD_SERVER_LIMIT 10000
#endif
这样就可以把限制提高到10000人。修改完毕就可以编译了（直接用命令表示）：
cd httpd-2.0.52 //进入源代码目录
./configure --prefix=/usr/local/www --enable-module=so --enable-module=ssl
make
make install
cd ../php4.3.10
./configure --with-apxs2=/usr/local/www/bin/apxs --disable-debug --enable-pic --disable-rpath --enable-inline-optimization --with-dom --with-gd --with-freetype-dir=/usr/lib --with-png-dir --with-iconv --with-jpeg-dir --with-zlib --enable-track-vars
make
make install
OK!安装前的准备终于做好了！！！
现在可以安装smthbbs了。动手前还得修改站点定制文件，这里用的是fb2k-v2,在site
目录下，注意验证fb2k-v2.h中BBSUID 和 BBSGID 与本地系统的 bbs 用户的 uid gid 是否一
致，如果不一致请调整到一致。其余的就是你的站点的一些参数，注意修改。
下面开始编译：
./configure --prefix=/usr/local/bbs --enable-site=fb2k-v2 --with-
www=/usr/local/www --with-php=/usr/local/include/php --with-mysql --enable-ssl
make
make install
make install-home
chown -R bbs:bbs /usr/local/bbs
如果一切顺利，至此 smthbbs、apache 和 php 都已经安装完毕。
运行前配置：
web方式：
apache 的配置文件为 /usr/local/www/conf/httpd.conf，编辑该文件，加入
AddType application/x-httpd-php .php
修改 Port 参数为 80，把 User 和 Group 参数都修改为 bbs。
请把 KeepAlive 参数设为 Off.
将 smthbbs 源代码目录 bbs2www/xml 下的文件复制到 /usr/local/www/htdocs。
php 的配置文件可以从 php 源代码目录得到，将 php.ini-dist 复制为
/usr/local/lib/php.ini，然后编辑 php.ini 文件，将 short_open_tag 的值修改为
Off。
运行 smthbbs
cd /usr/local/bbs/bin
./miscd daemon
./bbslogd
./bbsd -p 23
然后 telnet localhost，注册 SYSOP 和 guest 两个帐号。
guest的密码随便写了.
运行 apache
/usr/local/www/bin/apachectl start
到目前为止，论坛已经可以运行了，但还有许多工作要做！:(
修改分类讨论区:
这里直接借用前辈的文档了！:-)
修改分类讨论区
修改站点的分类讨论区一般来说有两个步骤，一是需要修改站点的配置文件，二是需
要改动代码。配置文件的修改主要和用户界面有关，而源代码的修改主要和统计程序以及
站务管理有关。
6.1 修改站点配置文件
需要改动的文件是 ~bbs/etc/menu.ini 和 web 主目录下面的 site.php。下面是
menu.ini 分类讨论区子菜单的一个简略形式，后面的讲解将都以此为例：
#------------------------------------------------------------------
%menu M_EGROUP
title 0, 0, "分类讨论区选单"
screen 3, 0, S_EGROUP
@EGroups 10, 22, 0, "0BBS", "(0) 本站系统 [本站]"
@EGroups 0, 0, 0, "1USA", "(1) 人在美国 [校园][创业]"
@EGroups 0, 0, 0, "2GoAbroad", "(2) 大话西游 [留学][学校][团体]"
@BoardsNew 0, 0, 0, "New", "(N) 阅读新文章"
!.. 0, 0, 0, "Exit", "(E) 回到主选单"
%
EGROUP0 = "a"
EGROUP1 = "b"
EGROUP2 = "c"
#------------------------------------------------------------------
这里需要注意的地方是：分类讨论区菜单的第 5 个参数的第一个字母是序列号，这个序
列号通过下面的 EGROUP? 来定义分区代号（一般是一个字母或数字）。比如这里的第一
个分类讨论区“本站系统”，序列号是 0，分区代号是 a（由 EGROUP0 定义）。注意：
序列号只是 menu.ini 内部引用使用，没有任何别的用处！后面的修改，以及新建和修改
讨论区都只需要知道分区代号即可，在这个例子中，三个分区代号分别是 a b c。
一般可以把序列号和分区代号设置成一样。
改完 menu.ini 参考 4.3 节使之生效。（站务在主菜单按~）
另一个需要修改的配置文件是 site.php，上面的例子就需要在 site.php 内用下面
的代码：
$section_nums = array("a", "b", "c");
$section_names = array(
array("本站系统", "[本站]"),
array("人在美国", "[校园][创业]"),
array("大话西游", "[留学][学校][团体]")
);
6.2 修改源代码
修改分类讨论区需要修改站点的 site.c 和 site.h 文件。不推荐直接修改
default.h 和 default.c 文件。
smthbbs 系统有一个 ~bbs/0Announce/groups/ 目录，这是版面精华区的总目录，该
目录下存放所有版面的精华区。一般站点希望版面分区结构和精华区分区结构完全一致。
以上面的例子为例，一共三个分类讨论区，那么讨论区精华的总目录下应该有三个目录，
我们把它们分别取名为 GROUP_0 GROUP_1 GROUP_2。修改分类讨论区往往会需要修改精华
区结构，所以修改完分类讨论区之后站务应该进入精华区调整，比如建立目录，修改
.Names 文件等。
源代码的修改首先是 site.h 里面的 SECNUM 常数，它应该定义为分类讨论区数量：
#define SECNUM 3
剩下的修改都在 site.c 里面了，为此确保 site.h 没有定义 USE_DEFAULT_SECODE。
site.c 内一共有四个常量和分类讨论区有关，请注意常量的类型定义绝不能改。
const char seccode[SECNUM][5] = {"a", "b", "c"};
这个是分区代号，部分统计程序需要用到。
const char * const explain[] = {
"本站系统",
"人在美国",
"大话西游",
NULL
};
分类讨论区的区名，web 下的站点管理会用到。最后的 NULL 不能漏！
const char * const groups[] = {
"GROUP_0",
"GROUP_1",
"GROUP_2",
NULL
};
精华区总目录下相应分区的目录名，开版和修改版面设定的时候会用到。
最后的 NULL 不能漏！
const char secname[SECNUM][2][20] = {
{"本站系统", "[本站]"},
{"人在美国", "[校园][创业]"},
{"大话西游", "[留学][学校][团体]"},
};
分类讨论区说明，就按照这个格式依样画葫芦好了。实际上只有 secname[i][0] 才
真正在程序中用到，目的是开版和修改版面精华区位置的时候提示选择用。
另一个需要注意的问题是，每个版面的精华区目录位置都是完全独立储存的，和上面
的修改毫无关系。所以像上面的例子，如果我们决定把 GROUP_0 的目录名改掉，那样的
话不但要进行类似上面所述的修改，而且精华区位于 GROUP_0 目录内的版面都应该要进
入系统管理菜单重新设定讨论区，选择移动精华区位置，指定新的目录。
修改源代码之后需要重新编译安装 BBS 程序。可以看到源代码的修改只和管理操作
和统计程序相关，所以在实际操作中，如果是减少分区数目或者修改分类讨论区说明，可
以仅调整 menu.ini 和 site.php，而不修改源代码。
然后是生成首页导读必须的文件，继续使用前辈的成果：
为首页导读生成必要的xml文件
3.4.1首页导读各元素和xml文件的对应关系简表
所有需要的xml文件都是保存在$(BBSHOME)/xml/目录的，如果您的站台没有此目录
请以bbs帐号在$(BBSHOME)生成此目录。
所有生成xml需要执行的程序，都保存在$(BBSHOME)/bin，源文件在$(SRCDIR)/local_u
tl
以下为了描述方便，不再指明xml和程序的目录。
首页导读元素 需要的xml文件 mainpage.php当中相关函数 生成此xml需执行的程序
推荐文章 commend.xml gen_commend_html() genhot
本日热点话题 day.xml gen_hot_subjects_html() poststat
分类精彩讨论区 day_sec*.xml gen_sections_html poststat
gen_sec_hot_subjects_html()
新开版面 newboards.xml gen_new_boards_html() gennewboard
推荐版面 rcmdbrd.xml gen_recommend_boards_html() 手工写的没有程序
人气排名 board.xml gen_board_rank_html() usage
今日祝福 bless.xml gen_blessing_list_html() poststat
3.4.2 crontab当中有关首页导读的部分
参考$(SRCDIR)contrib/cron.SMTH，在bbs帐号的crontab里面调用各程序生
成以上xml的部分如下所示。请添加到您的bbs帐号的crontab里面。注意以
下不是完整的bbs帐号的crontab，只是和首页导读相关部分的内容，完整的
crontab列表请参考$(SRCDIR)/contrib/cron.SMTH。时间以及程序的完整路径等
内容请根据自己站台的情况进行调整。
# 定时更新推荐文章
0,10,20,30,40,50 * * * * /home/bbs/bin/genhot
# 每小时 59 分执行热门话题统计; 1 分 html 化
59 * * * * /home/bbs/bin/poststat /home/bbs
# stiger:新的十大统计
59 23 * * * rm -f /home/bbs/tmp/Xpost/*
# 每天早上 4:33 统计各版使用状况0
33 4 * * * /home/bbs/bin/usage 0 >/dev/null 2>&1
36 4 * * * /home/bbs/bin/usage 1 >/dev/null 2>&1
至于gennewboard，如果您的站台经常开新版，那么把它加入crontab；如果不经
常开新版，在bbs系统上开完新版之后，用bbs帐号手动执行一下也可以。
推荐文章需要在站上开一个版，Recommend版，然后版主在版面上推荐的文章前面
按;3，此文章进入Recommand版，站务在Recommend版需要推荐的文章前面按g就可
以使得此文章出现在web首页导读的推荐文章了。
3.4.3手工生成rcmdbrd.xml
编辑，$(BBSHOME)/xml/rcmdbrd.xml，按照以下格式，感谢windinsn提供
<?xml version="1.0" encoding="GBK"?>
<RecommendBoards>
<Board><EnglishName>这里写版面的英文名</EnglishName></Board>
<Board><EnglishName>...</EnglishName></Board>
...
<Board><EnglishName>...</EnglishName></Board>
</RecommendBoards>
至此，所有的首页导读的元素都已经生成完毕，在浏览器打开
http://yoursite./mainpage.php 应该可以得到看到首页导读的各元素。
现在已经基本完成了，但为了简化注册过程，我取消了发激活邮件的过程，web填写密码
并直接生成注册单，谢谢前辈的文档，我就偷懒了！:>
bbs2www/html/bbsreg.html
增加两个<input
<input type="password" name="pass1">
<input type="password" name="pass2">
bbs2www/html/bbsreg.php
首先判断$_POST["pass1"]和$_POST["pass2"]一不一样，不一样就直接html_error_quit
另外我记得密码的位数必须是5-39位（inclusive），这个最好限定一下。
我不确定出了这个范围会不会有问题
$password=bbs_findpwd_check("","",""); 改成
$password = $_POST["pass1"] 赫赫，bbs_findpwd_check是一个自动产生密码的垃圾函数
从$mailbody开始到那个发送邮件失败的http_error_quit都不要了
bbs_createregform函数调用的最后那个参数，改成FALSE，这个非常关键！！
这样做就会填完注册单站务就可以在系统管理菜单->审批注册单看到。
后面的提示稍微改改，可能就差不多了。
另外你的src/site.h最好是这样的：
#define REGISTER_WAIT_TIME (0)
#define REGISTER_WAIT_TIME_NAME "马上"
这两个smth默认好像是48小时，比较bt。这样改能保证telnet立即能填写注册单。
我按上面的方法修改后还是有一点问题，就是被拒的用户在web里重新填写注册单站务却看不
到，琢磨了半天，终于搞定。修改bbs2www/html/bbsfillform.php,把里面bbs_createregform
函数最后一个参数也全改成FALSE，这样就OK了。
好了，终于安装好了，累死我了！至于blog，我安装后还是有问题，而现在没法上水木提
问了，只好先不要了。;(
至于我装的站台，教育网用户可以到http://202.195.144.15看一看，公网无法访问，大家都知道原因的吧！
