手把手教你使用 Hexo+Github 搭建個人博客!

搭建自己的技術博客有很多種技術方案,我知道的有 Hexo, jeklly, vuepress 等。在此我通過使用 Hexo 並結合 Github 手把手教大家搭建自己的個人博客。讓我們一起來看看吧!

1. Hexo簡介
Hexo 是一款基於 Node.js 的靜態博客框架。Hexo 使用 Markdown 解析文章,用戶在本地安裝Hexo並進行寫作,通過一條命令,Hexo即可利用靚麗的主題自動生成靜態網頁。
參考鏈接:
Hexo-Github地址
Hexo幫助文檔

2. Hexo安裝
實驗環境:Windows 10 64-bit。
安裝 Hexo 相當簡單,只需要先安裝下列應用程序即可:

  • Node.js (版本需不低於 8.10,建議使用 Node.js 10.0 及以上版本)
  • Git

如果你的電腦中尚未安裝所需要的程序,請根據以下安裝指示完成安裝。
2.1 安裝 Node.js
Node.js 下載地址
在這裏插入圖片描述
下載穩定版本就可以。下載完成無特殊要求默認安裝即可,一般不會出現問題。

2.2 安裝 Git
Git 下載地址
在這裏插入圖片描述
下載完成無特殊要求默認安裝即可,一般不會出現問題。這裏有一點需要注意的是,在下圖這一步驟如果選擇第一項,則安裝完成後會出現:
’git’不是內部或外部命令,也不是可運行的程序或批處理文件錯誤,此時需要手動添加相關路徑到系統環境變量中即可解決。

具體爲:
C:\XXX\Git\bin
C:\XXX\Git\mingw64\libexec\git-core

在這裏插入圖片描述
檢查 Node 跟 Git 版本:

$ node -v
v10.20.1

$ git --version
git version 2.25.0.windows.1

2.3 安裝 Hexo
Git 和 Node.js 都安裝好後,接下來在本地安裝 Hexo,爲了避免安裝失敗,需要切換到阿里雲的 NPM 鏡像:

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

創建一個用於存放博客文件的文件夾,如 /hexo/blog,然後進入 blog 文件夾全局安裝並初始化 Hexo,右鍵選擇 Git Bash Here ,彈出Git Bash窗口。執行命令:

$ cnpm install -g hexo-cli
$ hexo init

安裝完成後,指定文件夾的目錄如下:

├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

其中_config.yml文件用於存放網站的配置信息,你可以在此配置大部分的參數;scaffolds是存放模板的文件夾,當新建文章時,Hexo會根據scaffold來建立文件;source是資源文件夾,用於存放用戶資源,themes是主題文件夾,存放博客主題,Hexo 會根據主題來生成靜態頁面。

在Git Bash終端執行命令,生成靜態博客文件:

$ hexo g
$ hexo s
INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

Hexo 將 source 文件夾中的 Markdown 和 HTML 文件解析並放到 public 文件夾中,public 文件夾用於存放靜態博客文件,相當於網站根目錄。至此博客雛形基本完成,在瀏覽器中訪問http://localhost:4000/,如圖所示:
在這裏插入圖片描述
3. 將 Hexo 部署到 GitHub
3.1 新建 Git 倉庫
倉庫名必須爲 username.github.io 格式,其中 username 是你 GitHub 的用戶名。
在這裏插入圖片描述
按照下圖找到自己 Github 的用戶名:
在這裏插入圖片描述
3.2 部署
快速在項目根目錄下找到 _config.yml,找到 deploy 字段並填寫完整。

deploy:
  type: git
  repo: 你的倉庫地址
  branch: master

這裏注意,爲了避免出現錯誤,我把 _config.yml 中的 Git 倉庫鏈接改成了 SSH 鏈接,然後又給 Git 賬戶增加了 ssh key

具體方法如下:

要使用自動部署首先要安裝 hexo-deployer-git 工具:

$ npm install hexo-deployer-git --save

配置_config.yml中的deploy:

deploy:
 type: git
 repo: [email protected]:your_github_user_name/your_github_user_name.github.io.git
 branch: master

注意:這裏的 repo 需要設置成你 Git 倉庫的 SSH 鏈接。

命令行中輸入:

$ ssh-keygen -t rsa -C youremail(換成你的郵箱地址)

生成 ssh key。接着出現的一些步驟都可以回車跳過,如下圖:
在這裏插入圖片描述
這樣在 C/Users/Administrator/.ssh/id_rsa.pub 文件中就生成了公鑰。打開 id_rsa.pub 文件將一整串公鑰拷貝下來,進入你的 Github 賬戶設置,在 ssh and GPG keys 中新增一個 ssh key 配置 Github 賬戶的 ssh key,如下圖:
在這裏插入圖片描述
把剛剛拷貝出來的公鑰粘貼到 key 中,title 放空就好,如下圖:
在這裏插入圖片描述
驗證 ssh key:

$ ssh -T [email protected]

出現下面的語句說明你的 ssh key 已經配置好了:

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

初始化本地 Git 倉庫,設置 Git 的 user name 和 email:

$ git config --global user.name "XXX"(換成你的用戶名)
$ git config --global user.email "XXX"(換成你的郵箱地址)

在本地的 hexo init 生成的文件夾中初始化 Git 倉庫:

$ git init

將本地倉庫和遠程倉庫連接(這一步驟可以不做):

$ git remote add origin [email protected]:your_github_user_name/your_github_user_name.github.io.git(遠程倉庫ssh地址) 

做完以上這些步驟,說明你的倉庫可以使用 SSH 方式來上傳下載代碼,也不需要輸入用戶名和密碼了。最後進行網站部署,如下:

$ hexo clean  //清除緩存文件db.json和已生成的靜態文件public
$ hexo g   //生成網站靜態文件到默認設置的public文件夾
$ hexo d   //部署網站到設定的倉庫

部署成功後會提示:
在這裏插入圖片描述
這樣你的 Hexo 博客就部署到了 Github page 上了!

至此,使用 Hexo+Github 搭建個人博客的整個過程及問題解決方法到此結束,關於對個人博客進行美化、設計等內容我將會再寫一篇CSDN博客予以說明,各位小夥伴如果遇到問題請在評論區留言,我會及時回覆幫助你解決!

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