前言:
為何選用 Hxeo 來當作 Blog 框架?
- 因為建立於本地端,所以可以更方便離線進行編輯
- 使用
Markdown
語法撰寫 Blog,更方便、通用、容易上手 - 搭配線上
CICD
工具部署於Github
上,完全零成本 - 中文文件資源多
- 支援多樣不同樣板,可隨心所欲切換風格
- 開源社群活躍
- 基於 NodeJs 擁有豐富的插件
建立自己的 Hexo:
安裝 Node.js
首先要安裝 Node.js
再來進入cmd
node -v
確認是否安裝成功
安裝 Hexo-cli
一樣進入cmd
,使用下列指令安裝 Hexo
npm install hexo-cli -g
接著使用cmd
的cd
指令進入 Hexo 資料夾的目錄中
使用hexo cli
幫助我們快速建立 Blog 的環境
hexo init blog #建立一個 blog 資料夾, hexo 會複製對應的文件到此資料夾中
npm install #安裝相關套件
若要把 Hexo deploy 到 Github 上面,需要先安裝
npm install hexo-deployer-git –save
Hexo config.yml 設定說明
安裝完後再進入 Hexo 資料夾下的_config.yml
檔案中
並將 type, repo, branch 設定如下
deploy:
type: git
repo: git@github.com:userName/blog.git
branch: gh-pages
寫作指令:
Hexo 替我們生成一個叫 “Post title” 的 Markdown 文件(post title 即為文章標題)
hexo new “post title”
輸入完指令後,進到 Hexo 資料夾中的 source 資料夾中,便會看到一個 post-title.md 的 markdown 文件,即可進行編輯。
若要生成草稿文件(draft):
(草稿頁面不會被 Hexo 渲染生成,但可以預覽其效果,也就是最後的靜態網站不會存在草稿文章。)
hexo new draft “Draft title”
若要生成純頁面(page):
(Hexo 文件夾中的 scaffolds 預設有三種形式的模板:草稿 draft、純頁面 page、文章 post)
(使用者也可以加入自訂的頁面格式,將指令後的 page, draft, post 改為自訂的模板名稱即可)
hexo new page “Page title”
清除快取檔案 (db.json) 和已產生的靜態檔案 (public)
hexo clean
輸入 Hexo 生成網頁的指令 (generate)
hexo g
輸入生成 Hexo 伺服器的指令 (server)
hexo s #會產生 Localhost 來提供使用者查看
若確定 blog 沒問題,則使用以下指令將更新過後的 blog deploy 至 GitHub 上
hexo d
此文作者:Walter Chang
此文地址: http://lazybonejc.github.io/blog/2021/12/29/HexoBlog寫作指令教學/
版權聲明:本網誌所有文章除特別聲明外,均採用 CC BY-NC-SA 3.0 TW 許可協議。轉載請註明出處!