建立mvnForum的开发环境,将步骤详细的写了下来,与各位分享!希望借此文,能够方便大家部署和改进mvnForum在中国的使用。
文中如有遗漏、错误、误导之处,望大家多多包涵,我会持续改进。
初次发文,不足之处,还望大家多多指教!
1、
mvnforum-1.0.2-ga-src.zip并释放到工作目录。
还有其他相关下载
mvnforum-1.0.0-rc1-screenshot.zip这是中文说明书
mvnforum-1.0.2-ga-bin.zip
mvnforum-1.0.2-ga-jakarta-tomcat-5.0.28.zip
2、Eclipse:启动Eclipse,新建一个项目(如kmanforum),目录指定到工作目录下的mvnforum目录,可以根据爱好修改输出目录为classes;
JBuilder:启动JBuilder,New...->ProjectGroup,指定到你释放的工作目录,建立一个工程组。
New...->Project for ExistingCode,指定到工作目录的mvnForum目录,使用默认选项建立工程,如果出现2个srcweb,删除没有JSP的那个。
New...->Project for ExistingCode,指定到工作目录的myvietnam目录,使用默认选项建立工程。
建议:将下面需要配置的属性文件添加到工程中,方便编辑,呵呵。
3、再新建一个项目(如myvietnam),目录指定到工作目录下的myvietnam目录,可以根据爱好修改输出目录为classes;
4、修改kmanforumd项目的build.properties文件如下内容:
#用户默认语言及资源文件编码
(2)locale.language=zh_CN
(3)locale.bundleencoding=GB2312
#如果需要直接部署,修改deploy.localhost
(10)deploy.localhost=D:/Tomcat-5.0.29/webapps
#按照需要修改为自己论坛的context应用名
(18)app.name=yourforum
#你所使用数据库的JDBC驱动,默认是MySQL,可以修改为使用jtds的JDBC驱动,配置SQLServer如下:
(24)sqldriver.jar=jtds-1.0.jar
5、修改kmanforumd项目properties目录下的mvnforum.xml文件如下内容:
#管理页面url pattern
(10)/admin
#用户页面url pattern
(13)/forum
注:如果修改了以上2项,需要对应修改web.xml文件如下内容:
(54)/admin/*
(66)/forum/*
#根据需要修改相关属性,如下:
->存放论坛产生的文件:
(24)D:\Tomcat-5.0.29\webapps\kmanforum\WEB-INF\mvnForumHome
->存放论坛日志:
(30)D:\Tomcat-5.0.29\webapps\kmanforum\WEB-INF\mvnForumHome\log\mvnforum.log
->管理员邮件:
(31)
[email protected]
->logo的链接地址:
(32)http://localhost:8080/yourforum/forum/index
->支持的语言及默认语言,注意:这也是用户注册时可选的语言选项:
(33)en;zh_CN;zh_TW
(34)zh_CN
->Guest用户的默认时区:
(40)8
->最大用户附件大小:
(122)1MB
->设置用户发帖/注册/登录/短信息的频率:
(144)0
(145)0
(146)0
(147)0
6、修改kmanforumd项目properties目录下的log4j.properties文件如下内容:
#对应在mvnForum.xml中设置的mvnforum_home属性,设置日志文件存放路径
(56)log4j.appender.A2.File=D:/Tomcat-5.0.29/webapps/kmanforum/WEB-INF/mvnForumHome/log/mvnForumLog.txt
7、修改myvietnam项目properties目录下的mvncore.xml文件如下内容:
#数据库配置信息,默认为MySQL,可以修改为使用jtds的JDBC驱动,配置SQLServer如下:
(28)net.sourceforge.jtds.jdbc.Driver
(29)jdbc:jtds:sqlserver://localhost:1433/kmanforum;user=sa;password=mywangya
(30)
(31)
#邮件服务器配置信息,根据实际使用的邮件服务器信息进行修改,举例如下:
(49)smtp.yourmailserver.com
(50)
[email protected]
(51)yourname
(52) yourpassword
(53) 25
#系统核心参数信息,设置论坛的部署应用参数,包括Context和ServerPath,如下:
(57)/yourforum
(58)http://localhost:8080
#所在时区信息,例如北京时间为+8,如下:
(68)8
8、建立数据库,从kmanforumd项目sql目录下的找到对应的数据库脚本,执行后即可创建数据库表。如在SQLServer中,在企业管理器中,建立kmanforum数据库,选择数据库,启动查询分析器,打开对应的脚本mvnForum_sqlserver.sql,执行后,即可建立对应数据库表。
9、现在可以进行编译。
Eclipse :1、编译:右击build.xml,选择Run as下级菜单AntBuild...,运行,成功编译后,项目目录下的build\webapp目录下即为论坛的程序。直接拷贝到Tomcat安装目录下的webapps目录下,启动Tomcat即可。
2、直接部署:建立直接部署的启动选项,选择Run菜单中的External Tools,在ExternalTools窗口中,右击刚才建立的kmanforum build.xml,选择Duplicate,将名称修改为kmanforumbuild.xmldeploy,在右边的Arguments中加入deploy-localhost即可,运行,成功编译后,可直接部署至你在build.properties配置的deploy.localhost加上你在mvncore.xml中配置的context_path。
JBuilder:1、首先建立运行配置,点击Debug Project或Run Project按钮,选择New...,Buildtarget选deploy-localhost(build.xml),Type选择Server,选中JSP/Servlet,修改LaunchURI为/kmanforum/forum/index,可以为运行配置命名Name为build-deploy。
2、DebugProject,会出现错误,不要紧,进入到你的工作目录下的mvnForum目录下的Tomcat/conf目录,用文本编辑器打开server8080.xml,删除第二行,修改Context的docBase和path:
docBase为你在build.properties配置的deploy.localhost加上你在mvncore.xml中配置的context_path,建议你将mvnForum工程的WebModule名以及Contextroot也改为和context_path相同;
path为你在mvncore.xml中配置的context_path;
注:能否成功的关键在这一步!并且这个docBase不能为mvnForum工程的srcweb目录,不知道为什么!
3、OK,停止调试,重新运行调试即可。
4、唉,JBuilder真的好麻烦!Eclipse就做的好多了,呵呵呵。
对以上路径,举例说明一下,在build.properties配置的deploy.localhost=D:/Tomcat-5.0.29/webapps,在mvncore.xml中配置的context_path为/myforum,docBase为"D:\Tomcat-5.0.29\webapps\myforum"。
10、在Eclipse的包浏览器中会报告程序有错误,可以通过以下办法解决,在刚才build成功之后,将myvietnam项目build\lib目录下的myvietnam.jar文件复制到kmanforumd项目的lib目录下,再从http://ant.apache.org下载ant安装包,解压后将lib目录下的ant.jar复制到kmanforumd项目的lib目录下,并在项目属性的Libraries下面,通过AddJARs将这两个jar文件加入到项目中,即可。
11、在Ant进行Build的时候,会转换所有支持的语言,如果我们不需要这么做,而只需要编译我们默认的语言和需要支持的语言,比如简体中文/繁体中文/英文,可以修改build.xml的部分。
12、可以修改i18n目录下面的mvnForum_i18n_zh_CN.properties,完善中文信息,修改完后,重新build即可。