UI开发前提条件

一个 Antora UI 项目是基于构建在 Node.js 之上的工具,即:

您还需要 git (命令: git )来拉下项目并向其推送更新。

git

首先,确保安装了 git

git --version

如果没有,请为您的系统 下载并安装 git 包

Node.js

使用 Antora ,包括默认 UI ,需要在您的计算机上安装 Node.js 。Antora 遵循 Node.js 的发布计划,因此我们建议您选择一个活跃的长期支持(LTS)版本的 Node.js 。我们建议使用最新的活跃 Node.js LTS 版本。虽然您可以使用其他版本的 Node.js ,但 Antora 仅针对 LTS 版本进行测试。

要检查是否安装了 Node.js ,以及安装了哪个版本,打开终端并输入:

node --version

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

v10.15.3

如果命令失败并出现错误,这意味着您尚未安装 Node.js 。安装 Node.js 的最佳方式是使用 nvm ( Node 版本管理器)。请参阅 在Linux上安装nvm和Node.js ,https://docs.antora.org/antora/latest/install/macos-requirements/#install-nvm[在macOS上安装nvm和Node.js] 或 在Windows上安装nvm和Node.js 获取说明。

安装 Node.js 后,您可以继续安装 Gulp CLI 。

Gulp CLI

接下来,您将需要 Gulp CLI(又名包装器)。这个包提供 gulp 命令,用于执行项目声明的 gulp 版本。您应该使用以下命令全局安装 Gulp CLI (如果使用 nvm ,它会解析到用户目录中的一个位置)

npm install -g gulp-cli

现在已经安装了 Node.js 和 Gulp ,可以开始设置项目了。