Harp 部署到Github頁(yè)面

Github Pages，也被稱作 gh-pages，是 Github 為公共網(wǎng)頁(yè)提供的免費(fèi)主機(jī)服務(wù)。它通常被用來(lái)放個(gè)人博客以及網(wǎng)站項(xiàng)目。 如果你對(duì)在命令行下使用 git 比較熟悉，那么把你的 Harp 應(yīng)用部署到 Github Pages 應(yīng)該不是什么難事。

示例用法

可以有兩種不同的方法使用 GitHub Pages：

• 個(gè)人以及公司頁(yè)面
• 項(xiàng)目頁(yè)面

在 GitHub Pages documentation，你可以閱讀更多關(guān)于兩種頁(yè)面的區(qū)別。

部署一個(gè) GitHub 個(gè)人或者公司頁(yè)面

這五個(gè)步驟將會(huì)迅速帶你將一個(gè) Harp 應(yīng)用部署到個(gè)人或者公司 GitHub 頁(yè)面上。

1.創(chuàng)建一個(gè)新的版本庫(kù)

創(chuàng)建一個(gè)叫做 your-github-user-name.github.io 的新的版本庫(kù)，用你自己的個(gè)人或者公司名稱替代 “your-github-user-name”。假如你的用戶名是 octocat，那么創(chuàng)建一個(gè)叫做 octocat.github.io 的版本庫(kù)。

勾選 “帶有一個(gè) README 初始化版本庫(kù)?！?這會(huì)讓你 clone 你新的版本庫(kù)。

2.克隆版本庫(kù)

終端中，clone 你剛剛創(chuàng)建的版本庫(kù)：

git clone https://github.com/your-github-user-name/your-github-user-name.github.io.git

3.初始化 Harp 應(yīng)用

你的版本庫(kù)準(zhǔn)備好了，你只需要再創(chuàng)建一個(gè) Harp 應(yīng)用。在 _harp 中初始化一個(gè)新的 Harp 應(yīng)用。

harp init _harp 

如果你有一個(gè)現(xiàn)成的項(xiàng)目，你有可能也想將它移動(dòng)到你的工作目錄中，但是必須確保文件夾名稱以一個(gè)下劃線開(kāi)始；當(dāng)你部署到 GitHub Pages 時(shí)，你不會(huì)想要你的源代碼被運(yùn)行。

4.編譯你的 Harp 應(yīng)用

只要你喜歡，Harp 可以將你的應(yīng)用編譯成 HTML、CSS 以及 JavaScript。默認(rèn)的，Harp 編譯器創(chuàng)建一個(gè) www 目錄。因?yàn)?Github Pages 是從版本庫(kù)的根目錄運(yùn)行，你會(huì)希望在根目錄編譯你的 Harp 應(yīng)用。

harp compile _harp ./

5.部署到 GitHub Pages

你已經(jīng)準(zhǔn)備好部署你的應(yīng)用了！添加全部的文件，提交它們，然后將它們 push 到 GitHub上：

git add -A
git commit -a -m "First Harp + Pages commit"
git push origin master

接下來(lái)的十分鐘內(nèi)，你的應(yīng)用將會(huì)在 your-github-name.github.io 可以訪問(wèn)。

下一步是什么？

您的 Harp 應(yīng)用已經(jīng)被成功地部署到 GitHub Pages?，F(xiàn)在，你應(yīng)該會(huì)想自定義它。閱讀 五個(gè)簡(jiǎn)單規(guī)則，快速開(kāi)始修改 Harp 應(yīng)用的模板。     

如果你想通過(guò) GitHub pages 使用一個(gè)自定義的域名，遵循 GitHub Pages documentation 的指導(dǎo)。

---

部署一個(gè)項(xiàng)目頁(yè)面

這五步會(huì)快速帶你部署一個(gè) Harp 應(yīng)用到一個(gè)項(xiàng)目的 GitHub Page。

1.克隆項(xiàng)目

git clone https://github.com/your-github-name/repository-name.git

2.創(chuàng)建一個(gè)新的，干凈的分支

下一步，你將需要在應(yīng)用的現(xiàn)有版本庫(kù)中創(chuàng)建一個(gè)新的 "orphan" 分支。這個(gè)分支將會(huì)包含你的 Harp 應(yīng)用，編譯完的HTML、CSS 以及JavaScript 將會(huì)通過(guò) GitHub Pages 運(yùn)行。

cd repository
git checkout --orphan gh-pages

現(xiàn)在，從分支中清空現(xiàn)有的文件，這樣一個(gè) Harp 應(yīng)用可以取而代之。

# Always ensure you’re in the right place before deleting files with this command
git rm -rf .

3.初始化一個(gè) Harp 應(yīng)用

你的版本庫(kù)準(zhǔn)備好了，你還需要一個(gè) Harp 應(yīng)用。在 _harp 中初始化一個(gè)新的 Harp 應(yīng)用。

harp init _harp

如果你已經(jīng)有了一個(gè)項(xiàng)目，你也可以將它移動(dòng)到你的工作目錄中，但是確保在文件名的開(kāi)頭添加一個(gè)下劃線；當(dāng)你部署到 GitHub Pages 是，你不會(huì)想你的源代碼文件被運(yùn)行。

4.編譯你的 Harp 應(yīng)用

無(wú)論何時(shí)，Harp 都可以將你的應(yīng)用編譯成 HTML、CSS以及 JavaScript。默認(rèn)地，Harp 編譯創(chuàng)建一個(gè) www 目錄。因?yàn)?GitHub Pages 是從版本庫(kù)的根目錄運(yùn)行，你會(huì)希望在根目錄編譯。

harp compile _harp ./

5.部署到 GitHub Pages

你已經(jīng)準(zhǔn)備好了部署你的應(yīng)用！添加所有的文件，提交它們，然后 push 到 GitHub：

git add -A
git commit -a -m "First Harp + Pages commit"
git push origin gh-pages

你的應(yīng)用將會(huì)在下面的十分鐘內(nèi)在 your-github-name.github.io/repository-name 可以訪問(wèn)。

下一步做什么？

你的 Harp 應(yīng)用已經(jīng)被成功地部署到GitHub Pages 上?，F(xiàn)在，你可能想自定義它。閱讀五個(gè)簡(jiǎn)單規(guī)則，快速上手開(kāi)發(fā) Harp 應(yīng)用的模板。

如果你想使用 GitHub Pages 的自定義頁(yè)面，遵循 GitHub Pages documentation 上的指導(dǎo)。