Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
June 25, 2022 23:51
December 25, 2022 10:21
February 25, 2018 16:31
February 25, 2018 16:31
February 25, 2018 18:08
April 14, 2023 13:48
April 14, 2023 13:48


A responsive, clean and simple Hexo theme for a personal website.

🌵 Demo




  • Version : 3.0
  • Compatibility : Hexo 3 or later


  • Fully responsive
  • Multiple color schemes
  • Pick your own code highlighting scheme
  • Configurable navigation menu
  • Support for local search
  • Projects list
  • I18n support
  • Disqus / Utterances
  • Google analytics / Baidu Tongji / Umami Analytics
  • Font Awesome icons
  • Simplicity


  1. In order to use this theme you must have installed hexo.

  2. Create the root directory for the blog by initializing it with hexo:

    $ hexo init my-blog
  3. Navigate into the new directory:

    $ cd my-blog


  1. In the root directory:

    $ git clone themes/cactus
  2. Change the theme property in the _config.yml file.

    # theme: landscape
    theme: cactus

    See below for more information on how to customize this theme.

  3. Create pages and articles with the hexo new [layout] <title> command. For example, to create an "about me" page, run:

    $ hexo new page about

    This will create a new file in source/about/ Similarly, you can create a new article with

    $ hexo new post "hello world"

    and add some interesting content in source/_posts/

  4. Run: hexo generate and hexo server

  5. Publish your blog!


You can (and should) modify a couple of settings. An overview of all settings can be found in _config.yml. The most important ones are discussed below.

There are two possible methods to override the defaults. As a first option, you could fork the theme and maintain a custom branch with your settings. Alternatively, you can configure it from your site's primary configuration file. Therefore, define your custom settings under the theme_config variable. For example:

# _config.yml
  colorscheme: white
# themes/cactus/_config.yml
colorscheme: dark

This will override the default black colorscheme in themes/cactus/_config.yml.

Color scheme

Currently, this theme is delivered with four color schemes: dark, light, white and classic. Set your preferred color scheme in the _config.yml file.

colorscheme: light

Alternatively, you can easily create your own color scheme by creating a new file in source/css/_colors.


Set up the navigation menu in the _config.yml:

  home: /
  about: /about/
  articles: /archives/

Blog posts list on home page

You have two options for the list of blog posts on the home page:

  • Show only the 5 most recent posts (default)

      show_all_posts: false
      post_count: 5
  • Show all posts

      show_all_posts: true

Projects list

Create a projects file source/_data/projects.json to show a list of your projects on the index page.

       "desc":"A fast, simple & powerful blog framework"
       "name":"Font Awesome",
       "desc":"The iconic font and CSS toolkit"

Social media links

Cactus can automatically add links to your social media accounts. Therefore, update the theme's _config.yml:

    icon: github
    link: your-github-url
    icon: twitter
    label: "@your-twitter-handle"
    link: your-twitter-url
    icon: NAME
    label: LABEL
    link: your-NAME-url

where NAME is the name of a Font Awesome icon, and LABEL is an optional value used as a title attribute on the link (NAME value is used if LABEL is missing).

Copyright years

By default, Cactus will use current year in your copyright year information. If there is a need to customize, please update _config.yml:

  start_year: 2016

Language configuration

If you are new to Hexo and internationalization (i18n), please read Hexo documentation - internationalization (i18n) section

Currently, the theme is delivered with support for:

  • English (en), default
  • Brazilian Portuguese (pt-br)
  • Catalan (ca)
  • Chinese (Simplified, PRC) (zh-CN)
  • Dutch (nl)
  • French (fr)
  • Italian (it)
  • Persian (fa)
  • Russian (ru)
  • Spanish (es)
  • German (de)

If you would like to use one the languages listed above, simply set language to the desired language (e.g., fr) in _config.yml. Otherwise, you can follow the steps below (E.g., to add a Japanese (ja) translation):

  1. Set language to ja in Hexo configuration file _config.yml
  2. Create a ja.yml file in the themes/cactus/languages/ folder
  3. Copy the content of themes/cactus/languages/default.yml and paste it it into the ja.yml file
  4. Replace all English strings by their Japanese translation

Note: Cactus does not support multi-language sites.

RTL support

This theme support RTL languages for Persian and Arabic language. If you would like to use RTL layout, change direction attribute in _config.yml to rtl. Note that this also will change the font to Vazir, which is a Persian font.

direction: rtl


Set the rss field in the _config.yml to one of the following values:

  1. rss: false will totally disable rss (default).
  2. rss: atom.xml sets a specific feed link.
  3. rss:leave empty to use the hexo-generator-feed plugin.


Add you Google, Baidu, Cloudflare or Umami Analytics tracking_id to the _config.yml.

  enabled: true
  id: 'UA-49627206-1'

  enabled: true
  id: 2e6da3c375c8a87f5b664cea6d4cb29c

  enabled: true
  id: 0dabb6e21848405483a237e6a7b6ed04

  enabled: false
  id: e77e68be-f6e4-4br3-9365-2b76b57cd571
  script_name: umami.js


Load Javascript and CSS resources from a CDN. Enabled by default, loads all resources from cdnjs.

  enable: true
  jquery: 'url'
  clipboard: 'url'
  font_awesome: 'url'
  justified_gallery_css: 'url'
  justified_gallery_js: 'url'

Set enable: false to completely disable CDN and load all resources from your domain. If you want to disable it only for specific resource(s) then just remove the corresponding entry(s).

  enable: true
  jquery: 'url'

Only JQuery will be loaded from the specified CDN.


Cactus supports two commenting systems: Disqus and Utterances.


First, create a site on Disqus:

Next, update the _config.yml file:

  enabled: true
  shortname: SITENAME

where SITENAME is the name you gave your site on Disqus.


First, follow the instructions on the oficial website to setup an issue tracker Utterances will connect to.

Next, update the _config.yml file:

  enabled: true
  repo: owner/githubrepo
  issue_term: pathname
  label: utteranc
  theme: themename

where each of the parameters are the respective values ​​provided during the configuration of the Utterances:

  • repo: the repository Utterances will connect to.
  • issue_term: the mapping between blog posts and GitHub issues.
  • label: the label that will be assigned to issues created by Utterances
  • theme: the selected Utterances theme.

Code Highlighting

Pick one of the available colorschemes and add it to the _config.yml:


Tags and categories

Tags and categories can be included in the front-matter of your posts. For example:

title: Tags and Categories
date: 2017-12-24 23:29:53
- Foo
- Bar
- Baz

This post contains 2 tags and 1 category.

You can create a page with a tag cloud by running:

$ hexo new page tags

Next, add type: tags to the front-matter of source/tags/ You can also add a tag cloud to the home page by setting the tags_overview option to true.

Similarly, you can create a page with an overview of all categories by running:

$ hexo new page categories

and adding type: categories to the front-matter of source/categories/

Finally, don't forget to create a link to these pages, for example in the navigation menu:

  tag: /tags/
  category: /categories/

Local search

First, install the hexo-generate-search plugin, which will generate a search index file.

$ npm install hexo-generator-search --save

Next, create a page to display the search engine:

$ hexo new page search

and put type: search in the front-matter.

title: Search
type: search

Finally, edit the _config.yml and add a link to the navigation menu.

  search: /search/