Harp 部署到Github頁面

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

示例用法

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

• 個人以及公司頁面
• 項目頁面

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

部署一個 GitHub 個人或者公司頁面

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

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

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

勾選 “帶有一個 README 初始化版本庫。” 這會讓你 clone 你新的版本庫。

2.克隆版本庫

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

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

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

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

harp init _harp 

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

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

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

harp compile _harp ./

5.部署到 GitHub Pages

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

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

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

下一步是什么？

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

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

---

部署一個項目頁面

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

1.克隆項目

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

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

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

cd repository
git checkout --orphan gh-pages

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

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

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

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

harp init _harp

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

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

無論何時，Harp 都可以將你的應(yīng)用編譯成 HTML、CSS以及 JavaScript。默認地，Harp 編譯創(chuàng)建一個 www 目錄。因為 GitHub Pages 是從版本庫的根目錄運行，你會希望在根目錄編譯。

harp compile _harp ./

5.部署到 GitHub Pages

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

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

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

下一步做什么？

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

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