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, then make the page read-only on the hard drive itself ;-).

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

Editing pages directly#

By setting up an InterWiki link called "Edit" in jspwiki.properties you can make direct edit links. For example, this link here (assuming you're using the default configuration from the JSPWiki archive), will take you to the edit mode of this page: Edit:JSPWikiTips.

The magical incantation in the jspwiki.properties file is:

jspwiki.interWikiRef.Edit = Edit.jsp?page=%s

Possible Bug or undocumented feature: I accidentally typed:

[Edit this menu|Edit:LeftMenu]

And lo and behold it worked! Note there is not interWikiRef entry in my props file, nor does the above fragment have the requisite number of ['s either. Does this work on 35? Edit this menu Hmmm.

How do I enable 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.

Beware of whitespace in jspwiki.properties#

Properties with extra whitespace at the end of the line may produce mysterious errors that are difficult to trace. For example, a file or directory name with an extra space at the end may break things, and the only warning you get is something like this in the logs:

   ...directory /foo/bar/xyzzy  does not exist.

We do make an attempt to place variables in quotes in log messages (which helps a bit) but keep an eye open for this possibility if you're experiencing oddities.

How do I Conveniently Convert a Microsoft Word Document into Wiki#

I found a VBA macro that did something close at http://tikiwiki.org/tiki-index.php?page=WordToWiki_swythan. I hacked it to format things the way JSPWiki likes it and put it on the Word2JSPWiki Macro page.

How do I force a reindex for Lucene?#

Delete the ${jspwiki.workDir} /lucene directory and restart the container.

In 2.6, you can also enable the Admin UI, and click on "Reindex" on the Search Manager tab.