A Wonderful Theme for Hexo 5


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

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

能力要求 !!!

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

已掌握 markdown 语法

已阅读 Hexo 官方文档

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

会阅读文档、搜索文档


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

会阅读源码,知道本站源码在哪里,会参照源码仿写、对比差异

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

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

环境要求

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

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

下载与安装

第 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-08-09 2.6.6 -> 3.0.0

  1. 如果有 hexo-lazyload-image 插件,需要重新安装最新版本并增加设置 lazyload.isSPA: true
  2. 2.x 版本的 css 和 js 不适用于 3.x 版本,如果使用了 use_cdn: true 则需要删除。
  3. 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery
  4. 2.x 版本的置顶 top: true 改为了 pin: true 并且同样适用于 layout: page 的页面。
  5. 如果使用了 hexo-offline 插件,建议卸载,3.0 版本使用了 pjax 服务。
  6. 欢迎补充

许可协议

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

MIT开源许可协议

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

用户交流区

这里仅供用户之间进行交流,有任何疑问请前往GitHub提交Issue。在评论区进行提问将不会收到开发者的任何回复!

过期的文档

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