Volantis 是一个功能丰富、高度模块化的 Hexo 博客主题。得益于其强大的模块化特性,您可以轻松搭建一个极简风格的博客,也可以仿照官网搭建一个多人协作的、包含文档模块的大体量综合型博客。

所有的 Volantis 用户都可以按照格式自行创建 Issue 来将自己的博客添加到官网的示例博客页面中。

准备工作

自建博客需要一定的相关知识,在开始前,请务必确保您会使用 markdown 语法,掌握简单的 git 知识,最最重要的是,遇到困难知道该怎么寻求解决:

  1. 翻阅和搜索文档
  2. 搜索 issues 中是否有解决办法
  3. 新建 issue 并按照要求进行操作,详尽地描述您遇到的问题

如果您没有使用过 Hexo 也不要着急,可以先通读一遍 Hexo 中文文档,要想使用地得心应手,最好参照团队提供的开源项目的源码进行搭建:

Demo 源码官网源码

如果您从旧版本更新或着其它主题迁移,请确保环境版本不要太低,否则会产生兼容性问题。

Hexo: 4.2 ~ 5.x
hexo-cli: 3.1 ~ 4.x
node.js: 12.16 ~ latest # 推荐使用 LTS 版
npm: 6.13 ~ latest

快速体验

如果您已经具备环境配置条件,可以在终端中输入下面这行代码,稍等片刻即可尝鲜体验:

git clone https://github.com/volantis-x/demo.git && cd demo && npm i && hexo s

下载与安装

第 1/2 步:修改站点配置文件

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

theme: volantis

第 2/2 步:下载主题

在终端中输入:

npm i hexo-theme-volantis
如果您是 Mac 用户,可以使用脚本完成全部流程

在博客路径打开终端,下载安装并应用主题:

curl -s https://volantis.js.org/start | bash

这行命令将会自动检测并安装所需环境,初始化博客,然后下载安装并应用主题。
脚本详细使用方法:#hexo.sh

第 1/3 步:修改站点配置文件

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

theme: volantis

第 2/3 步:下载主题

如果您已经升级到 Hexo 5.0.2 及以上,可以直接使用 npm 命令安装:

npm i hexo-theme-volantis

对于旧版本,需要下载主题源码到 themes/ 文件夹:

git clone https://github.com/volantis-x/hexo-theme-volantis themes/volantis

如果您无法访问 GitHub 可以使用国内镜像源:

git clone https://e.coding.net/volantis/volantis/volantis.git themes/volantis

第 3/3 步:检查并安装依赖

安装 Hexo 搜索的依赖包:

npm i hexo-generator-search hexo-generator-json-content

安装 Stylus 渲染器:

npm i hexo-renderer-stylus

版本更新

请对照 更新日志 进行更新,下面是更新之后需要注意的事项:

2020-09-26 3.0.0 -> 4.0.0

4.0.0 的配置文件改动非常大,强烈建议不要在旧的配置文件上改。

  1. 原数据文件中的配置项不再支持,请在配置文件中进行设置。
  2. 主题配置文件进行了重新设计,需要「完全」重新配置一遍。
  3. 友链使用数据文件,并支持 issues 标签实现动态自助友链。
  4. 原 meta 自定义布局现在只支持文章内部的 top_meta 和 bottom_meta 。
  5. 文章列表页面布局现在只能在有限范围内进行自定义。
  6. 侧边栏组件现在只支持侧边栏位置;文章末尾有专用的组件。
  7. 如果安装了懒加载插件,需要卸载掉,使用主题内置的懒加载(和插件冲突)。
  8. 如果想要关闭评论,需要改为 comments: false
  9. 如果要隐藏文章顶部或者底部的 meta 标签,需设置 top_meta: false 或者 bottom_meta: false
  10. 如果需要同时隐藏标题和顶部的 meta 标签也可以把 title: xxx 改为 seo_title: xxx
  11. 多作者的信息使用数据文件进行定义,文章中只需要写 author: xxx 而不需要重复写作者的信息了。
  12. 现在只有 gallery 标签的图片支持放大。

许可协议

本主题采用 MIT开源许可协议 ,永久无限制免费使用。

MIT开源许可协议

被授权人有权利使用、复制、修改、合并、出版发行、散布、再授权及贩售软件及软件的副本。
被授权人可根据程式的需要修改授权条款为适当的内容。
在软件和软件的所有副本中都必须包含版权声明和许可声明。

配置与使用