2、Harp 中文文档 - 快速开始

2019-07-10

目录

这份指南将会指导你安装 Harp。你将会创建并维护一个简单的项目,开发模式下能够自动进行预处理,而在生产模式下会缓存预处理的数据以获取更好的性能。

安装 Harp web server

Youtube 视频

首先,安装 Node.js。虽然 Harp 使用了 Node.js,但即便不了解 Node.js, 或者没有接触过 JavaScript ,也是可以上手 Harp 的。在 Node.js 安装完成后,就可以使用 Node.js 的包管理器 mighty npm 来安装 Harp 了。这是个基于命令行的工具。

在 OS X 和 Linux 环境下

使用任意的终端工具打开命令行。OS X 上,它位于应用->实用程序->终端。Ubuntu 上,位于应用->终端。然后,运行下面的命令:

sudo npm install -g harp

在 Windows 环境下

如果你在使用 Windows, Node.js 的安装包已经包含了一个 Node.js 的命令行程序。直接输入如下命令即可安装:

npm install -g harp

创建一个应用

Harp 可以非常容易的提供服务,简单到像一个 index.html 一样。因为 Harp 有一个内嵌的预处理器,所以你可以很方便的用模板语言来创建 HTML。比如,用下面的命令行来创建一个 index.jade 文件:

mkdir hello-world 
  cd hello-world 
  echo h1 Hello World >> index.jade

以上命令将会创建一个 hello-world 目录用于 Harp 应用。然后,在目录里面,一个 index.jade 被创建出来,然后被处理成 <h1>Hello world</h1>

启动 web server

用默认的 9000 端口启动 Harp web server。

harp server --port 9000

打开浏览器访问 localhost:9000 即可看到以下内容:

image

编译项目

你可以把 Harp 编译后当作一个 web server 来使用。然而 Harp 是为了造出优秀的静态站点而生的。

harp compile

将 Harp 投入生产环境

为了将 Harp 投入生产,你只需要做如下这几点:在生产环境,Harp 将缓存经过预处理的输出以获得尽可能快的性能。在当前这个 case 里面,缓存 index.jade 的预处理结果。别忘了在生产环境里使用 production 标志位 (flag)。

NODE_ENV=production sudo harp server --port 80

你无需在生产环境中手工跑 Harp 来上线新版本。事实上,最简单的办法是使用 Harp Platform,你可以使用 Dropbox 来创建 Harp App,不仅如此,还能多人协作。

你还可以在 Heroku, 上面运行生产环境的 Harp,将 Harp 部署到 GitHub Pages, 针对 Apache Cordova/PhoneGap 编译 Harp 应用。

接下来要做的事

上面只是一次尝试。举个例子,默认 Harp 应用还包括一个 .less 文件,被当成 .css 文件来处理。通过修改 LESS 文件就能调整 CSS,不需要额外配置就可以从默认 App 开始做整个项目。更多信息请阅读 initializing the default Harp app.