This is how the JSPWiki is installed and configured at Aformatik. (http://www.aformatik.de/OpenSourceWiki/Wiki.jsp) Here are all the questions we came up with and their decisions. We think it could be usefull for beginners and advanced users could give their hints here.
Also this is a protocoll for us at Aformatik how we installed the JSPWiki and why we did it this way.
We did a default installation with the last stable version and it worked fine. But shortly after this we came up with some individual wishes. We decide to install it new and configure it well.
Before editing we copy the original version of the file as backup.
Which version should we use?#
We will use the newest version. For later upgrading see: UpgradingJSPWiki- Pro: We want some individual settings which will use newer featuers or which will came up with them. Silly enchancing old code.
- Contra: Wiki might have problems and would not be stable.
build the new version#
1. Get the newest nightly build2. copy build.properties.win to build.properties.mine (you could change the properties, we let them and change the jspwiki.properties at the end)
otherwise build failed: ... JSPWiki-020404-cvs.tgz\JSPWiki\build.properties.mine) not found.
3. put the j2ee.jar in the classpath.
otherwise build failed: compile failed: javax.servlet classes are missing
4. build it with Ant. (add the war option, see JSPWikiDownload)
Properties#
Editing the jspwiki.properties. (Before this copying the original file as backup.)jspwiki.applicationName = OpenSourceWiki#
Set your name here. Like awnsering the question what is on your wiki, not how is it implemented.jspwiki.pageProvider = VersioningFileProvider#
We hope version of pages are shown in the directory. Maybe PageDeletion is easier.jspwiki.fileSystemProvider.pageDir = C:\\OpenSourceWiki\\data#
see Placing pageDir below WEB-INF in StupidQuestionssee jspwiki.applicationName
jspwiki.basicAttachmentProvider.storageDir#
We will use the same as pageDir.log4j.appender.FileLog.File = C:\\OpenSourceWiki\\jspwiki.log#
log4j was in the cvs allreadysee jspwiki.applicationName
jspwiki.breakTitleWithSpaces = true#
nicer reading from titles. see also CanWeDisplaySplitPageNamejspwiki.specialPage#
fixing content of pages?jspwiki.interWikiRef#
Rename WikiWikiWeb to C2-Wiki. We already call it C2-Wiki. There was once a WikiWikiWeb out there and the url leads to somewhere else. # JINX-Wiki a wiki for java # maybe some pages go wrong, because they are numbered in SWiki and the # title matching could fail jspwiki.interWikiRef.JINX-Swiki = http://jinx.swiki.net/%s # insert others like java.net, javasource.org, sun java api for classes