Asciidoctor在Linux、macOS和Windows上运行，并需要下一节列出的支持的Ruby实现之一。
我们的总体政策是将Asciidoctor对平台版本的支持与该版本的上游项目的生命周期计划相对齐。当一个平台版本结束其维护者的活跃支持或达到其生命周期终点——无论哪个先到来——Asciidoctor将不再支持它。
Ruby运行时环境
Asciidoctor 需要以下 Ruby 实现之一 {url-ruby}[Ruby^]。
| Supported Runtime | Supported Versions |
|---|---|
Ruby |
≥ 2.7 |
JRuby |
≥ 9.2 |
TruffleRuby |
≥ 22.2 |
操作系统
| 支持的操作系统 | 支持的版本 |
|---|---|
Ubuntu |
≥ 18.04 LTS |
Fedora |
≥ 36 |
macOS |
≥ macOS 11（大苏尔） |
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这样的集成开发环境，请确保那里也将编码设置为UTF-8。 Asciidoctor最优化的是将默认编码设置为UTF-8。