Skip to content
yijhuang edited this page Sep 25, 2016 · 3 revisions

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.

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.
Clone this wiki locally