|
What this is
This file is included in the DevDaily.com
"Java Source Code
Warehouse" project. The intent of this project is to help you "Learn
Java by Example" TM.
Other links
The source code
<html>
<head>
<title>JForum - Powering Communities
<link href="jforum.css" rel="stylesheet" type="text/css" />
</head>
<body>
<jsp:include page="header.htm"/>
<table width="792" align="center" border="0">
<tr height="10">
<td colspan="2"> |
</tr>
<tr>
<td valign="top" rowspan="2" width="12%">
<img src="dot.gif"> Main page
<img src="dot.gif"> Features
<img src="dot.gif"> Download
</td>
</tr>
<tr>
<td valign="top" rowspan="3">
<a href="http://www.atlassian.com/c/NPOS/10160">
<font style="font-family: verdana; font-size: 22px;">Development
<img src="h_bar.gif">
<p>
As an Open-Source software, you are invited to contribute to JForum. There are many areas where you can help, like
making documentation, new styles, buttons, mods and even helping to develop the core source-code. <br/>We'll have more
information in this page soon, but a good start point is the forums. You can also send an email to JForum's project
leader, Rafael Steil, at <b>rafael _[at]_ insanecorp.com.
</p>
<p>
JForum does not uses JSP for content display, but a template engine, which offer much more ease of development and
maintaince. The template engine used is <a href="http://freemarker.sourceforge.net/">FreeMarker.
</p>
<br/>
<p>
<img src="info.jpg" align="middle"> Contributors
A project only evolves with feedback of users and contribution - be it programming, documenting, making graphics and
so other many areas - of so many valuable people.
<p> 
<table cellspacing="0" width="50%" align="center" bgcolor="#ff9900">
<tr>
<td>
<table width="100%" bgcolor="#ffffff">
<tr>
<td>Rafael Steil
<td>project leader
</tr>
<tr>
<td>James Yong
<td>developer
</tr>
<tr>
<td>Marc Wick
<td>developer
</tr>
<tr>
<td>Sean Mitchell
<td>ideas, ideas, ideas
</tr>
<tr>
<td>Pieter Olivier
<td>developer
</tr>
<tr>
<td>Sérgio Umlauf
<td>Layout
</tr>
<tr>
<td>Pablo Marutto
<td>logo
</tr>
</table>
</td>
</tr>
</table>
</p>
<p>
People come and go all the time. Many times we receive help because an user needs some feature more quickly, or then
he / she got some free time to contribute for a while, and is that kind of contribution which makes the project grow up.
<b>You are welcome to join us.
</p>
<br/>
<p>
<img src="info.jpg" align="middle"> Bug and Issue Tracker
JForum issues are tracked by <a href="http://www.atlassian.com/c/NPOS/10160" target="_new">JIRA, by Atlassian. You can see
the current issues, ask for new features and submit bug reports at <a href="http://www.jforum.net/jira">http://www.jforum.net/jira
</p>
<br/>
<p>
<img src="info.jpg" align="middle"> Getting the source code from CVS
The CVS repository is hosted by <a href="http://java.net" target="_new">Java.net. Below is listed the host access options:
</p>
<table cellspacing="0" width="50%" align="center" bgcolor="#ff9900">
<tr>
<td>
<table width="100%" bgcolor="#ffffff">
<tr>
<td>Host
<td>cvs.dev.java.net
</tr>
<tr>
<td>Path
<td>/cvs
</tr>
<tr>
<td>Server Type
<td>pserver
</tr>
<tr>
<td>Username
<td>guest
</tr>
<tr>
<td>Module
<td>jforum
</tr>
</table>
</td>
</tr>
</table>
<br/>
<p>
<img src="info.jpg" align="middle"> Setting up your development environment
First of all, create an empty file named <i><your_username>.conf in the directory WEB-INF/config, where
<your_username> is the username you login in your computer. For the sake of information, is the return of a call to
<br/>
<i>System.getProperty("user.name")
<br/>
so, if your account is "johndoe", you should create a file named <i>johndoe.conf. This file is necessary when working on
teams, since you should not change <i>SystemGlobals.properties to put your own configuration data, like passwords and
forum address. After creating the file, just add it to <i>.cvsignore.
</p>
<p>
You can follow the install instructions <a href="install.htm">clicking here
</p>
<p>
The best start point is <i>src/net/jforum/JForum.java, which is the Front Controller implementation.
<i>src/net/jforum/entities contains all entities used in the system, src/net/jforum/model have the
interfaces used to persist and retrieve data and <i>src/net/jforum/view contains all view related actions.
</p>
<br/>
<p>
<img src="info.jpg" align="middle"> Getting help
The best place to ask for help is in the forums / Community section. <a href="community.htm">Click here to go there.
</p>
</td>
</tr>
</table>
<jsp:include page="bottom.htm"/>
</body>
</html>