JSP Wiki
Main, Wiki, GitHub, Post cent os

Abstract#

JSPWikiは、JavaベースのWikiエンジンです。Tomcat上で動きます。Braincopy.ORGでも使っているこのJSPWikiについて、調べたことを記録します。

What's new#

Topics#

気が付くとWikiEngine.pageExistsメソッドがなくなっている。最新のAPIはどうなっている！？API
2024年2月20日時点では、2.12.1が最新
もしこれを使うのであればTomcat9.0.78が必要

Properties#

デフォルトのjspwiki.propertiesってどこかにあるのかな。jspwiki-mainパッケージの中のsrc/main/resource/ini/jspwiki.propertiesがある[6]。

Haddock#

最新状況のところで言及しているMobile向けCSSの件、ちょっと調べていると、HaddockというテンプレートをこのJSPWikiが持っていることを見つけました。早速適用してみました。やり方は、[2]にあるとおり、jspwiki-custom.propertiesにを追加して、Tomcat再起動するだけです。
jspwiki.templateDir = haddock
これは、Bootstrap[3]というフロントエンド（HTML、CSS、JS）のFrameworkを使っているそうです。

Plugin#

jspwikiのplugin作ります。
PageViewPlugin is one of CORE plugin of JSPWiki. Here is how to use this plugin.

jspwiki portable#

JSPWIKIのパッケージには、jspwiki portableというパッケージがあります。これは、Tomcat含めたパッケージで、これだけで簡易にJSPWikiを使うことができます。使い方を少々

日本語を使うには#

Tomcat のserver.xmlのConnectorといところにURIEncordingの設定を追加することで、UTF8 のurl使えるようにします[5]。でも点"・"は使うとおかしなことになります。
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
     	 URIEncoding="UTF-8" />

不明事象対応#

Tomcatでほかのアプリは立ち上がっているけど、JSPWikiが立ち上がらない。ログを見るとWikiEngineが見つからないとか、jspwiki-custom.propertiesが見つからないとか。これにはずっと悩まされている。systemd、つまりコマンドでいうとsystemctl start tomcatで立ち上げた場合発生し、直接bin/startup.shから立ち上げると発生しない。つまりtomcatユーザで実施すると発生し、root権限で実施すると発生しない。むっちゃパーミッション問題のようにも見える。これがでたら、ひたすら、tomcatフォルダ、特にJSPWikiフォルダやtempフォルダの所有者がtomcatになっているか、パーミッションが適切になっているかを確かめよう。root権限で動かしたあとにtempフォルダにrootが作ったフォルダが残っているとそれだけで動かなくなる。気が付いたら、以下のコマンドをどんどん打とう。
sudo chown -R tomcat:tomcat *
結局enforcerのバージョンを3.0.0-M3に変えて解決。
Mavenを使ってJavaを11にして、JSPWIKIを2.11.0.M7でCompileしようとすると長いエラーを吐いて失敗する。GitHubでおとしてきたものも、[1]からダウンロードしたものも同じエラーが出た。Failed to execute goal org.apache.maven.plugins:maven-enforcer-plugin:1.4.1:enforce 。。。なんだろう。まずい、JAVAをjdk11にしたのが原因かと思い、1.8に戻したが、Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile (default-compile) on project jspwiki-main: Compilation failure: Compilation failure: が出て、コンパイルできない。。ちょっと本腰入れよう→JSPWIKI Compile Error
プラグインが動かない事象の話。結局コンパイル時のバージョン違いが原因でした。
2017年12月22日に出た事象を記録します。12月27日に一旦暫定処置で解決。再発したらまた原因から調べます。
設定ファイルであるjspwiki-custom.propertiesは、TomcatのlibフォルダかWEB-INF/classesフォルダなどクラスパスが通っているところに置く[4]と書いてはある.JSPWikiのアップデートなど考えると、WEB-INFは入れ替わっちゃうから、Tomcatのlibフォルダの方が望ましいかな。 置くときは、パーミッションもちゃんとみましょう。
No jspwiki.custom.config defined for this context, looking for custom properties file with default name of: /jspwiki-custom.propertiesなどといったメッセージがでることがある。どうもちゃんと動いているけど、このIofoログが出てしまう場合が多いようだ。実際にそのプロパティファイルをいじって起動しなおして反映するか見てみるとよい。
パーミッション関係か。Windowsでこれが発生したときは、管理者権限で実行するとうまくいく時がある。例えばTomcatをStartup.batを実行するためのPowershellを管理者権限で立ち上げるなど。

今後やりたいこと#

Reference#

  1. [#1]Apache JSPWiki, https://jspwiki.apache.org
  2. [#2]Haddock Template, https://jspwiki-wiki.apache.org/Wiki.jsp?page=Haddock%20Template
  3. [#3]Bootstrap, http://getbootstrap.com/
  4. [#4]The Apache Software Foundation, JSPWIKI Documentation, https://jspwiki-wiki.apache.org/Wiki.jsp?page=Documentation
  5. [#5]https://qiita.com/kazuki43zoo/items/a365d194f5c4df28912f
  6. [#6]Re: JSPWiki: Unable to load and setup properties from jspwiki.properties, https://www.mail-archive.com/user@jspwiki.apache.org/msg00903.html