Cactus

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

🌵 Demo

Summary

• General
• Features
• Install
• Configuration
• License

General

• Version : 3.0
• Compatibility : Hexo 3 or later

Features

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

Install

1. In the root directory:

   $ git clone https://github.com/probberechts/hexo-theme-cactus.git themes/cactus
   

2. Change the theme property in the config.yml file.

   # theme: landscape
   theme: cactus

3. Run: hexo generate and hexo server

Configuration

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 these variables. 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 you custom settings under the theme_config variable. For example:

# _config.yml
theme_config:
  colorscheme: white

# themes/cactus/_config.yml
colorscheme: dark

This will result in the white color scheme.

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.

Navigation

Setup the navigation menu in the _config.yml:

nav:
  Home: /
  About: /about/
  Writing: /archives/
  Projects: http://github.com/probberechts
  LINK_NAME: URL

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)

  posts_overview:
    show_all_posts: false
    post_count: 5

• Show all posts

  posts_overview:
    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.

[
    {
       "name":"Hexo",
       "url":"https://hexo.io/",
       "desc":"A fast, simple & powerful blog framework"
    },
    {
       "name":"Font Awesome",
       "url":"http://fontawesome.io/",
       "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:

social_links:
  github: your-github-url
  twitter: your-twitter-url
  NAME: your-NAME-url

where NAME is the name of a Font Awesome icon.

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
• Chinese (Simplified, PRC) (zh-CN)
• Dutch (nl)
• French (fr)
• Persian (fa)
• Russian (ru)
• Spanish (es)

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, wich is a Persian font.

direction: rtl

RSS

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.

Analytics

Add you Google Analytics or Baidu Tongji tracking_id to the _config.yml.

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

baidu_analytics:
  enabled: true
  id: 2e6da3c375c8a87f5b664cea6d4cb29c

Comments

First, create a site on Disqus: https://disqus.com/admin/create/.

Next, update the _config.yml file:

disqus:
  enabled: true
  shortname: SITENAME

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

Code Highlighting

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

highlight: COLORSCHEME_NAME

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 search: true in the front-matter.

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

nav:
  search: /Search/

License

MIT