Gitee Pages搭建博客

安裝Volta及NodeJS

參見文章NodeJS使用volta進行版本管理

安裝hexo

  參見hexo官方文檔進行安裝：https://hexo.io/zh-cn/docs/
  其中提供了兩種安裝hexo的方式，一種為全局安裝，一種為局部安裝

• 全局安裝
  執行npm install -g hexo-cli
  因為采用了volta進行nodejs進行版本管理，所以執行上述命令報
  

  執行volta run --npm install -g hexo-cli，報
  

  執行volta install hexo-cli
  

• 局部安裝
  局部安裝有兩種方式

  1. 找一個目錄新建一個臨時文件夾，在該目錄局部安裝hexo，比如D:\workspace\nodejs\temp

  cd D:\\workspace\\nodejs\\temp
  npm install hexo
  npx hexo init D:\\workspace\\nodejs\\fortuneju-blog-hexo
  

  此時便可在fortuneju-blog-hexo目錄初始化hexo文件及結構
  以后如若執行hexo的命令，先進入到D:\workspace\nodejs\temp目錄下進行操作

  2. 在D:\\workspace\\nodejs\\fortuneju-blog-hexo 目錄直接執行npx hexo init

  兩種局部安裝方式類似，只不過第一種方式是將hexo安裝到指定目錄，每次到該目錄執行npx hexo <cmd> 都是讀取的該目錄下局部安裝的hexo；
  而第二種方式直接執行npx hexo <cmd>是每次都會在配置的node_cache目錄中臨時安裝npx，hexo，每次執行完命令就會清空cache，所以每執行一次npx hexo命令就會下載一次npx hexo，所以會比較費時一點。

注意

• 無法執行hexo xxx命令請檢查是否在環境變量->用戶變量的PATH中配置了%VOLTA_HOME%/bin目錄，具體參照上方安裝Volta的文章
• volta install <package name>因網絡原因安裝失敗，請參照上方安裝Volta的文章進行解決

安裝hexo volantis主題

參見volantis官方教程 https://volantis.js.org/v2/getting-started/index.html
官方文檔中安裝了 Hexo 搜索的依賴包和 stylus 渲染器

• 如果要使用微信分享，則需要安裝插件：

  npm i -S hexo-helper-qrcode
  

• 要開啟RSS訂閱，需要安裝插件hexo-generator-feed

  npm install hexo-generator-feed
  

  在根目錄的_config.yml中配置

  #Feed Atom
  feed:
    type: atom
    path: atom.xml
    limit: 20
  theme_config:
    rss: /atom.xml
  

  具體參考：https://www.jianshu.com/p/51cc016a1933
• 部署到git服務器，需要安裝 hexo-deployer-git

  npm install hexo-deployer-git --save
  

hexo的配置和volantis主題配置

hexo的全局配置是在根目錄下的_config.yml文件中，/themes/volantis/_config.yml文件是volantis主題的配置，所有主題配置的內容都可以在hexo的_config.yml中theme_config:屬性下進行配置，並且會合並並且覆蓋主題中的配置。
所以將主題中需要修改的部分放在hexo的配置文件的theme_config屬性下，從而可以不對主題下的所有文件進行修改。
主題配置，hexo的theme_config配置，Front-matter（頁面上方---分割的部分）的優先級遞增，即后面的會覆蓋前面的配置。這樣便實現theme_config對所有頁面的配置，Front-matter實現對頁面的個性化配置
我的hexo配置文件：https://gitee.com/youfule/youfule-blog-source/blob/master/_config.yml
其中如下部分配置使用了數據文件：https://gitee.com/youfule/youfule-blog-source/tree/master/source/_data

因為scaffolds文件夾下存放的是模板文件，在新建文章時會使用對應的模塊去創建，所以我將Front-matter所有可配置項在scaffolds下的模板中進行了列出，再使用的時候可以方便的打開要配置的項。模板文件見：https://gitee.com/youfule/youfule-blog-source/tree/master/scaffolds/

其他

可參考 https://melodyjerry.gitee.io/ 上的一些插件
參考文檔 https://www.jianshu.com/p/26a726baf70e