en

Overview

Aloha is a HEXO theme, it use Semantic UI.

Usage

1. clone

   $ cd $YOUR_BLOG_ROOT_DIR
   
   $ git clone https://github.com/henryhuang/hexo-theme-aloha.git themes/aloha
   

2. configuration

   modify your site's configuration file _config.yml, set the theme's value to aloha.

Site config

Aloha use following site's configuration file attribute

• algolia

   algolia:
     applicationID: 'YOUR APPLICATION ID'
     apiKey: 'YOUR API KEY'
     indexName: 'YOUR INDEX NAME'

  Algolia is a search engine that provide site inner search, you could read this blog Hexo集成Algolia搜索插件 to generate your above three values.

  If you config these algolia configuration, Aloha will add site inner search function to your site.

• sidebar

   sidebar:
     bio: Programer / LOLer / Arsenaler
     avatar: /images/avatar.jpg
     subtitle: 程序员
     location: Shanghai
     social:
       github: https://github.com/henryhuang
       weibo: http://weibo.com/626242034
       twitter: 

  This section configure some attribute values about sidebar.

  You could see all of the presentations on the demo website.

• code highlight

   highlight:
     enable: true			＃true: turn code highlight on
     line_number: true		＃true: show line numbers 

  Aloha use code high light function which used for official.

• Disqus

  Add following to your site's config file:

   disqus_shortname: YOUR DISQUS SHORT NAME
  

Theme config

all the configuration content see HERE,

• language

  Site language supported list, about more you could see HEXO's official doc internationalization.

• theme

  Choose Aloha's theme, it is simple by default.

  I will provide a new theme for Aloha in the future.

• menu

  Set the site's menu.

  a menu item contains three element, for example:

    Home:
     name: homePage
     value: /index.html
     icon: home

  • name: the key of attribute in language configuration file, if config file does not provide the value for this key, Aloha will show the key(like "homePage" of here).
  • value: menu item's link.
  • icon: the icon class name, icon class name see Here.

Suggest

If you have any suggests or issues, please add issues there .

In addition, I need your help to improve Aloha, so I welcome your pull request!

TODO

• Support more languages, there are Simplified Chinese and English.
• support different theme, current theme named Simple.
• SEO.