Harp 快速入門

本篇內(nèi)容將會指導您安裝 Harp。您將在development模式下創(chuàng)建并維護一個簡單的項目，開發(fā)模式下預處理會自動進行。而在production模式下，會緩存好預處理后的數(shù)據(jù)以獲得更好的性能。

安裝 Harp Web 服務器

首先，安裝Node.js 。雖然 Harp 使用了 Node.js，但即便不了解 Node.js, 或者沒有接觸過 JavaScript ，也是可以上手 Harp 的。在 Node.js 安裝完成后，就可以使用 Node.js 的包管理器 npm 來安裝 Harp 了。這是個基于命令行的工具。

在 OS X 和 Linux 上    

使用終端應用程序訪問命令提示符。在 OS X 上，它位于應用程序 → 實用工具 → 終端中。在 Ubuntu 上，在應用程序 → 終端中找到它。 然后，運行以下命令：

sudo npm install -g harp

在 Windows 上

如果您使用的是 Windows，NodeJS 將附帶 Node.js 命令提示符應用程序。現(xiàn)在，要通過 npm 安裝 Harp，請輸入：

npm install -g harp

創(chuàng)建應用程序

Harp 可以非常容易的提供服務，簡單到像一個 index.html 一樣。因為 Harp 有一個內(nèi)嵌的預處理器，所以你可以很方便的用模板語言來創(chuàng)建 HTML。比如，用下面的命令行來創(chuàng)建一個 index.jade 文件：

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

以上命令將會創(chuàng)建一個 hello-world 目錄用于 Harp 應用。然后，在目錄里面，一個 index.jade 被創(chuàng)建出來，然后被處理成 <h1>Hello world</h1>。

啟動網(wǎng)絡服務器

在默認端口上啟動 Harp Web 服務器9000。

harp server --port 9000

訪問localhost:9000 現(xiàn)在將顯示以下內(nèi)容：

編譯項目

你可以把 Harp 編譯后當作一個 web server 來使用。然而 Harp 是為了造出優(yōu)秀的靜態(tài)站點而生的。

harp compile

將 Harp 投入生產(chǎn)環(huán)境

為了將 Harp 投入生產(chǎn)，你只需要做如下這幾點：在生產(chǎn)環(huán)境，Harp 將緩存經(jīng)過預處理的輸出以獲得盡可能快的性能。在當前這個 case 里面，緩存 index.jade 的預處理結(jié)果。別忘了在生產(chǎn)環(huán)境里使用 production 標志位 (flag)。

NODE_ENV=production sudo harp server --port 80

你無需在生產(chǎn)環(huán)境中手工跑 Harp 來上線新版本。事實上，最簡單的辦法是使用 Harp Platform，你可以使用 Dropbox 來創(chuàng)建 Harp App，不僅如此，還能多人協(xié)作。

你還可以在 Heroku, 上面運行生產(chǎn)環(huán)境的 Harp，將 Harp 部署到 GitHub Pages， 針對 Apache Cordova/PhoneGap 編譯 Harp 應用。

接下來要做的事

上面只是一次嘗試。舉個例子，默認 Harp 應用還包括一個 .less 文件，被當成 .css 文件來處理。通過修改 LESS 文件就能調(diào)整 CSS，不需要額外配置就可以從默認 App 開始做整個項目。閱讀有關初始化默認 Harp 應用程序的更多信息。