歡迎來到我的第一篇博客文章!今天,我想和大家分享一個非常棒的工具 — Hexo。這是一個基於 Node.js 的靜態網站生成器,專門用於建立博客。以下是我使用 Hexo 和 GitHub Pages 建立並部署我的博客的過程。
Hexo 的安裝和設置
首先,您需要在計算機上安裝 Node.js 和 npm。然後,通過以下命令安裝 Hexo:
1 | npm install -g hexo-cli |
接下來,創建一個新的 Hexo 專案:
1 | hexo init my-blog |
這樣就成功創建了一個新的博客專案!
創建新文章
創建一篇新文章很簡單,只需執行:
1 | hexo new "我的第一篇文章" |
然後,您可以在 source/_posts 目錄下找到剛創建的 Markdown 文件,開始編輯您的文章。
部署到 GitHub Pages
要將您的網站部署到 GitHub Pages,您需要先在 GitHub 上創建一個 repository。然後,修改 _config.yml 文件中的 deploy 部分:
1 | deploy: |
接著,安裝 hexo-deployer-git:
1 | npm install hexo-deployer-git --save |
最後,使用以下命令部署您的網站,第一次輸入會要求登入 GitHub 帳號:
1 | hexo deploy |
之後如果有任何修改動作,依序輸入 clean -> generate -> deploy 三行指令,避免更新不完全:
1 | hexo cl // 清除之前建立的靜態檔案 |
二三行能直接合併成 hexo g -d 能產生靜態頁面後立刻部署。
Hexo預設主題是landscape,之後如果想調整theme,可以到這裡,選擇主題,這邊以NexT為例
安裝Next
1 | cd hexo-site |
接著修改_config.yml將 theme: landscape 改為 theme: next
語言設定將 language: en 改為 language: zh-tw
然後重新啟動server
1 | hexo server |
我安裝完重新部屬至GitHub時出現了warning: LF will be replaced by CRLF in ...的錯誤。
查詢後發現問題出在換行字元
- Windows/Dos 系統,採用CR+LF表示,符號\r\n
- Mac 系統,採用LF表示,符號\n
這邊我直接修改設定
1 | git config –-global core.autocrlf false |
然後重新佈署就行。
