Hexo+GitHub搭建個人博客小記

views

前言:由於博客搭建完成已經過了有一段時間了,很多操作記得不太清晰,只能零碎的紀錄下來,參考意義不大。

一、安裝必要程序

Node.js

  • 打開Node.js 下載及安裝。(版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本)

Git

Xcode

  • 歷史版本 中找到自身Mac支持的最高版本,我這裡版本是12.3.1則對應的是Xcode 13.4.1,安裝即可。

Hexo

  • 使用npm安裝hexo npm install -g hexo-cli

    如果在尝试安装 Hexo 的过程中出现 EACCES 权限错误,请遵循 由 npmjs 发布的指导 修复该问题。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    #  我在安裝時也出現了這個錯誤,當時嘗試在終端執行以下:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

    command -v nvm # 執行查詢,輸出為nvm(node版本管理工具)就是成功安裝了

    nvm ls-remote # 列出可用版本
    nvm install v22.11.0 # 選擇安裝
    nvm use v22.11.0 # 使用安裝好的版本

    npm install -g hexo-cli # 再次嘗試安裝hexo
    installhexo

二、準備就緒,開始搭建

新建一个Blog文件夹

  • 打開finder,新建文件夹,用来存放博客文件。

执行指令完成初始化

  • 打開終端,鍵入cd <博客文件夾位置> 或鍵入cd 並拖入文件夾,後按回車键。
  • 执行hexo init
    hexoinit.png

三、發佈到GitHub

新建GitHub倉庫並設定為公開

  • 倉庫名命名規則:username.github.io

配置SSH key

  • 終端鍵入以下:
    1
    2
    3
    git config —global username 'username'
    git config —global user.email 'your email address'
    ssh-keygen -t rsa -C 'your email address'
  • 按三次回車鍵就可生成ssh key,或輸入以下指令查看cat ~/.ssh/id_rsa.pub
  • 打開GitHub主頁 - 設置 - SSH and GPG keys - New SSH Key,把上一步的內容拷貝進去,名稱寫hexo(隨意)然後保存即可。
  • ssh -T [email protected]鍵入測試,顯示You’ve successfully authenticated,but GitHub does not provide shell access. 即添加成功。

修改配置文件

  • 在本地的hexo文件夾裡面,找到_config.yml文件,打開修改deploy: 部分,修改並保存。
    1
    2
    3
    4
    deploy:
    type: git
    repo: https://github.com/username/username.github.io.git
    branch: main

生成並部署網站

  • 生成hexo g
  • 部署hexo d
  • 提示輸入用戶名密碼時,密碼用token代替,因為密碼已經停止支持了。
    在github - settings - developer settings - personal access tokens,添加一個token,時間設置為永久,這樣輸入一次便可以一直使用。
  • 執行hexo g -d
  • 查看博客,打開username.github.io就可以看到部署好的網頁了。

綁定自己的域名

  • settings - pages - custom domain,填入自有域名後保存。

  • 打開官方文檔,在cloudflare上添加4個A紀錄。apexdomain

  • 添加www的cname紀錄,填帳號名字username.github.io,並開啟小雲朵☁️

  • 添加兩條TXT紀錄,驗證域名。verifieddomains
    PagesAddaverifieddomain
    successfullyverified

  • 在本地hexo source 裡新增CNAME文件,寫上自己的域名,防止部署失效。

四、寫在最後

至此一個博客的搭建就已經完成了,接下來的便是撰寫文章與發布,其他的部分諸如更換主題和基礎信息修改之類的日後有需要再寫吧。

常用的hexo指令

1
2
3
4
hexo new "new post"
hexo clean # 清理緩存
hexo g -d # 生成靜態文件後部署
hexo server # 本地訪問http://localhost:4000

持續更新

持續更新:Blog相關問題及功能完善

參考:https://hexo.io/zh-cn/docs/