Volantis6 A Wonderful Theme for Hexo
Volantis 是一个功能丰富、高度模块化的 Hexo 博客主题。得益于其强大的模块化特性，您可以轻松搭建一个极简风格的博客，也可以仿照官网搭建一个多人协作的、包含文档模块的大体量综合型博客。
所有的 Volantis 用户都可以按照格式自行创建 Issue 来将自己的博客添加到官网的示例博客页面中。
准备工作
自建博客需要一定的相关知识，在开始前，请务必确保您会使用 markdown 语法，掌握简单的 git 知识，最最重要的是，遇到困难知道该怎么寻求解决：
- 翻阅和搜索文档
- 搜索 issues 中是否有解决办法
- 新建 issue 并按照要求进行操作，详尽地描述您遇到的问题
如果您没有使用过 Hexo 也不要着急，可以先通读一遍 Hexo 中文文档，要想使用地得心应手，最好参照团队提供的开源项目的源码进行搭建：
如果您从旧版本更新或着其它主题迁移，请确保环境版本不要太低，否则会产生兼容性问题。
1 | Hexo: 5.4 ~ 6.x |
配置和使用 volantis 6.x 之前请确保 node.js 升级至
快速体验
如果您已经具备环境配置条件，可以在终端中输入下面这行代码，稍等片刻即可尝鲜体验：
1 | git clone https://github.com/volantis-x/demo.git && cd demo && npm i && hexo s |
下载与安装
volantis 6.x 目前正处于 「alpha 阶段」
volantis 5.x 目前正处于 「stable 阶段」
volantis 4.x 目前正处于 「EOL(End of Life) 阶段」
Tips: volantis 开发发布周期
volantis 开发发布周期依次经过: 「alpha 阶段」=>「beta 阶段」=>「rc 阶段」=>「stable 阶段」=>「EOL 阶段」
rc 阶段的测试版本和 stable 阶段的正式版本 我们统称为 「稳定版本」 , 只有 「稳定版本」 发布到 npm
alpha 阶段的开发测试版本 和 beta 阶段的测试版本 我们统称为 「小白鼠测试版本」, 「小白鼠测试版本」 仅存在于 Github 仓库的 dev 分支 和 Github 仓库的 6.0 分支
安装或更新 「稳定版本」
在 blog/_config.yml 文件中找到并修改：
1 | theme: volantis |
在终端中输入：
1 | npm i hexo-theme-volantis |
如果您是 Mac 用户，可以使用脚本完成全部流程
在博客路径打开终端，下载安装并应用主题：
1 | curl -s https://volantis.js.org/start | bash |
这行命令将会自动检测并安装所需环境，初始化博客，然后下载安装并应用主题。
脚本详细使用方法：#blog脚本
在 blog/_config.yml 文件中找到并修改：
1 | theme: volantis |
如果您已经升级到 Hexo 5.0.2 及以上，可以直接使用 npm 命令安装：
1 | npm i hexo-theme-volantis |
对于旧版本，需要下载主题源码到 themes/ 文件夹：
1 | git clone https://github.com/volantis-x/hexo-theme-volantis themes/volantis |
如果您无法访问 GitHub 可以使用国内镜像源：
1 | git clone https://e.coding.net/volantis-x/p/hexo-theme-volantis.git themes/volantis |
安装 Hexo 搜索的依赖包：
1 | npm i hexo-generator-json-content |
安装 Stylus 渲染器：
1 | npm i hexo-renderer-stylus |
安装或更新 「小白鼠测试版本」
在 blog/_config.yml 文件中找到并修改：
1 | theme: volantis |
将主题添加为子模块
开始前需要确认不存在 themes/volantis 文件夹, 如果有, 请自行删除.
1 | git submodule add git@github.com:volantis-x/hexo-theme-volantis.git themes/volantis |
1 | git submodule add https://github.com/volantis-x/hexo-theme-volantis.git themes/volantis |
在终端中输入：
1 | cd themes/volantis |
在终端中输入：
1 | git pull |
版本更新注意事项
使用主题的时候，尽量 fork 主题到自己的 GitHub，然后进行修改并使用。这样做的好处是：当主题进行重要更新的时候可以根据需要拉取合并代码，使自己 DIY 的主题能够通过更新获取 BUG 修复或者新特性。
如果不懂请自行搜索关键词：fork 更新
实用小技巧
所有需要写在主题配置文件中的配置都可以写在站点配置文件的 theme_config: 中，在 Hexo 5.0 后，还可以写在 _config.volantis.yml 文件中，详见 Hexo 官方文档：
也可以直接查看本站源码中站点配置文件的写法：_config.volantis.yml
请对照 更新日志 进行更新.
许可协议
本主题采用 MIT开源许可协议 ，永久无限制免费使用。
MIT开源许可协议
被授权人有权利使用、复制、修改、合并、出版发行、散布、再授权及贩售软件及软件的副本。
被授权人可根据程式的需要修改授权条款为适当的内容。
在软件和软件的所有副本中都必须包含版权声明和许可声明。
