安装与更新

为了简化安装，Asciidoctor 被打包成一个 gem，并发布到 RubyGems.org 上的 gem 托管服务。Asciidoctor 也作为托管包分发给流行的 Linux 发行版和 macOS。

除了在 Ruby 上运行，Asciidoctor 还可以使用 AsciidoctorJ 在 JVM 上执行，或者使用 Asciidoctor.js 在任何 JavaScript 环境（包括浏览器）中执行。

安装方法

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

  • Bundler，

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

  • macOS 的 Homebrew 或 MacPorts，

  • gem install 命令（推荐 Windows 用户使用），或者

  • Asciidoctor Docker 镜像

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

Bundler 是首选的安装方法，因为它将 gem 作用域限制在您的项目或工作区。但是，此安装方法不会在您的终端中全局公开 asciidoctor 命令。这时，包管理器会更合适。

使用操作系统包管理器安装 gem 的好处是，它会将 asciidoctor 命令添加到您的 PATH 中，并且如果您的计算机上尚未安装 Ruby 和 RubyGems 库，它会处理这些依赖项的安装。另一方面，如果您熟悉 Docker，使用 Asciidoctor Docker 镜像可以为您提供最佳的系统隔离。