手把手教你使用GitHub Pages + Hexo搭建屬於自己的個人博客

我的博客地址:[https://ayjcsgm.github.io/]



● 前言

這是一篇有關如何使用 GithubHexo 搭建屬於自己獨立博客的詳盡教程,剛開始搭建博客的時候自己也是網上各種百度,由於自己屬於小白那種,歷經了千辛萬苦才弄好,所以借這個機會寫一篇小白真正能看懂的博客搭建教程,教你一步一步走向成功的彼岸!

推薦文章: 《我爲什麼寫博客》 (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(中文版)》

• 檢驗Git是否安裝成功

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

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

● 安裝Hexo

選擇一個磁盤,新建一個文件夾,自己重命名文件夾(如:我的文件夾爲:E\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 代碼庫同步,在你第一次新建的文件夾裏面(如:我的文件夾爲:E\TRHX_BlogGit 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 賬戶中添加你的公鑰

① 登陸 GitHub,進入 Settings

② 點擊 SSH and GPG Keys

③ 選擇 New SSH key

④ 粘貼密鑰:

• 測試

輸入以下命令:注意:[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 打開自己的項目 your name.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://ayjcsgm.github.io/ ,現在每個人都可以通過此鏈接訪問你的博客了

● 在博客上發表文章

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

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

hexo n "文章標題"

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

② 用編輯器編寫文章

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

推薦 Windows 上使用 MarkdownPad2 或者小書匠 編輯器,macOS 上使用 Mou 編輯器,Linux 上使用 Remarkable編輯器,Web 端上使用CSDN ,其他編輯器推薦可以參考我的另一篇文章:《最新主流 Markdown 編輯器推薦》

文章標題,標籤,分類,封面圖片,摘要等,可以在 Front-matter 裏面配置(Front-matter 是文件最上方以 — 分隔的區域,用於指定個別文件的變量,官方文檔:https://hexo.io/zh-cn/docs/front-matter ),舉個例子:

---
layout: 頁面佈局(配合主題文檔使用)
title: 文章名稱
date: 文章日期
comments: 文章是否開啓評論
photos: 文章封面圖(僅部分主題支持)
tags: 
  - 文章標籤一
  - 文章標籤二
categories: 文章分類
description: 文章描述,即要在首頁顯示的摘要(僅部分主題支持)
---

這裏是摘要

<!-- more -->

這裏是正文

注意:description 和 <!-- more --> 方式顯示摘要二選一即可,部分主題不支持description,每個配置英文冒號後面要空一格,不同主題配置有所差異,具體要參考主題文檔

當我們用編輯器寫好文章後,可以使用以下命令將其推送到服務器上

 $ 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 小弟調調)

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章