Xowa 项目启动与配置教程

1. 项目目录结构及介绍

Xowa 是一个开源项目，它旨在将 Wikipedia 的内容转换为一个离线可用的格式。以下是项目的目录结构及简要介绍：

xowa/
├── bin/                      # 存放可执行文件
├── build/                    # 构建脚本和依赖
├── dev/                      # 开发工具和文档
├── docs/                     # 项目文档
├── lang/                     # 语言相关的文件
├── lib/                      # 外部库文件
├── plugins/                  # 插件相关代码
├── src/                      # 源代码
│   ├── core/                 # 核心代码
│   ├── gui/                  # 用户界面代码
│   ├── lang/                 # 语言处理代码
│   └── ...
├── test/                     # 单元测试和集成测试
└── xowa.xml                  # 项目配置文件

• bin/: 包含项目的可执行文件。
• build/: 存放构建项目所需的脚本和依赖。
• dev/: 包含开发过程中使用的工具和文档。
• docs/: 存放项目相关的文档。
• lang/: 包含项目支持的不同语言资源。
• lib/: 存放项目依赖的外部库。
• plugins/: 包含可以扩展项目功能的插件代码。
• src/: 源代码目录，包含了核心代码、用户界面代码、语言处理代码等。
• test/: 包含项目的测试代码。
• xowa.xml: 项目的配置文件。

2. 项目的启动文件介绍

在 bin/ 目录中，通常会找到一个名为 xowa.sh 的启动脚本（对于 Windows 用户可能是 xowa.bat）。以下是 xowa.sh 脚本的基本结构和功能：

#!/bin/bash

# 设置 Java 虚拟机的参数
JAVA_OPTS="-Xmx1024M"

# 设置 Xowa 的主类和启动参数
MAIN_CLASS="org.gnosygnu.xowa.XowaApp"
STARTUP_ARGS="..."

# 启动 Xowa
java $JAVA_OPTS -cp 'lib/*' $MAIN_CLASS $STARTUP_ARGS

该脚本设置了 Java 虚拟机的参数，指定了 Xowa 应用的主类，然后使用 Java 命令启动应用程序。

3. 项目的配置文件介绍

项目的配置文件通常是 xowa.xml，它位于项目的根目录。这个文件包含了项目的各种配置信息，例如数据库连接、日志设置、以及应用程序的其他设置。

以下是一个简化版的 xowa.xml 配置文件示例：

<xowa>
    <database>
        <driver>...</driver>
        <url>...</url>
        <username>...</username>
        <password>...</password>
    </database>
    <logging>
        <level>...</level>
        <path>...</path>
    </logging>
    <options>
        <!-- 其他配置选项 -->
    </options>
</xowa>

在 database 节点中，定义了数据库的驱动、URL、用户名和密码。logging 节点配置了日志级别和日志文件的保存路径。options 节点则可以包含应用程序的其他配置选项。

在开始使用 Xowa 之前，您可能需要根据实际情况调整这些配置项。