
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
http://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 は、誰でもその開発に参加できる Web サイトです。JSPWiki は、従来の Wiki 機能をすべてサポートするだけでなく、JAAS を使用した非常に詳細なアクセス制御とセキュリティ統合もサポートしています。
よし、Wiki をやりたいのか? 以下のものが必要だ。
必須:
Servlet API 3.1 をサポートする JSP エンジン。非常に簡単なインストールには、http://tomcat.apache.org/ の Tomcat を推奨する。 Tomcat 8.x 以降がサポートされている。
ある程度の管理者経験... Apache や他の Web サーバーをインストールしたことがあれば、十分だろう。
もちろん、JSP エンジンを実行するサーバー。
JDK 8+
任意:
このセクションは、あまり悩まずに本当に手早くインストールしたい人のためのものです。 より複雑なインストール(より強力な設定方法)をしたい場合は、以下の「Install」セクションを参照してください。
JSPWiki 2.1.153 以降、JSPWiki には非常に簡単なインストールエンジンが付属しています。 次の手順を実行するだけです。
http://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/ にアクセスします。 Main Wiki ページが表示されるはずです。 ページを編集したい場合は、次のセクションを参照してください =)。
WEB-INF/jspwiki.policy ファイルは、Wiki のアクセス権限を変更するために使用されます。
追加のセットアップと構成の提案については、Apache JSPWiki Web サイトとプロジェクトドキュメントを確認してください。
このディストリビューションに含まれる ReleaseNotes と UPGRADING ドキュメントをお読みください。
質問は、jspwiki-users メーリングリストを通じて JSPWiki チームメンバーや他のユーザーに問い合わせることができます: http://jspwiki.apache.org/community/mailing_lists.html を参照してください。 チームメンバーに直接連絡するのではなく、ユーザーメーリングリストを使用してください。また、これは公開アーカイブに保存される公開リストであるため、質問に機密情報(パスワード、データなど)を含めないように注意してください。