Hexo + GitHub 搭建個人博客

Hexo 簡介

來自官方的描述:

A fast, simple & powerful blog framework, powered by Node.js.

簡單清晰:由 Node.js 驅(qū)動,快速、簡單、強(qiáng)大的博客框架


安裝 Hexo 框架

來自官方安裝教程:

  1. 前提條件
  2. 安裝 Hexo 框架
  3. 初始化博客目錄

1.前提條件:

請確保以下軟件已被安裝:
Node.jsGit

2. 安裝 Hexo

npm i hexo-cli -g

3. 初始化博客目錄

hexo init blog

目錄說明

這里 Hexo 博客框架就安裝完了,不過還是對博客主目錄進(jìn)行一些簡短的說明:

├── _config.yml # 站點配置文件
├── package.json # webpack 配置文件
├── scaffolds # 模版文件夾
├── source # 資源文件夾
|   ├── _drafts # 文章草稿文件夾
|   └── _posts # 文章發(fā)布文件夾
├── public # 文章部署文件夾
└── themes # 主題文件夾

這里只提一點:
在發(fā)布部署過程中,source 目錄下的文件會被解析或拷貝至 public 目錄。

  • source/_posts 中所有的 Markdown 和 HTML 文件會被解析并放到 public 目錄
  • source 中的其余目錄會完整拷貝至 public 目錄

發(fā)布到 Github

想使用 Github 發(fā)布 Hexo 的博客,主要有以下兩個步驟:

  1. 在 Github 創(chuàng)建相關(guān)倉庫
  2. 配置 hexo-deployer-git 插件

1. 在 Github 創(chuàng)建相關(guān)倉庫

創(chuàng)建和 Github 賬號同名的倉庫,規(guī)則如下:
例如:GitHub 賬號為 iDukelu,則倉庫名應(yīng)創(chuàng)建為 iDukeLu.github.io

2. 配置 hexo-deployer-git 插件

  • 安裝 hexo-deployer-git 插件
npm i hexo-deployer-git -s

注:Hexo 3.0 以后,使用 Git 進(jìn)行提交需先安裝hexo-deployer-git 插件,否則,直接使用 Git 提交會報錯:ERROR Deployer not found: github

  • 修改站點配置文件 _config.yml 如下:
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/iDukeLu/iDukeLu.github.io.git
  # repo: git@github.com:iDukeLu/iDukeLu.github.io.git 配置了 ssh 后的地址
  branch: master

簡單說明下著幾個參數(shù):

  • type:部署方式
  • repo:部署的 gi t 倉庫地址(可用使用 https 或 ssh)
  • branch:git 倉庫分支

至此,原生的 Hexo 博客框架就已經(jīng)部署到了 Github 上了,可以通過 https:iDukeLu.github.io,進(jìn)行訪問查看博客站點的內(nèi)容了


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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容