在Windows环境下使用Hexo Volantis主题搭建博客

Jekyll这个主题其实非常适合简单新手的，但是我看了几年有点厌倦，所以想试试Hexo。其中Volantis这个主题我比较喜欢，所以马上开工了。

Hexo前安装

1.1 安装Node.js for Windows

下载地址：https://nodejs.org 或
中国淘宝镜像node.js

1.2 安装Git for Windows

Windows：下载并安装 git
中国淘宝镜像Git

安装Hexo

首先新建一个文件夹用于放这个Hexo博客，在文件夹内右键Git Bash Here即可直接到该文件夹。
或者通过cd的方式切换到这个文件夹。

d:\example

Hexo官网

npm install -g hexo-cli

然后

npx hexo init exampleblog
cd exampleblog
npm install

博客位置：d:\example\exampleblog

配置主题Volantis

在 blog/_config.yml 文件中找到并修改：

theme: volantis

在Git Bash终端输入:

npm i hexo-theme-volantis

下载_config.volantis.yml配置文件到根目录
https://github.com/volantis-x/community/blob/master/_config.volantis.yml
或者从node_module主题文件夹复制_config.yml

基础配置已完成

安装本地搜索功能

volantis主题安装本地搜索：

npm i -S hexo-generator-json-content

之后在_config.volantis.yml里将enable改为true，而service为hexo即可(大约1114行)：

############################### Search ############################### > start
# To use hexo search, you need to install the following plugins:
# npm i hexo-generator-json-content
search:
  enable: true
  service: hexo  # hexo
  js:
############################### Search ############################### > end

修改_config.volantis.yml

默认开头博客其实是链接到说明文档，我们将它改为指向主页：

menu:
  - name: 博客
    icon: fas fa-rss
    url: /

默认的分类与标签在v4版本指向是不对的，我们将它修改为blog/…
不过v5版本没有这个问题，不需要改。

- name: 分类
  icon: fas fa-folder-open
  url: categories/
- name: 标签
  icon: fas fa-tags
  url: tags/

添加文件

在source文件夹后面添加文件夹：

.
├── _config.volantis.yml
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _posts
|   └── about
|   └── blog
|   ├── categories
|   └── tags
|   └── friends  
└── themes

如你所见，blog文件夹后面添加两个文件夹(categories,tags)，然后再添加index.md
具体可以参考
https://github.com/volantis-x/community/tree/master/source/blog
以及
https://volantis.js.org/v5/page-settings/

# 标签页面
Create file if not exists: source/tags/index.md
---
layout: tag
index: true
title: 所有标签
---

# 列表页面
Create file if not exists: source/mylist/index.md
---
layout: list
group: mylist
index: true
---

背景图设置

在_config.volantis.yml第548行，修改backstretch的enable参数为true

backstretch:
  enable: true

作者名字与头像设置

author:
  avatar: /images/cat_avt.jpg
  name: 繁华是客

侧边栏修改

参考来源: https://volantis.js.org/v4/theme-settings/ #目录7.6

博主侧边栏修改

添加content

blogger:
  class: blogger
  display: [desktop, mobile] # [desktop, mobile]
  avatar: #https://cdn.jsdelivr.net/gh/volantis-x/cdn-org/blog/Logo-NavBar@3x.png
  shape: rectangle # circle, rectangle
  url: /about/
  title: 经国序民，正其制度。
  subtitle:
  content:
  我的信仰在空中飘扬：经国序民，正其制度。群之所为事无不成，众之所举业无不胜。

修改icon

普通小icon来源font awesome，大icon来源twemoji，twemoji查找需要先在github release下载再看图查找。
font awesome只需要fas fa-xxx设置即可。查看：

https://fontawesome.com/v5.15/icons

twemoji可以通过jsdelivr直接加载：

https://cdn.jsdelivr.net/gh/twitter/twemoji@13.1.0/assets/svg/xxxx.svg

公告栏修改

添加公告栏

# ---------------------------------------
post:
  class: text
  display: [desktop] # [desktop, mobile]
  header:
    icon: fas fa-plus
    title: 公告信息
    url: /contributors/
  content:
  - '唤醒原系统菜单: Ctrl+右键'
    #- '**如何让自己的文章收录到这里？**<br>官方网站是开源的，只要您的文章与 Hexo 博客搭建相关，就可以自助进行收录，详细的操作步骤请见：「[**发布与分享文章**](/contributors/#发布与分享文章)」。'    
# ---------------------------------------

启用部分文章加密

Hexo-blog-encrypt
运行

npm install --save hexo-blog-encrypt

然后在文章中加入password即可

---
title: Hello World
date: 2016-03-30 21:18:02
password: hello
---

本地运行Hexo命令及主题升级

本地运行hexo请到Hexo基础命令查看。