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