【教程向】——基於hexo+github搭建私人博客

• 前言

1.github pages服務生成的全是靜態文件，訪問速度快； 2.免費方便，不用花一分錢就能夠搭建一個自由的我的博客，不須要服務器不須要後臺； 3.能夠隨意綁定本身的域名，不仔細看的話根本看不出來你的網站是基於github的； 4.數據絕對安全，基於github的版本管理，想恢復到哪一個歷史版本都行； 5.博客內容能夠輕鬆打包、轉移、發佈到其它平臺；

<!--more-->

---

• hexo、git配置和安裝

  什麼是hexo？

Hexo 是一個快速、簡潔且高效的博客框架。Hexo 使用 Markdown（或其餘渲染引擎）解析文章，在幾秒內，便可利用靚麗的主題生成靜態網頁。

---

安裝

安裝hexo只須要幾分鐘，但前提是你的確保你的電腦中已經安裝了下列應用程序：

---

下載必須程序

• node.js

Node.js是一個Javascript運行環境(runtime)

• Git

Git是一個開源的分佈式版本控制系統，用以有效、高速的處理從很小到很是大的項目版本管理。 從上面連接下載git for windows最好掛一個代理，不然下載速度會十分緩慢，你能夠參考**這個頁面**,其中收錄了存儲於百度雲的下載地址。

下載以後你能夠在你想要建立博客的位置新建一個文件夾，進行node.js和git的安裝，打開安裝包，按順序安裝便可。 安裝完成後能夠打開cmd命令行檢查是否安裝完成：

---

hexo安裝

打開git命令行輸入如下代碼安裝hexo

$ npm install -g hexo-cli

---

• 建站

安裝好hexo後執行下列操做來生成所須要的文件

初始化

在你的電腦選取一個你想要存放這個網頁的代碼的文件夾，而後在裏面新建一個hexo文件夾。

在git命令行中輸入：

$ cd /d/網頁設計/hexo
$ hexo init

下載完成後，會在對應的hexo文件中自動生成對應文件。

生成文件和啓用預覽服務

在git命令行中輸入如下命令：

$ hexo g # 生成
$ hexo s # 啓動服務

會在public文件中生成相關的HTML文件。

用來啓用本地預覽服務，啓用後就能夠經過**http://localhost:4000/**來預覽博客內容。 [站外圖片上傳中...(image-664f86-1553673077649)] 若是一切順利，訪問以上預覽連接應當出現這樣的一個默認博客主頁。 至這一步，一個基於hexo的blog就搭建完成了。

---

如何將博客部署到github

在生成博客初始頁面後，咱們的博客還不算完成，由於咱們只能看到的知識hexo提供的一個本地預覽網頁，別人是看不到的，那麼如何才能讓別人也能夠訪問的到咱們的博客呢，那就須要咱們把博客部署到網上了，這裏，我選擇的是github。

---

註冊github帳戶和新建倉庫

首先，咱們須要在github上有一個帳戶。

github官網

點擊連接進入github官網註冊。 註冊好以後點擊sign in登陸github。

點擊new repository新建一個名爲<code>你的用戶名.github.io</code>的倉庫。如個人用戶名是gemuxiaoshe，那麼我就須要新建一個<code>gemuxiaoshe.github.io</code>的倉庫，這樣你以後的網站地址就能夠直接使用**https://gemuxiaoshe.github.io/**訪問倉庫了。

---

配置SSH key

爲何要配置這個呢？由於你提交代碼確定要擁有你的github權限才能夠，可是直接使用用戶名和密碼太不安全了，因此咱們使用ssh key來解決本地和服務器的鏈接問題。

---

咱們在github命令行中輸入如下命令來檢測本機已存在的ssh密匙

$ cd ~/. ssh #檢查本機已存在的ssh密鑰

若是提示：No such file or directory 說明你是第一次使用git。

ssh-keygen -t rsa -C "郵件地址"

在github命令行中輸入以上命令，而後連續三次回車。最後會在你的用戶目錄下生成一個id_rsa.pub文件, 找到並打開它（能夠直接使用記事本打開），複製裏面的所有內容，而後打開你的github主頁，進入我的設置 -> SSH and GPG keys -> New SSH key： 將剛複製的內容粘貼到key那裏，title隨便填，保存。

輸入如下命令測試SSH key是否配置成功

$ ssh -T git@github.com # 注意郵箱地址不用改

若是提示Are you sure you want to continue connecting (yes/no)?，輸入yes

Hi liuxianan! You've successfully authenticated, but GitHub does not provide shell access.

看到這個信息說明SSH已配置成功！

最後咱們還須要配置：

$ git config --global user.name "liuxianan"// 你的github用戶名，非暱稱
$ git config --global user.email  "xxx@qq.com"// 填寫你的github註冊郵箱

---

部署代碼到github上

在配置還SSH key以後，咱們上傳代碼就很容易了

---

這時候咱們還不能直接使用hexo d 上傳代碼，由於咱們還有_config.yml沒有配置。 打開_config.yml站點配置文件,目錄爲：<code>D:\網頁設計\hexo_config.yml</code> 找到<code>deploy</code>關鍵詞進行以下配置：

deploy:
  type: git
  repository: git@github.com:liuxianan/liuxianan.github.io.git #你的用戶名和你新建的倉庫名
  branch: master

配置成功以後，咱們能夠嘗試使用hexo d 來上傳咱們的代碼，但這個時候應當是沒法上傳成功的。 它會出現如下內容：

Deployer not found: git

表示它沒有發現git

這是由於咱們還須要安裝一個插件：

npm install hexo-deployer-git --save

安裝成功後咱們就能夠開始上傳咱們的代碼了 首先咱們用<code>hexo g</code>來生成一下文件

$ hexo g

再輸入如下命令上傳代碼到github上：

$ hexo d

上傳成功！以後你能夠登陸你的github主頁查看代碼是否上傳成功。 而且能夠直接使用你以前設置好的倉庫地址https://gemuxiaoshe.github.io/登陸到你的博客主頁了。

---

博客的進階學習主題的更改和優化以及博客的建立和編寫

至此，博客搭建纔算正式完成，你的博客將能夠被訪問到。不過到目前咱們只是剛剛建立了一個默認的博客主頁，和一篇默認的博客，且這個默認主頁固然是不可能讓咱們滿意的，而且其功能也確定會有所不足。那麼咱們首先，咱們還須要進行的最基本的工做就是學習如何修改和優化咱們的主題，而且學習博客的建立和編寫。

關於博客的建立和編寫能夠參考個人另兩篇博文

• 這是一篇測試博客 主要介紹了博文的兩種建立方式。
• markdown語言中基本標籤的使用 主要介紹了博文編寫所較常使用的markdown標記語言的基本使用方法

關於博客主題的修改和優化能夠參考下面的網站，在這裏就不進行詳細過程的介紹了

• NexT 使用文檔

NexT 一款基於hexo的主題，NexT 使用文檔詳細的介紹了基於hexo的主題NexT的使用方法，和NexT主題的配置方法，以及各類第三方服務的配置方法，同時也包括一些基本的站點文件配置。其中配置方式是適用於多種主題的。

• hexo的next主題個性化教程:打造炫酷網站 一個簡書上的Next主題的個性化配置教程，其中還包括一些Next使用文檔所沒有的進階配置，比較詳細的介紹了主題的各類個性化配置。。

---

關於分享功能實現的補充

因爲我使用的百度分享和jiathis分享均出現了問題，而且並無找到解決的辦法，因而使用了另一個第三方分享服務sharesdk。

• 具體實現方法請點擊下面連接 爲Hexo NexT主題添加ShareSDK的分享

• 關於分享功能的的嘗試結果

在最終嘗試了各類分享服務後仍是發現個人分享功能仍是沒能在基於github上實現，在網上也沒有找到相關的問題描述和解決方式。很是遺憾只能暫時放棄分享功能的使用。在以後的過程當中再來補充。

---

參考

---

• hexo使用文檔 hexo的官方使用文檔，十分詳細的總結概括了hexo的各類使用方法。

• 小茗同窗的博客園 一個比較詳細的hexo+github搭建博客的教程

• hexo的next主題個性化教程:打造炫酷網站 一個next主題修改優化教程

• NexT 使用文檔 next主題的官方使用文檔，十分詳細的介紹了next主題的各類使用方法