本篇主要是部落格的搭建
Hexo + Gitee 部落格搭建詳細指南
- hexo安裝
-
- Hexo簡介
- Hexo安裝
- hexo主題修改
- Gitee配置
-
- 建立gitee公開倉庫
- 安裝部署指令
- 配置 _confing.yml
- hexo 推送
- 開啟GiteePages
- 效果
hexo安裝
Hexo簡介
Hexo是一款基于Node.js的靜态部落格架構,依賴少易于安裝使用,可以友善的生成靜态網頁托管在GitHub和Coding上。
Hexo安裝
- 安裝git,略
- 安裝node.js,略
- 安裝hexo
cmd或右鍵git bash都行,安裝hexo
npm install -g hexo-cli
hexo -v 檢視hexo版本
在這裡插入代碼片
找個blog路徑,初始化hexo,自動建立了myblog檔案夾
hexo init myblog
cd myblog
npm install
生成檔案如圖,_config.yml 為全局配置檔案
hexo g --生成網站靜态檔案到預設設定的 public 檔案夾
hexo s --啟動本地伺服器,預設位址:http://localhost:4000/
補充:hexo clean
清除緩存檔案 db.json 和已生成的靜态檔案 public。
網站顯示異常時可以執行這條指令試試。
有時候端口會被其他占用,添加 參數 -p 5000(端口号),修改即可
已經成功啟動本地hexo,效果如下
hexo主題修改
https://hexo.io/themes/
可以到這裡選個喜歡的主題模版
我選擇的是Butterfly主題
git拉取到themes檔案夾下,友善之後更新。
修改檔案名 hexo-theme-butterfly為butterfly
修改myblog檔案夾下全局配置檔案
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: butterfly
hexo s 部署下,可以看到效果
其他:
主題也可以通過npm方式安裝,這種方式就不在themes目錄下,而在node_modules目錄,詳情可以看各主題的文檔說明
Gitee配置
建立gitee公開倉庫
倉庫名必須是使用者名
各種部落格裡面倉庫都是 使用者名.gitee.io或者gitee.io,導緻通路路徑不對,樣式也沒有。
giteepages頁有使用幫助
安裝部署指令
npm install hexo-deployer-git --save
配置 _confing.yml
找到deploy,配置gitee倉庫
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repository: https://gitee.com/rainscloud/rainscloud.git
branch: master
其他
建立倉庫時的README.md描述檔案會被hexo 送出覆寫掉。
在source目錄下建立README.md
在_confing.yml配置中找到skip_render添加
skip_render: README.md
hexo 推送
hexo c -- 清除緩存json和生成的靜态檔案
hexo g --生成靜态檔案
hexo d --上傳到git
開啟GiteePages
服務裡面Gitee Pages 啟動
效果
本篇主要完成部落格的搭建,後續繼續對其中各功能進行豐富。