使用 Wagtail 开发项目,很可能需要编写一些 JavaScript 代码。如果你只需要写很少的 js 代码,当然你可以不配置 NodeJS 环境;如果你要使用 TailwindCSS,或者编写比较多的代码,那么就需要配置 NPM。

安装 NodeJS

本文提供在 Windows 和 Debian 系统上安装 NodeJS 的方法,其他 Linux 发行版或者 FreeBSD 安装 NodeJS 的方法与 Debian 类似。

Debian 系统安装 NodeJS

更新系统的本地软件源:

sudo apt update

安装 nodejs 软件包:

sudo apt install nodejs

Windows 安装 NodeJS

  1. NodeJS 官网 下载 NodeJS 软件包,推荐下载 LTS 长期服务支持版,选择相应的系统版本。
  2. 双击 MSI 文件安装 NodeJS:
  3. 默认会把安装路径添加到 PATH
  4. 推荐选中:Automaticlly install necessary tools
  5. 验证是否安装成功:在 cmd 内运行命令 node -v

初始化 npm 项目

在 wagtail 项目的根目录运行如下命令初始化 npm 项目:

npm init -y

如上命令的主要作用是在项目的根目录创建 package.json 文件。

配置 NPM 国内镜像

为 npm 配置国内镜像能够加速 npm 软件包的下载,如果不配置国内镜像软件包的下载速度非常的慢:

在初始化项目后,再配置 npm 的国内镜像:

npm config set registry http://registry.npmmirror.com

如上命令会配置项目专用的 npm 国内镜像,配置文件为:<项目根目录>/.npmrc