Version 2.12.1 (05.05.2024), see SystemInfo

05.05.2024

Installation#

Download > Apache Mirros > binaries > webapp > JSPWiki.war
Unpack war file with

Option 1
unzip JSPWiki.war -d JSPWiki

Option 2 (no extra folder is created)
apt install default-jdk    # jar is part of jdk
cd /usr/lib/jvm/        # see java versions
jar -xvf JSPWiki.war

Copy folder JSPWiki to <tomee_home>\webapps

Configuration#

Initial setup is done with ../JSPWiki/Install.jsp

The jspwiki.properties file is now embedded in the \WEB-INF\lib\jspwiki-war-2.10.1.jar file (\ini\jspwiki.properties).
If you want to change it, you need to create a custom (second) file called jspwiki-custom.properties, see Advanced Installation. You can place it under /tomee/lib/ (done) or under /JSPWiki/WEB-INF/
Here are all configuration options

Upgrade#

• Replace webapps/JSPWiki with new version
• ../JSPWiki/Install.jsp => note down the admin password !!!
• keep default > Setup
• our jspwiki-custom.properties is in /tomee/lib, so no need to adopt
• stop tomee, clean temp folder, start tomee
• JSPWiki is up and running, but change admin password
• add TablePlugin again

cd ../webapps/JSPWiki
copy -r * ../backup/..
rm -r *
Download at https://archive.apache.org/dist/jspwiki/ > binaries > webapp > JSPWiki.war  
jar -xvf JSPWiki.war
rm JSPWiki.war
restart tomee
https://www.inetone.de/JSPWiki/Install.jsp
Edit:
Anwendungsname = ...
Seitenspeicherung = ...
Hit Next => Copy admin password !!
Restart tomee
Change admin password

TablePlugin
Download Table.jar see blow / Upload to server

mv /home/ftpuser/Table.jar /markus/tomee/webapps/JSPWiki/WEB-INF/lib
vi /markus/tomee/lib/jspwiki-custom.properties, add
jspwiki.plugin.searchPath = brushed.jspwiki.tableplugin

Additional settings#

> locale -a
echo LANG=de_DE.UTF-8 > /etc/locale.conf
echo KEYMAP=de-latin1-nodeadkeys > /etc/vconsole.conf
ln -s /usr/share/zoneinfo/Europe/Berlin /etc/localtime
LANG=de_DE.UTF-8;export LANG
KEYMAP=de-latin1-nodeadkeys;export KEYMAP

Edit catalina.sh:

JAVA_OPTS="-Dfile.encoding=UTF-8"

Plugins#

Therea are core plugins and contributed plugins.

Download: open the contributed plugin page > Info > More Information ... > Links > Download jar file
and install

1. jar into $WIKI_HOME/WEB-INF/lib/
2. in the Plugin search paths section of the jspwiki-custom.properties file,
edit the comma-delimited jspwiki.plugin.searchPath property to include the package designation of the plugin, example com.acme.plugin
(make use comma only, not comma+space!)

Example TablePlugin
1. Copy Table.jar to the folder $WIKI_HOME/WEB-INF/lib/ (or server classpath)
2. Edit jspwiki-custom.properties

jspwiki.plugin.searchPath = brushed.jspwiki.tableplugin

Markup#

Collapsible#

%%collapsebox-closed
! Heading
... box ...
/%

Escape character for JSPWiki is a tilde (~)#

~
Example: double underscore (instead of bold style) Preface~_~_Ending
Example: link with brackets (instead of indicating another link) http://www.testserver.de?show=data~[32~]&language=de
                       Alternative for links is using hex-codes: http://www.testserver.de?show=data%5B32%5D&language=de

Table auto fit#

Afais not possible with standard JSPWiki table, but only with TablePlugin:

[{Table style='width:auto'

||Component||Speed
|USB 3.0 (5Gbps)|625 MB/s
|PCIe 2.0 x1|250 MB/s

}]	

This answers lots of questions:
Ldap Integration | JSPWiki@WikiMatrix

Home

AdministeringJSPWiki + Page Security

---

Security via ACL#

Roles

• Anonymous
• Asserted
• Authenticated
• All

Note: Roles are case sensitive, use "All", not "all"! Grants

• view
• edit
• comment
• rename
• delete

[{ALLOW view Janne,Mike Morris,Authenticated}]
[{ALLOW edit Janne,Managers}]

[{ALLOW view All}]
[{ALLOW edit Authenticated}]

---

General#

Quick start#

• For testing things, try the SandBox.
• For a quick look on what Wiki is, check out OneMinuteWiki.
• For a guideline on good working habits with wiki, see WikiEtiquette.

Installation issues#

• If you run Microsoft Windows, or you are having trouble with UTF-8 then you probably want to take a look at InstallationTips for further information.

Documentation#

• Text formatting rules
• For all of the Wiki markup features, see TextFormattingRules.
• Entry point for full JSPWikiDocumentation
  • JSPWiki 2.8 New Features.
  • buy custom term papers

Miscellaneous#

• There are several ways you can get in touch with JSPWiki Community. Check them out!
• To see what this particular wiki is about, click on the Wiki name on the top left corner of the browser window, or click here.