A Wonderful Theme for Hexo


Volantis,一个高度模块化和可定制化、功能相对完善的 Hexo 博客主题,既可以用作个人博客,也适合用来搭建文档。

这些是使用了本主题的博客: 示例博客

能力要求

自建博客需要一定的相关知识,在开始前,请务必确保:

已掌握 markdown 语法

已阅读 Hexo 官方文档

会使用终端(命令行),会使用 git

会阅读文档、搜索文档

为了更好地使用,还建议掌握以下知识:

规范地使用 GitHub Issues(解决文档中没有的问题)

GitHub Fork、Pull Request 操作(使主题保持更新)

环境要求

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

Hexo: 4.2
hexo-cli: 3.1
node.js: 12.16 # LTS版
npm: 6.13

下载与安装

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

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

如果您还没有博客,执行这行命令将会自动检测并安装所需环境,初始化博客,然后下载安装并应用主题。

第1/3步:下载主题源码到 themes/ 文件夹

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

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

blog/_config.yml
theme: volantis

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

安装 Hexo 搜索的依赖包:
npm i -S hexo-generator-search hexo-generator-json-content
安装 stylus 渲染器:
npm i -S hexo-renderer-stylus

升级小助手

升级前请查看 更新日志

2.6.3 -> 2.6.6

不需要额外处理。

2.6.2 -> 2.6.3
  1. 全局搜索 seotitle 并替换为 seo_title
  2. group 组件的索引规则有变,使用 group 组件的文章内,group: group_name 对应的组件名必须是 group_name
  3. group 组件的列表名优先显示文章的 short_title 其次是 title

许可协议

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

MIT开源许可协议

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

过期的文档

这份文档过于久远,如果您使用的是新版的主题,请查看新版本的文档。