[{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].