为了简化安装过程，Asciidoctor被打包成一个gem，并发布到位于{url-rubygems}/asciidoctor[RubyGems.org^]的gem托管服务。Asciidoctor也作为一个管理包分发到流行的Linux发行版和macOS中。

Tip
 In addition to running on Ruby, Asciidoctor can be executed on a JVM using AsciidoctorJ or in any JavaScript environment (including the browser) using Asciidoctor.js.

安装方法

Asciidoctor 可以通过以下方式安装：

  • 打包程序，

  • 流行的Linux发行版的包管理器，

  • 对于macOS，是选择Homebrew还是MacPorts？

  • 建议Windows用户使用的 gem install 命令，或者

  • Asciidoctor Docker 镜像

Important
 要更新或卸载Asciidoctor，你应该使用安装时所用的相同方法。

Bundler 是首选的安装方法，因为它可以将 gem 限定在您的项目或工作区中。然而，这种安装方法并不会在您的终端中全局提供 asciidoctor 命令。这时候，包管理器会更合适。

使用操作系统的包管理器来安装gem的好处是它会将`asciidoctor`命令添加到你的PATH中，并且如果你的机器上还没有安装Ruby和RubyGems库，它会负责安装它们。另一方面，如果你熟悉Docker，那么使用Asciidoctor Docker镜像可能会为你的系统提供最好的隔离。