Linux要求

在本页中,您将学到:

  • 如何安装Node.js。

由于Antora是基于Node.js构建的,您需要在您的计算机上安装并运行Antora时安装Node.js(命令:nodenpmnpx)。

Node.js

您可以使用任何活跃的LTS或维护的LTS版本的Node.js与Antora一起使用,但我们建议您使用最新的活跃LTS版本,以便从最新的性能和安全增强功能中受益。 Node.js发布时间表 显示了活跃的Node.js LTS版本。

要查看您是否已安装Node.js以及其版本,请打开终端并键入:

$ node --version

您应该看到一个版本字符串,例如:

v16.20.2

如果命令失败并显示错误,这意味着您尚未安装Node.js。安装Node.js的最佳方法是使用nvm(Node Version Manager)。跳转至 安装nvm和Node.js 查找说明。

如果您的软件包管理器提供Node.js和npm软件包,并且您熟悉使用全局安装的工具,您可以选择这种方式。但是,我们认为如果您选择 nvm,您将更加成功。

如果命令返回的版本不是活跃的LTS版本,请升级到最新的Node.js LTS版本 使用nvm(或您的软件包管理器)。

如果命令返回的是活跃的Node.js LTS版本,请确保将该版本设置为您的默认版本,方法是在终端中键入以下命令:

$ nvm alias default 16

现在您已经准备好 安装Antora

安装nvm和Node.js

我们建议使用 Node Version Manager (nvm) 来管理您的Node.js安装,尽管这不是必需的。按照 nvm安装指南 在您的计算机上设置nvm。安装nvm成功后,关闭当前终端,打开一个新终端,然后返回这里。

如果在运行安装脚本后出现 nvm: command not found,那么安装过程并未成功完成。请确保遵循安装脚本发出的所有提示。如果遇到问题,请参考 安装指南 中的故障排除部分。
许多CI环境使用nvm来管理构建作业中使用的Node.js版本。通过使用nvm,您可以使您的设置与用于生成和发布生产站点的环境保持一致。

安装nvm后,打开一个新终端并安装活跃的Node.js LTS版本。

$ nvm install --lts

上述命令将安装Node.js的活跃LTS版本并自动将其设置为您的默认别名。

现在您已经设置好Node.js,您可以 安装Antora

使用nvm升级Node.js

如果您已安装nvm,但尚未安装最新的LTS版本,请在终端中键入以下命令:

$ nvm install --lts

要将最新版本的Node.js设置为任何新终端的默认版本,请键入:

$ nvm alias default 16

现在您已经使用最新的LTS版本的Node.js,您可以 安装Antora