InstallationTips

Microsoft Windows Issues#

Wiki configuration#

The least painful approach to defining the location of your Wiki files is to have them located at the same drive as your Tomcat (or other web server) installation, and define the location in Unix format. For example, files in C:\JSPWiki\files are defined in the configuration file as /JSPWiki/files.

Also make sure you change the setting for log4j.appender.~FileLog.File in jspwiki.properties if you want a logfile to be created. This setting is hidden quite well near the end of the config-file. The format is the same as the jspwiki.fileSystemProvider.pageDir-setting, i.e. backslashes must be duplicated.

UTF-8 Issues#

If you are having problems with Tomcat 5.x (or higher) and JSPWiki with UTF-8, please note the following!

You have to edit the server.xml of Tomcat (located in the conf-directory of Tomcat). Please add to

<Connector port="8080"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               debug="0" connectionTimeout="20000" 
               disableUploadTimeout="true"/>

the term 'URIEncoding="UTF-8"'.

It should look like this:

<Connector port="8080"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               debug="0" connectionTimeout="20000" 
               disableUploadTimeout="true" 
               URIEncoding="UTF-8"/>

Remember that if you use mod_jk, you should define the URIEncoding for the JK Connector too :

.........
  <service name="Catalina">
    <connector port="8080" />
.........
    <connector protocol="AJP/1.3" uriencoding="UTF-8" port="8009" />
.........
  </service>

Other tips#

Editing the menu on the left hand side.#

The menu on the left hand side (over there <-----) is just a standard Wiki page, called LeftMenu.

If you (the administrator) don't want anyone else to modify it, you can always edit LeftMenu, and then make the page read-only by putting an ACL on it.

The lower part of the left hand side is similarly called LeftMenuFooter, and it is fully editable as well.

Enabling the RSS feed#

In your jspwiki.properties -file, you'll need to set the "jspwiki.rss.generate" to "true", and also set the "jspwiki.baseURL" to point at your Wiki. Otherwise the RSS generator can't figure out how its links should go... :-)

I don't like ~ThingsSquashedTogether in the page titles. What can I do?#

As Finns say, "voe tokkiinsa", meaning "yes, of course". Just set the "jspwiki.breakTitleWithSpaces" property to "true" in your jspwiki.properties-file.