Apache JSPWiki 使用与安装指南

Apache JSPWiki 是一个基于Java和JSP技术构建的成熟开源Wiki引擎，它提供了丰富的特性，并且围绕J2EE标准组件设计。本指南将引导您了解其主要的目录结构、启动流程以及关键配置文件的解析，帮助您快速上手并配置JSPWiki。

1. 项目目录结构及介绍

Apache JSPWiki 的源代码克隆自 GitHub，其典型项目结构大致如下：

apache-jspwiki/
├── build.gradle            - Gradle构建脚本，用于编译和打包项目。
├── src/
│   ├── main/               - 主要源代码存放区。
│   │   ├── java/           - Java源码文件，包括核心逻辑实现。
│   │   └── webapp/         - Web应用程序资源，如JSP页面、静态资源等。
│   └── test/               - 测试源代码目录。
├── pom.xml                 - Maven兼容的项目对象模型（虽然主要使用Gradle，但包含Maven兼容信息）。
├── README.md               - 项目快速入门指导。
├── LICENSE                 - 许可证文件，明确软件使用的权利与限制。
└── ...                     - 其他辅助文件和文档。

2. 项目的启动文件介绍

JSPWiki作为一个Web应用，通常不需要单独的“启动文件”来运行，而是作为Java Web容器（如Tomcat, Jetty等）中的一个应用部署。部署过程一般涉及以下步骤：

1. 编译与打包: 使用Gradle命令 gradle war 来编译源代码并生成.war文件。
2. 部署: 将生成的.war文件复制到Web容器的webapps目录下。
3. 启动容器: 启动你的Java Web容器（例如执行 ./catalina.sh run 命令在Tomcat中）。
4. 访问: 通过浏览器访问JSPWiki，通常默认地址是 http://localhost:8080/JSPWiki（具体端口可能依据配置有所不同）。

3. 项目的配置文件介绍

web.xml

位于 src/main/webapp/WEB-INF/web.xml，这是所有Servlet应用的基础配置文件，定义了初始化参数、Servlet映射等。在这里可以设置JSPWiki的基本行为，比如上下文参数等。

jspwiki.properties

JSPWiki的核心配置文件，通常不直接位于Git仓库的根目录中，但在部署时，你需要提供或创建此文件。这个文件包含了JSPWiki的大多数可配置选项，如数据库连接、页面存储位置、权限控制等。例如：

jspwiki.pagelockonwrite=true     # 是否在编辑时锁定页面
jspwiki.fileSystemProvider.rootDirectory=wikidir   # 页面存储目录

确保在部署前根据实际需求定制jspwiki.properties，以符合你的环境配置。

---

通过以上步骤，您可以对Apache JSPWiki进行编译、部署和基本配置。详细配置和高级功能的利用则需要深入阅读官方文档和源代码注释来进一步探索。