Sorry, your browser cannot access this site
This page requires browser support (enable) JavaScript
Learn more >

Volantis is a feature-rich and highly modular Hexo blog theme. Thanks to its powerful modularity, you can easily build a minimalist style blog, or you can build a large-scale comprehensive blog with multi-person collaboration and document modules based on the official website.

All Volantis users can create their own Issue according to the format to add their blog to the sample blog page of the official website.

Ready to work

Self-built blog requires certain relevant knowledge. Before you start, please must make sure you can use the markdown grammar, simple to master My git knowledge, and most importantly, know how to seek solutions when encountering difficulties:

  1. Scroll through and search documents
  2. Search whether there is a solution in issues
  3. Create a new issue and follow the requirements to describe the problem you encountered in detail

If you haven’t used Hexo before, don’t worry, you can read through the Hexo Chinese document. If you want to use it handily, it’s best to refer to the open source project provided by the team. The source code to build:

Demo source codeOfficial website source code

If you are updating from an old version or migrating with other themes, please make sure that the environment version is not too low, otherwise compatibility problems will occur.

Hexo: 4.2 ~ 5.x
hexo-cli: 3.1 ~ 4.x
node.js: 12.16 ~ latest # LTS version is recommended
npm: 6.13 ~ latest

Quick experience

If you already have the environment configuration conditions, you can enter the following line of code in the terminal, and you can try the experience after a while:

git clone && cd demo && npm i && hexo s

Download and install

Step 1/2: Modify the site configuration file

Find and modify in the blog/_config.yml file:

theme: volantis

Step 2/2: Download themes

Type in the terminal:

npm i hexo-theme-volantis
if you are a Mac user

Open the terminal in the blog path, download, install and apply the theme:

curl -s | bash

This command will automatically detect and install the required environment, initialize the blog, then download, install and apply the theme.
Detailed usage of the script:

Step 1/3: Modify the site configuration file

Find and modify in the blog/_config.yml file:

theme: volantis

Step 2/3: Download theme

If you have already upgraded to Hexo 5.0.2 and above, you can directly use the npm command to install:

npm i hexo-theme-volantis

For the old version, you need to download the theme source code to the themes/ folder:

git clone themes/volantis

If you cannot access GitHub, you can use the domestic mirror source:

git clone themes/volantis

Step 3/3: Check and install dependencies

Install Hexo search dependencies:

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

Install the Stylus renderer:

npm i hexo-renderer-stylus

new version update

Please refer to update log to update, the following are the things to note after the update:

2020-09-26 3.0.0 -> 4.0.0

The configuration file of 4.0.0 has changed a lot. It is strongly recommended not to change the old configuration file.

  1. The configuration items in the original data file are no longer supported, please set in the configuration file.
  2. The theme configuration file has been redesigned and needs to be reconfigured "completely".
  3. Friends chain uses data files and supports issues tags to realize dynamic self-help friends chain.
  4. The original meta custom layout now only supports top_meta and bottom_meta inside the article.
  5. The layout of the article list page can only be customized within a limited range.
  6. The sidebar component now only supports the sidebar position; there is a dedicated component at the end of the article.
  7. If the lazy loading plugin is installed, you need to uninstall it and use the lazy loading built into the theme (which conflicts with the plugin).
  8. If you want to close the comments, you need to change it to comments: false.
  9. If you want to hide the meta tag at the top or bottom of the article, you need to set top_meta: false or bottom_meta: false.
  10. If you need to hide the title and the meta tag at the top at the same time, you can also change title: xxx to seo_title: xxx.
  11. The information of multiple authors is defined using a data file. You only need to write ʻauthor: xxx` in the article instead of repeating the author's information.
  12. Now only the pictures with the gallery tag support zooming.
  13. The friend link page layout: links is changed to layout: friends.


This theme adopts the MIT Open Source License Agreement, which is free forever and unlimited use.

MIT Open Source License Agreement

The authorized person has the right to use, copy, modify, merge, publish, distribute, sublicense and sell the software and copies of the software.
The licensee can modify the license terms as appropriate according to the needs of the program.
The software and all copies of the software must include a copyright notice and a license notice.

Configuration and use

User Exchange Area

This is only for communication between users. If you have any questions, please go to GitHub to submit an issue. Asking questions in the comment area will not receive any response from the developer!