支持的平台和系统要求
Asciidoctor 运行在 Linux、macOS 和 Windows 上，并且需要下一节中列出的受支持的 Ruby 实现之一。
我们的总体政策是，Asciidoctor 对平台版本的支持与该版本上游项目的生命周期计划保持一致。当平台版本达到其维护者主动支持的末期或生命周期结束时（以先到者为准），Asciidoctor 将不再支持它。
Ruby 运行时
Asciidoctor 需要以下 Ruby 实现之一：Ruby。
| 受支持的运行时 | 支持的版本 |
|---|---|
Ruby |
≥ 2.3 |
JRuby |
≥ 9.1 |
TruffleRuby |
≥ 20.2 |
操作系统
| 支持的操作系统 | 支持的版本 |
|---|---|
Ubuntu |
≥ 18.04 LTS |
Fedora |
≥ 36 |
macOS |
≥ macOS 11 (Big Sur) |
Microsoft |
≥ Windows 10 |
虽然社区在各种 Linux 发行版上测试 Asciidoctor，但仅在 Ubuntu 和 Fedora 上进行官方测试。
系统编码
Asciidoctor 假定您正在使用 UTF-8 编码。为了最大限度地减少编码问题，请确保您系统的默认编码设置为 UTF-8。
如果您使用的是非英语的 Windows 环境，在调用 Asciidoctor 时可能会遇到 Encoding::UndefinedConversionError。为解决此问题，我们建议将默认的外部和内部字符编码覆盖为 utf-8。您可以通过设置 RUBYOPT 环境变量来做到这一点，如下所示：
RUBYOPT="-E utf-8:utf-8"
做出此更改后，您所有的 Unicode 编码问题应该都会迎刃而解。
如果您正在使用 Eclipse 等 IDE，请确保也在其中将编码设置为 UTF-8。Asciidoctor 经过优化，可以与 UTF-8 作为默认编码配合使用。