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

Version 2.12.1 (05.05.2024), see [SystemInfo]

05.05.2024
[{TableOfContents }]

!Installation
[Download|https://archive.apache.org/dist/jspwiki/] > 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|https://jspwiki-wiki.apache.org/Wiki.jsp?page=Getting%20Started#section-Getting+Started-GettingStartedWithJSPWiki]. You can place it under /tomee/lib/ (done) or under /JSPWiki/WEB-INF/\\
Here are all [configuration options|https://jspwiki-wiki.apache.org/Wiki.jsp?page=Configuration]

! 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|https://jspwiki-wiki.apache.org/Wiki.jsp?page=HowToWriteAPlugin]
Therea are [core plugins|https://jspwiki-wiki.apache.org/Wiki.jsp?page=JSPWikiCorePlugins] and [contributed plugins|https://jspwiki-wiki.apache.org/Wiki.jsp?page=ContributedPlugins].

Download: open the contributed plugin page > Info > More Information ... > Links > Download jar file \\
and [install|https://jspwiki-wiki.apache.org/Wiki.jsp?page=InstallingPlugins]

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|https://jspwiki-wiki.apache.org/Wiki.jsp?page=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|http://www.wikimatrix.org/show/JSPWiki]

[Home|https://jspwiki-wiki.apache.org/Wiki.jsp?page=Getting%20Started]

[AdministeringJSPWiki + Page Security|http://doc.jspwiki.org/2.4/wiki/DocMain#section-DocMain-AdministeringJSPWiki]

----
!!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|https://jspwiki-wiki.apache.org/Wiki.jsp?page=TextFormattingRules]
* For all of the Wiki markup features, see [TextFormattingRules].
* Entry point for full [JSPWikiDocumentation|http://www.jspwiki.org/wiki/JSPWikiDocumentation]
** [JSPWiki 2.8 New Features|http://www.jspwiki.org/wiki/NewIn2.8].
** [buy custom term papers|http://www.custom-made-paper.com/]

!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|SystemInfo].