Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
ライセンスファイルは LICENSE にあります。
JSPWikiは、JavaとJSPで書かれたシンプルな(いや、もうシンプルではありませんが)WikiWikiクローンです。WikiWikiとは、誰でもその開発に参加できるウェブサイトです。JSPWikiは従来のWiki機能をすべてサポートしているほか、JAASを使用した非常に詳細なアクセス制御とセキュリティ統合も備えています。
さて、Wikiを始めたいですか? 以下のものが必要です:
必須:
Servlet API 3.1 をサポートするJSPエンジン。非常に簡単なインストールには Apache Tomcat をお勧めします。Tomcat 9.x 以降が推奨されますが、Tomcat 8.x もサポートされています。Tomcat 8.x で JSPWiki を実行するために必要な追加設定を参照してください。
ある程度の管理者経験... Apache や他のWebサーバーをインストールしたことがあれば、十分に対応できるでしょう。
もちろん、JSPエンジンを実行するサーバー。
JDK 11+
オプション:
このセクションは、あまり手間をかけずに非常に迅速にインストールしたい方のためのものです。より複雑なインストール(より細かい設定が可能)をご希望の場合は、以下の「インストール」セクションをご覧ください。
JSPWiki 2.1.153 以降、JSPWiki には非常に簡単なインストールエンジンが付属しています。以下の手順を実行するだけです。
https://tomcat.apache.org/ から Tomcat をインストールします(または他のサーブレットコンテナでも可)。
ダウンロードした JSPWiki.war ファイルの名前を、希望するURLに基づいて変更します(デフォルトの /JSPWiki とは異なる場合)。例えば、URL を http://.../wiki にしたい場合は、wiki.war にリネームします。この名前を以下 <アプリ名> と呼びます。このWARファイルを $TOMCAT_HOME/webapps フォルダに配置し、Tomcatを起動します。
ブラウザで http://<myhost>/<アプリ名>/Install.jsp にアクセスします。
いくつかの簡単な質問に答えます。
コンテナを再起動します。
ブラウザで http://<myhost>/<アプリ名>/ にアクセスします。
これで完了です!
$TOMCAT_HOME/lib フォルダ(またはサーブレットコンテナに応じた同等の場所)に jspwiki-custom.properties ファイルを配置します。このファイルには、JSPWiki JAR内のデフォルトの ini/jspwiki.properties ファイルに対する任意のオーバーライドを記述できます。jspwiki-custom.properties ファイルに設定されていない値については、JSPWikiはデフォルトファイルを使用します。デフォルトファイルを確認し、カスタムファイルでオーバーライドしたい値を探してください。カスタムファイルでよくオーバーライドされる値には、jspwiki.xmlUserDatabaseFile、jspwiki.xmlGroupDatabaseFile、jspwiki.fileSystemProvider.pageDir、jspwiki.basicAttachmentProvider.storageDir、log4j.appender.FileLog.File などがあります。デフォルトファイルのコメントには、適切なオーバーライド値が示されています。
カスタムファイルは WAR の WEB-INF/ フォルダに配置することもできますが、$TOMCAT_HOME/lib に保存すると、カスタマイズを再度挿入することなく JSPWiki WAR をアップグレードできます。
jspwiki-corepages.zip の内容を、新しく作成したディレクトリに解凍します。残りのドキュメントは JSPWiki-doc.zip ファイルにあります。
Tomcatを(再)起動します。
ブラウザで http://<Tomcatがインストールされている場所>/MyWiki/ にアクセスします。メインのWikiページが表示されるはずです。ページを編集したい場合は次のセクションを参照してください。
WEB-INF/jspwiki.policy ファイルは、Wikiのアクセス権限を変更するために使用します。
追加のセットアップや設定の提案については、Apache JSPWiki ウェブサイトとプロジェクトドキュメントを確認してください。
DockerイメージはASFの公式リリースではなく、便宜上提供されています。ソースからビルドすることを推奨します。
Apache JSPWiki Dockerイメージは Docker Hub で入手できます。
$ docker pull apache/jspwiki
$ docker run -d -p 8080:8080 --name jspwiki apache/jspwiki
その後、ブラウザで http://localhost:8080/ にアクセスすると、すぐに動作するWikiが表示されます!
カスタマイズやイメージの高度な使用方法については、https://jspwiki-wiki.apache.org/Wiki.jsp?page=Docker を参照してください。
このディストリビューションに含まれる ReleaseNotes および UPGRADING ドキュメントをお読みください。
質問は、jspwiki-users メーリングリストを通じてJSPWikiチームメンバーや他のユーザーに問い合わせることができます:https://jspwiki.apache.org/community/mailing_lists.html を参照してください。チームメンバーに直接連絡するのではなく、ユーザーメーリングリストをご利用ください。また、これは公開リストであり公開アーカイブに保存されるため、質問には機密情報(パスワード、データなど)を含めないように注意してください。