根据 Apache 软件基金会 (ASF) 的一份或多份贡献者许可协议授权。
请参阅随附的 NOTICE 文件，了解有关版权所有权的附加信息。
ASF 将此文件授权给您，基于 Apache 许可证 2.0 版本（以下简称“许可证”）；
除非遵守该许可证，否则您不得使用此文件。
您可以在以下网址获取许可证副本：
https://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意，否则根据许可证分发的软件
均按“原样”分发，不附带任何明示或暗示的担保或条件。
请参阅许可证以了解 governing 权限和限制的具体语言。
许可证文件可在 LICENSE 中找到。
JSPWiki 是一个简单的（嗯，现在不再简单了）WikiWiki 克隆，使用 Java 和 JSP 编写。 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（或任何其他 servlet 容器）
重命名下载的 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 文件夹（或 servlet 容器中对应的等价目录）中，
放置一个 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/。 你应该会看到 Main 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。 请使用用户邮件列表而不是直接联系团队成员， 并且由于这是存储在公共档案中的公共列表，请确保在问题中不包含任何敏感信息（密码、数据等）。