【超級詳細的小白教程】Hexo 搭建自己的博客

– 前言

這是一篇有關如何使用 Github Pages 和 Hexo 搭建屬於自己獨立博客的詳盡教程，本人是軟件工程專業本科生，目前只學習了C和C++編程語言，對網站開發的有關知識幾乎爲零，這也是我搭建好自己的博客之後寫的第一篇博客，剛開始搭建博客的時候自己也是網上各種百度，由於自己屬於小白那種，歷經了千辛萬苦才弄好，所以借這個機會寫一篇小白真正能看懂的博客搭建教程，教你一步一步走向成功的彼岸！

推薦文章： 《我爲什麼寫博客》 （By 知明所以）
　　　　 　《爲什麼你應該（從現在開始就）寫博客》 (By 劉未鵬 | Mind Hacks)

– 入門

Github Pages

Github Pages可以被認爲是用戶編寫的、託管在github上的靜態網頁。使用Github Pages可以爲你提供一個免費的服務器，免去了自己搭建服務器和寫數據庫的麻煩。此外還可以綁定自己的域名。

Hexo

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

– 安裝 Node.js

點擊此處訪問官網，按需下載相應版本，默認安裝可以了

注：本人在安裝過程中出現了Warning 1909,無法創建快捷方式，這種情況很少出現，如果在安裝過程中也有這種情況請參考百度文庫（win10系統實測可行）：《Win7安裝程序警告1909無法創建快捷方式》

– 安裝 Git

點擊此處訪問官網，按需下載相應版本，默認安裝即可
參考資料：《如何在windows下安裝GIT》 　（By 俊雨廷休）
　　　　　《Pro Git（中文版）》

– 檢驗軟件是否安裝成功

同時按下 Win 鍵和 R 鍵打開運行窗口,輸入 cmd ，然後輸入以下命令，有相應版本信息顯示則安裝成功，若不正確可以卸載軟件重新安裝，此外若安裝成功，在桌面右鍵鼠標，可以看到菜單裏多了 Git GUI Here 和 Git Bash Here兩個選項，第一個是圖形界面的Git操作，另一個是命令行

$ git --version
$ node -v
$ npm -v

– Hexo 安裝

選擇一個磁盤，新建一個文件夾，自己重命名文件夾（如：我的文件夾爲：Ｅ\TRHX_Blog），博客相關文件將儲存在此文件夾下，在該文件夾下右鍵鼠標，點擊 Git Bash Here，輸入以下 npm 命令即可安裝，第一個命令表示安裝 hexo，第二個命令表示安裝 hexo 部署到 git page 的 deployer，如圖所示即爲安裝成功

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

– Hexo 初始化配置

在剛纔新建的文件夾裏面再次新建一個 Hexo 文件夾（如：我的文件夾爲：E\TRHX_Blog\Hexo）,進入該 Hexo 文件夾右鍵鼠標，點擊 Git Bash Here，輸入以下命令，如圖所示則安裝成功

$ hexo init

Hexo 安裝完成後，將會在指定文件夾中新建所需要的文件，Hexo 文件夾下的目錄如下：

– 本地查看效果

執行以下命令，執行完即可登錄 http://localhost:4000/ 查看效果

$ hexo generate
$ hexo server

顯示以下信息說明操作成功：

INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

登錄 http://localhost:4000/ 查看效果：

– 將博客部署到 Github Pages 上

到目前爲止，我們的本地博客就成功搭建了，但是現在我們只能通過本地連接查看博客，我們要做的是讓其他人也能夠訪問我們的博客，這就需要我們將博客部署到Github Pages上

一、註冊 Github 賬戶：點擊此處訪問 Github 官網，點擊 Sign Up 註冊賬戶

二、創建項目代碼庫：點擊 New repository 開始創建，步驟及注意事項見圖：

三、配置 SSH 密鑰：只有配置好 SSH 密鑰後，我們纔可以通過 git 操作實現本地代碼庫與 Github 代碼庫同步，在你第一次新建的文件夾裏面（如：我的文件夾爲：Ｅ\TRHX_Blog） Git Bash Here 輸入以下命令：

$ ssh-keygen -t rsa -C "your [email protected]"
//引號裏面填寫你的郵箱地址，比如我的是[email protected]

之後會出現：

Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/you/.ssh/id_rsa):
//到這裏可以直接回車將密鑰按默認文件進行存儲

然後會出現：

Enter passphrase (empty for no passphrase):
//這裏是要你輸入密碼，其實不需要輸什麼密碼，直接回車就行
Enter same passphrase again:

接下來屏幕會顯示：

Your identification has been saved in /c/Users/you/.ssh/id_rsa.
Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub.
The key fingerprint is:
這裏是各種字母數字組成的字符串，結尾是你的郵箱
The key's randomart image is:
這裏也是各種字母數字符號組成的字符串

運行以下命令，將公鑰的內容複製到系統粘貼板上

$ clip < ~/.ssh/id_rsa.pub

四、在 GitHub 賬戶中添加你的公鑰

1.登陸 GitHub，進入 Settings：

2.點擊 SSH and GPG Keys：

3.選擇 New SSH key：

4.粘貼密鑰：

五、測試

輸入以下命令：注意：[email protected]不要做任何更改！

     $ ssh -T [email protected]

之後會顯示：

輸入 yes 後會顯示：

此時表示設置正確

六、配置 Git 個人信息

Git 會根據用戶的名字和郵箱來記錄提交，GitHub 也是用這些信息來做權限的處理，輸入以下命令進行個人信息的設置，把名稱和郵箱替換成你自己的，名字可以不是 GitHub 的暱稱，但爲了方便記憶，建議與 GitHub 一致

     $ git config --global user.name "此處填你的用戶名"
     $ git config --global user.email "此處填你的郵箱"

到此爲止 SSH Key 配置成功，本機已成功連接到 Github

– 將本地的 Hexo 文件更新到 Github 的庫中

一、登錄 Github 打開自己的項目 yourname.github.io

二、鼠標移到 Clone or download 按鈕，選擇 Use SSH

三、一鍵複製地址

四、打開你創建的 Hexo 文件夾（如：E:\TRHX_Blog\Hexo），右鍵用記事本（或者Notepad++、Vs Code等）打開該文件夾下的 _config.yml 文件

五、按下圖修改 _config.yml 文件並保存

六、在 Hexo 文件夾下分別執行以下命令

     $ hexo g
     $ hexo d

或者直接執行

     $ hexo g -d

執行完之後會讓你輸入你的 Github 的賬號和密碼，如果此時報以下錯誤，說明你的 deployer 沒有安裝成功

     ERROR Deployer not found: git

需要執行以下命令再安裝一次：

     npm install hexo-deployer-git --save

再執行 hexo g -d，你的博客就會部署到 Github 上了

七、訪問博客

你的博客地址：https://你的用戶名.github.io，比如我的是：https://trhx.github.io ，現在每個人都可以通過此鏈接訪問你的博客了

– 如何在博客上發表文章

博客已經成功搭建了，但是我們該怎麼寫博客呢？

一、新建一個空文章，輸入以下命令，會在項目 \Hexo\source\_posts 中生成 文章標題.md 文件，文章標題根據需要命名

     $ hexo n "文章標題"

也可以直接在 \Hexo\source\_posts 目錄下右鍵鼠標新建文本文檔，改後綴爲 .md 即可，這種方法比較方便

二、用編輯器編寫文章

md 全稱 Markdown， Markdown 是 2004 年由 John Gruberis 設計和開發的純文本格式的語法，非常的簡單實用，常用的標記符號屈指可數，幾分鐘即可學會， .md 文件可以使用支持 Markdown 語法的編輯器編輯，然後將寫好的文章（.md文件）保存到 \Hexo\source\_posts 文件夾下即可

推薦 Windows 上使用 MarkdownPad2 或者 小書匠 編輯器，macOS 上使用 Mou 編輯器，Linux 上使用 Remarkable 編輯器，Web 端上使用 簡書 ，另外可以參考我的另一篇文章：《主流 Markdown 編輯器推薦》
當我們用編輯器寫好文章後，可以使用以下命令將其推送到服務器上

     $ hexo g
     $ hexo d

或者將兩個命令合二爲一輸入以下命令：

     $ hexo d -g

現在訪問你的博客就可以看見寫好的文章啦！
參考資料：《10款流行的Markdown編輯器》 （By xiaoxiao_engineer）
　　　　　《獻給寫作者的 Markdown 新手指南》 （By 簡書）
　　　　　《認識與入門 Markdown》 （By Te_Lee）
　　　　　《markdown簡明語法》 （By 不如）
　　　　　《markdown基本語法》 （By 高鴻祥）
　　　　　《Markdown 公式指導手冊》 （By Harries）

– 如何爲博客更換自己喜歡的主題

博客也搭建好了，文章也會寫了，但是！！！默認的主題並不喜歡怎麼辦？現在，我們就來爲自己的博客更換自己喜歡的主題

點擊此處進入 Hexo 官網的主題專欄，我們可以看見有許多的主題供我們選擇

我們要做的就是把主題克隆過來，在此我們以主題 Aero-Dual 爲例，點進去我們就可以看見該主題作者的博客，鼠標滑到底，我們可以看見 Theme By Levblanc 的字樣（其他主題類似），點擊作者 Levblanc ，頁面就會跳轉到該主題所有的相關文件在 Github 上的地址，複製該地址

再打開 Hexo 文件夾下的 themes 目錄（如：E:\TRHX_Blog\Hexo\themes），右鍵 Git Bash Here，輸入以下命令：

     $ git clone 此處填寫你剛纔複製的主題地址

比如要安裝 Aero-Dual 主題，則輸入命令：

     $ git clone https://github.com/levblanc/hexo-theme-aero-dual

等待下載完成後即可在 themes 目錄下生成 hexo-theme-aero-dual 文件夾，然後打開 Hexo 文件夾下的配置文件 _config.yml ，找到關鍵字 theme，修改參數爲：theme：hexo-theme-aero-dual （其他主題修改成相應名稱即可），再次注意冒號後面有一個空格！

返回 Hexo 目錄，右鍵 Git Bash Here ，輸入以下命令開始部署主題：

     $ hexo g   
     $ hexo s

此時打開瀏覽器，訪問 http://localhost:4000/ 就可看見我們的主題已經更換了，如果感覺效果滿意，我們就可以把它部署到Github上了

打開 Hexo 文件夾，右鍵 Git Bash Here ，輸入以下命令：

     $ hexo clean  
     //該命令的作用是清除緩存，若不輸入此命令，服務器有可能更新不了主題
     $ hexo g -d

此時訪問自己的博客即可看見更換後的主題，但我們仍然需要對主題的相關配置進行修改，比如網站標題，圖標等等，Hexo 中有兩份主要的配置文件，名稱都是 _config.yml ，它們均是用於站點配置使用的。其中，一份位於站點根目錄下（比如我的：E:\TRHX_Blog\Hexo\_config.yml），主要包含 Hexo 本身整站的配置；另一份位於主題目錄下（比如我的：E:\TRHX_Blog\Hexo\themes\hexo-theme-aero-dual\_config.yml），這份配置由主題作者提供，主要用於配置主題相關的選項，一般 _config.yml 文件裏都有相關注釋，按需修改即可

參考資料：《有哪些好看的 Hexo 主題？》 （知乎）
　　　　　《Hexo | 配置》 （Hexo官方文檔）
　　　　　《hexo常用命令筆記》 （By 小弟調調）

– 爲你的 Hexo 博客配置個性域名

本人在配置域名的時候問題百出，百度的各種方法都不管用，打開網站總是 404，可能是我太笨了 　o(╥﹏╥)o　，不過好在後來終於解決了這個問題

首先我們要購買域名，阿里雲，騰訊雲都可以，也不貴，一年幾十塊錢，最便宜幾塊錢也能買到，以阿里云爲例，我購買的域名是 itrhx.com，購買過程就不贅述了，選擇阿里雲的解析平臺，來到阿里雲的管理控制檯，點擊進入域名解析列表或者直接點擊域名後面的解析

方法一：點擊添加記錄，需要添加兩個記錄，兩個記錄類型都是 CNAME ，第一個主機記錄爲 @ ，第二個主機記錄爲 www，記錄值都是填你自己的博客地址（比如我的是：trhx.github.io），保存之後域名解析就完成了！

方法二：兩個記錄類型爲 A ，第一個主機記錄爲 @ ，第二個主機記錄爲 www，記錄值都爲博客的 IP 地址，IP 地址可以 cmd 中輸入 ping 你的博客地址 獲得（比如我的：ping trhx.github.io），保存之後域名解析就完成了！

有關解析記錄類型的區別可以參考《域名解析中A記錄、CNAME、MX記錄、NS記錄的區別和聯繫》

爲了使 GitHub 接收我們的域名，還需要在博客的根目錄下添加一個名爲 CNAME 的文件（注意不要加.txt，沒有任何後綴名！），這個文件放到 Hexo 文件夾的 source 裏面，（比如我的是：E:\TRHX_Blog\Hexo\source），文件裏面填寫你的域名（加不加www都行），比如要填寫我的域名，文件裏面就寫：www.itrhx.com 或者 itrhx.com，經過以上操作，別人就可以通過 www.itrhx.com 、itrhx.com 、trhx.github.io 三個當中任意一個訪問我的博客了！你的也一樣！

有關加不加www的問題有以下區別：

如果你填寫的是沒有www的，比如 itrhx.com，那麼無論是訪問 https://www.itrhx.com 還是 https://itrhx.com ，都會自動跳轉到 https://itrhx.com

如果你填寫的是帶www的，比如 www.itrhx.com ，那麼無論是訪問 https://www.itrhx.com 還是 https://itrhx.com ，都會自動跳轉到 http://www.itrhx.com

如果你在其他平臺購買域名，或者選擇 DNSPod 等其他域名解析，操作方法大同小異，遇到問題可自行百度解決！

參考資料：《推薦幾家域名註冊服務商》 （By Jelly Bool）
　　　　　《盤點十大免費DNS域名解析服務：穩定、可靠》

– 結語

一頓操作下來雖然有點兒累，但看見擁有了自己的博客還是非常有成就感的，人生就是需要折騰，那麼現在就開始你的創作之旅吧！文章的不斷積累，你會從中受益很多的！另外，這是一篇小白寫的適用於小白的博客搭建教程，比較詳細，有這方面基礎的可以百度有簡略一點兒的教程，文中如有錯誤還請大佬指出改正！文中涉及參考資料如有侵權請聯繫我刪除！