開始

在安裝hexo之前，必須確認你已經安裝了Node.js和Git，并且注冊了一個Github賬號。

1.創建Github倉庫

1) 倉庫名為xxx.github.io

創建一個以"用戶名.github.io"命名的倉庫，如我的用戶名為mroccyen,那我的倉庫名為：mroccyen.github.io，倉庫默認有master分支，用于托管生成的靜態文件，再新建一個develop(名字自定)分支，用于托管后臺文件，方便以后換電腦時后臺文件不會丟失。

2) 倉庫名為其他名稱，如myblog

如果是以其他名字命名的，如myblog，則需要建立一個gh-pages分支用于托管生成的靜態文件，必須是gh-pages分支。后臺文件可以托管在master分支上，也可以放在其他的分支。

2.配置Git

設置Git的用戶名和郵件地址（郵箱就是你注冊Github時候的郵箱），打開Git Bash,鍵入：

$ git config --global user.name "username" $ git config --global user.email "email@example.com"

3.本地Git與Github建立聯系

這里介紹SSH的配置，先檢查電腦是否已經有SSH

$ ls -al ~/.ssh

如果不存在就沒有關系，如果存在的話，直接刪除.ssh文件夾里面所有文件。
輸入以下指令后，一路回車就好：

$ ssh-keygen -t rsa -C "emailt@example.com"

然后鍵入以下指令：

$ ssh-agent -s $ ssh-add ~/.ssh/id_rsa

如果出現這個錯誤:Could not open a connection to your authentication agent，則先執行如下命令即可：

$ ssh-agent bash

再重新輸入指令：

$ ssh-add ~/.ssh/id_rsa

到了這一步，就可以添加SSH key到你的Github賬戶了。鍵入以下指令，拷貝Key（先拷貝了，等一下可以直接粘貼）：

$ clip < ~/.ssh/id_rsa.pub

在github上點擊你的頭像-->Your profile-->Edit profile-->SSH and GPG keys-->New SSH key
Title自己隨便取，然后這個Key就是剛剛拷貝的，你直接粘貼就好（也可以文本打開id_rsa.pub復制其內容），最后Add SSH key。
最后還是測試一下吧，鍵入以下命令：

$ ssh -T git@github.com

你可能會看到有警告，沒事，輸入“yes”就好。

4.初始化hexo文件夾

如果建立的是xxx.github.io倉庫，到GitHub的xxx.github.io倉庫下，如果建立的是其他名字的倉庫，則到其他名字倉庫下，我這里是創建myblog，然后點擊Clone or download，復制里面的HTTPS地址。
在你本地電腦的文件夾下，右鍵Git Bash Here: 鍵入git clone 。

$ git clone https://github.com/mroccyen/myblog.git $ mkdir myblog

Hexo安裝配置

1.Hexo初始化

進入myblog文件夾

$ cd myblog

接下來只需要使用 npm 即可完成 Hexo 的安裝，如果在當前的文件夾下始終安裝失敗，到C盤里去安裝，會成功。

$ npm install -g hexo-cli

安裝 Hexo 完成后，請執行下列命令，Hexo 將會在指定文件夾中新建所需要的文件:

$ hexo init $ npm install

接下來也可以本地預覽博客，執行下列命令,然后到瀏覽器輸入localhost:4000看看。

$ hexo generate $ hexo server

輸入Ctrl+C停止服務。

2.Hexo配置

用編輯器打開 myblog/ 下的配置文件_config.yml找到：

# Deployment ## Docs: https://hexo.io/docs/deployment.html deploy:type: repository:

到GitHub的myblog倉庫下，點擊Clone or download,復制里面的HTTPS地址到repository:，添加branch: gh-pages

# Deployment ## Docs: https://hexo.io/docs/deployment.html deploy:type: gitrepository: https://github.com/mroccyen/myblog.gitbranch: gh-pages

3.完成部署

最后一步，快要成功了，鍵入指令：

$ npm install hexo-deployer-git --save $ hexo generate $ hexo deploy

輸入彈出框的用戶名與密碼(首次使用git會彈出)。
OK，我們的博客就已經完全搭建起來了，在瀏覽器輸入（當然，是你的Repository名），例如我的：myblog
每次修改本地文件后，需要鍵入hexo generate才能保存，再鍵入hexo deploy上傳文件。成功之后命令行最后兩句大概是這樣：

To https://github.com/mroccyen/myblog.git7f3b50a..128a10d HEAD -> gh-pagesINFO Deploy done: git

這樣生成的靜態文件就上傳到github的myblog倉庫中的gh-pages分支中了。最后再把myblog文件夾中的所有文件上傳到github中的myblog倉庫中的master分之中。

日常操作

1.寫文章

執行new命令，生成指定名稱的文章至 myblog\source_posts\文章標題.md 。

$ hexo new [layout] "文章標題" #新建文章

然后用編輯器打開“文章標題.md”按照Markdown語法書寫文章。
其中layout是可選參數，默認值為post。到 scaffolds 目錄下查看現有的layout。當然你可以添加自己的layout，
同時你也可以編輯現有的layout，比如post的layout默認是 myblog\scaffolds\post.md

title: { { title } } date: { { date } } tags: - tag1 - tag2 ---

我想添加categories，以免每次手工輸入，只需要修改這個文件添加如下行：

title: { { title } } date: { { date } } categories: - categories1 - categories2 tags: ---

文件標題也是md文件的名字，同時也出現在你文章的URL中，postName如果包含空格，必須用"將其包圍。
請注意，大括號與大括號之間我多加了個空格，否則會被轉義，不能正常顯示；所有文件"："后面都必須有個空格，不然會報錯。

2.提交

每次在本地對博客進行修改后，先執行下列命令提交網站相關的文件。

$ git add . $ git commit -m "你的描述" $ git push origin master

然后才執行hexo generate發布網站到gh-pages分支上。

$ hexo generate

3.本地倉庫丟失

當你想在其他電腦工作，或電腦重裝系統后，安裝Git與Node.js后，可以使用下列步驟：

1)拷貝倉庫

$ git clone https://github.com/mroccyen/myblog.git

2)配置Hexo

在本地新拷貝的myblog文件夾下通過Git bash依次執行下列指令:

$ npm install -g hexo-cli $ npm install hexo $ npm install $ npm install hexo-deployer-git --save

3)小Tips:hexo 命令

hexo new "postName" #新建文章 hexo new page "pageName" #新建頁面 hexo generate #生成靜態頁面至public目錄 hexo server #開啟預覽訪問端口（默認端口4000，'ctrl + c'關閉server） hexo deploy #將.deploy目錄部署到GitHub hexo help # 查看幫助 hexo version #查看Hexo的版本 hexo deploy -g #生成加部署 hexo server -g #生成加預覽 #命令的簡寫 hexo n == hexo new hexo g == hexo generate hexo s == hexo server hexo d == hexo deploy

轉載于:https://www.cnblogs.com/qingsp/p/6385838.html

與50位技術專家面對面20年技術見證，附贈技術全景圖

總結

以上是生活随笔為你收集整理的Github+Hexo搭建静态博客的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。