Asciidoctor-fopub 项目使用教程

1. 项目的目录结构及介绍

Asciidoctor-fopub 是一个用于将 DocBook 转换为 PDF 的工具，它基于 DocBook XSL 和 Apache FOP。以下是项目的目录结构及其介绍：

asciidoctor-fopub/
├── bin/
│   └── fopub                # 启动脚本
├── docbook-xsl/             # DocBook XSL 样式表
├── fonts/                   # 字体文件
├── lib/                     # 依赖库
├── samples/                 # 示例文件
├── src/                     # 源代码
├── templates/               # 模板文件
├── README.adoc              # 项目说明文档
├── LICENSE                  # 许可证文件
└── fopub.sh                 # 启动脚本（Linux/Mac）

• bin/：包含启动脚本 fopub。
• docbook-xsl/：包含 DocBook XSL 样式表，用于格式化输出。
• fonts/：包含字体文件，用于 PDF 生成。
• lib/：包含项目依赖的库文件。
• samples/：包含示例文件，用于测试和参考。
• src/：包含项目的源代码。
• templates/：包含模板文件，用于自定义输出格式。
• README.adoc：项目说明文档。
• LICENSE：许可证文件。
• fopub.sh：启动脚本（适用于 Linux/Mac 系统）。

2. 项目的启动文件介绍

项目的启动文件主要是 bin/fopub 和 fopub.sh。

• bin/fopub：这是一个 Bash 脚本，用于在 Windows 系统上启动 Asciidoctor-fopub。
• fopub.sh：这是一个 Bash 脚本，用于在 Linux/Mac 系统上启动 Asciidoctor-fopub。

使用方法：

# Windows
bin/fopub <input_file.xml>

# Linux/Mac
./fopub.sh <input_file.xml>

3. 项目的配置文件介绍

Asciidoctor-fopub 的配置文件主要是 fopub.sh 和 bin/fopub 脚本中的环境变量设置。

• JAVA_HOME：指定 Java 的安装路径。
• PATH：包含 Java 和 Asciidoctor-fopub 的路径。

示例：

# 设置 JAVA_HOME
export JAVA_HOME="C:\Program Files\Java\jdk1.8.0_171"

# 更新 PATH
export PATH=$JAVA_HOME/bin:$PATH

确保这些环境变量正确设置后，即可使用 fopub 或 fopub.sh 脚本启动项目。

---

以上是 Asciidoctor-fopub 项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。