我的博客地址:[https://ayjcsgm.github.io/]
● 前言
這是一篇有關如何使用 Github 和 Hexo 搭建屬於自己獨立博客的詳盡教程,剛開始搭建博客的時候自己也是網上各種百度,由於自己屬於小白那種,歷經了千辛萬苦才弄好,所以借這個機會寫一篇小白真正能看懂的博客搭建教程,教你一步一步走向成功的彼岸!
推薦文章: 《我爲什麼寫博客》 (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 Here 和 Git 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_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 賬戶中添加你的公鑰
① 登陸 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 小弟調調)