Harp 快速入門(mén)

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

安裝 Harp Web 服務(wù)器

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

在 OS X 和 Linux 上    

使用終端應(yīng)用程序訪(fǎng)問(wèn)命令提示符。在 OS X 上，它位于應(yīng)用程序 → 實(shí)用工具 → 終端中。在 Ubuntu 上，在應(yīng)用程序 → 終端中找到它。 然后，運(yùn)行以下命令：

sudo npm install -g harp

在 Windows 上

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

npm install -g harp

創(chuàng)建應(yīng)用程序

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

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

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

啟動(dòng)網(wǎng)絡(luò)服務(wù)器

在默認(rèn)端口上啟動(dòng) Harp Web 服務(wù)器9000。

harp server --port 9000

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

編譯項(xiàng)目

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

harp compile

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

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

NODE_ENV=production sudo harp server --port 80

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

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

接下來(lái)要做的事

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