[筆記] 透過 Hexo + GitHub 建立個人部落格
Hexo 是一個快速、簡單且強大的網誌框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在幾秒鐘內透過漂亮的主題產生靜態檔案。
安裝需求
安裝Hexo
接下來透過npm
安裝Hexo
1 | npm install -g hexo-cli |
安裝完後查看Hexo
版本
1 | hexo version |
接下來就可以開始初始化部落格
1 | hexo init blog #初始化blog |
配置GitHub
在 GitHub新增一個名稱為 yourname.github.io
的 Repositories
yourname
換成自己的帳號
回到剛剛創建的blog
資料夾
- 在
blog
根目錄找_config.yml
的檔案,這支檔案是用來作全域配置的文件 - 在
_config.yml
檔案找
1 | deploy: |
改成這樣
1 | deploy: |
參數後面記得留一個空格
- 安裝
hexo-deployer-git
套件
1 | npm install hexo-deployer-git --save |
- 產生靜態文件,部署到
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 #執行 |
如果不熟悉
Markdown
,Markdown如果想用線上編輯器,HackMD、markdown-editor
如果用的編輯器是
vscode
,可以看看Markdown Shortcuts跟Markdown Preview Github Styling