It’s easy to build a Hexo theme - you just have to create a new folder. To start using your theme, modify the
theme setting in your site’s
_config.yml. A theme may have the following structure:
Theme configuration file. You don’t need to restart the server after changing this.
Language folder. See localization (i18n) for more info.
Layout folder. This folder contains the theme’s template files, which define the appearance of your website. Hexo provides the Swig template engine. You can install plugins to support alternative engines such as EJS, Haml or Jade. Hexo chooses the template engine based on the file extension of the template. For example:
layout.ejs - uses EJS
See templates for more info.
Files that can be rendered are processed and saved to the
public folder. Other files are copied to the
public folder directly.
Once your theme is complete, you can publish it to the theme list. Before publishing, you should run the theme unit test and ensure everything works. The steps for publishing a theme are very simliar to those for updating documentation.
- Fork hexojs/site
Clone the repository to your computer and install dependencies.
$ git clone https://github.com/<username>/site.git
$ cd site
$ npm install
source/_data/themes.ymland add your theme. For example:
- name: landscape
description: A brand new default theme for Hexo.
Add a screenshot (with the same name as the theme) to
source/themes/screenshots. It must be a 800*500px PNG.
- Push the branch.
- Create a pull request and describe the change.