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 8+
任意:
このセクションは、面倒なことをあまり気にせず、本当に手早くインストールしたい人のためのものです。より複雑なインストール(より多くの設定オプションを備えた)が必要な場合は、下の「インストール」セクションを確認してください。
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>/<appname>/Install.jsp を開きます。
いくつかの簡単な質問に答えます。
コンテナを再起動します。
ブラウザで http://<myhost>/<appname>/ を開きます。
これだけです!
$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://<where your Tomcat is installed>/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 を参照してください。チームメンバーに直接連絡するのではなく、ユーザーメーリングリストを使用してください。また、これは公開アーカイブに保存される公開リストであるため、質問に機密情報(パスワード、データなど)を含めないように注意してください。