重裝系統後,發現把環境配置的知識都忘光了,寫個教程教未來的自己,如果能幫到其他人就再好不過了。
本文大量參考了 Argvchs 的Hexo 博客搭建教程 I,事實上這篇文章的標題也是參考而來的。
同時也參考了 Kaitaku 的從零搭建 hexo 博客
0. 前言#
Hexo 是一個快速,簡單和強大的博客框架,Hexo 使用 Markdown(或其他渲染引擎)解析文章,在幾秒內,即可利用靚麗的主題生成靜態網頁。
Markdown 相關教程如下
- Markdown 官方教程
- github 官方文檔:基本撰寫和格式語法
1. 本地安裝 Git & Node.js & Hexo CLI#
- Git
https://git-scm.com/downloads
安裝完成後在桌面或任意文件夾右鍵會出現 git bash here 點擊打開 git 終端用git --version
命令檢查。
(以下如無特殊說明則命令均在 git 終端完成) - Node.js
https://nodejs.org
一般選擇 LTS(長期支持版本),安裝一路確認即可。
使用 Node.js 官方安裝程序時,請確保勾選 Add to PATH 選項(默認已勾選)
完成後使用node -v
和npm -v
兩個命令檢查。 - Hexo CLI
輸入命令npm install hexo-cli -g
並用hexo -v
檢查 - 安裝插件
部署插件:pnpm add hexo-deployer-git
,安裝後可使用hexo -d
部署 Blog 到 Github。
2.Github 相關設置#
- 配置 Github SSH 密鑰
使用ssh-keygen -t rsa -C "[email protected]"
命令生成 SSH 密鑰,(注意,填入的是自己註冊 Github 的郵箱)
使用notepad %USERPROFILE%\.ssh\id_rsa.pub
命令打開本地 SSH 密鑰文件並複製,當然你也可以從文本管理器裡打開
點擊 Github 頁面右上角的頭像進入 Settings 頁面,點擊左側的 SSH and GPG keys,點擊右上角的 New SSH key,粘貼 SSH 密鑰到 key 中,Title 不用寫,點擊 Add SSH key 添加密鑰。
在本地鍵入如下命令,綁定 Git 和 Githubgit config --global user.name "<user>" git config --global user.email "<email>"
- 配置分支
在 Github 中新建一個倉庫作為 Blog 的倉庫,倉庫名稱為<user>.github.io
,例如我的用戶名:janblank499,則倉庫名稱為janblank499.github.io
,並確保該倉庫是公開的(pubilc)
打開分支設置,第一個輸入框裡就是默認分支,(舊版為 master 新版為 main)
打開你博客根目錄的_config.yml
,設置參數。注意branch:
要與默認分支一致deploy: type: 'git' repository: ** branch: **
以上,搭建 Blog 前的設置全部完成,下一步就是在本地生成 Blog 並部署了。
下一篇:Hexo Blog 搭建教程 Ⅱ