[筆記] 透過 Hexo + GitHub 建立個人部落格

Hexo 是一個快速、簡單且強大的網誌框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在幾秒鐘內透過漂亮的主題產生靜態檔案。

安裝需求

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

安裝Hexo

接下來透過npm安裝Hexo

1
npm install -g hexo-cli

安裝完後查看Hexo版本

1
hexo version

接下來就可以開始初始化部落格

1
2
3
hexo init blog #初始化blog
cd blog #移動到blog的根目錄
npm install # 安裝相關套件

配置GitHub

GitHub新增一個名稱為 yourname.github.io 的 Repositories

yourname 換成自己的帳號

回到剛剛創建的blog資料夾

  1. blog根目錄找_config.yml的檔案,這支檔案是用來作全域配置的文件
  2. _config.yml檔案找
1
2
deploy:
type:

改成這樣

1
2
3
4
deploy:
type: git
repository: https://github.com/yourname/yourname.github.io.git
branch: master

參數後面記得留一個空格

  1. 安裝hexo-deployer-git套件
1
npm install hexo-deployer-git --save
  1. 產生靜態文件,部署到GitHub
1
hexo d -g

等一段時間後就能到https://yourname.github.io/查看有沒有成功部署,接下來就可以開始寫文章哩。

使用 Themes Hexo 主題

Themes 選一個自己喜歡的主題,並參考官方文件做就可以了。

發布文章

創建文章

1
hexo new [postName]

前往 source / _post 資料夾中,找到創建的 [postName].md 文件,開始撰寫內容。

部署內容

1
hexo d -g    # d = 部署, g = 生成

如果想在 local 端先確認內容,可以用

1
hexo server #執行