/hexo-theme-kiss

Primary LanguageStylusMIT LicenseMIT

KISS

A KISS (Keap It Stupid Simple) theme for Hexo.

Installation

Install

$ git clone https://github.com/linlshare/hexo-theme-kiss.git

Kiss requires Hexo 2.4 and above. If you would like to enable the RSS, the hexo-generate-feed plugin is also required.

Enable

Modify theme setting in _config.yml to kiss.

Update

git pull

Configuration

# Header
menu:
  Home: /
  Archives: /archives
rss: /atom.xml

# Content
excerpt_link: Read More
fancybox: true

# Sidebar
sidebar: right
widgets:
- category
- tag
- tagcloud
- archives
- recent_posts

# Miscellaneous
google_analytics:
twitter:
google_plus:
  • menu - Navigation menu
  • rss - RSS link
  • excerpt_link - "Read More" link at the bottom of excerpted articles. false to hide the link.
  • fancybox - Enable Fancybox
  • sidebar - Sidebar style. You can choose left, right, bottom or false.
  • widgets - Widgets displaying in sidebar
  • google_analytics - Google Analytics ID

Features

Fancybox

Kiss uses Fancybox to showcase your photos. You can use Markdown syntax or fancybox tag plugin to add your photos.

![img caption](img url)

{% fancybox img_url [img_thumbnail] [img_caption] %}

Sidebar

You can put your sidebar in left side, right side or bottom of your site by editing sidebar setting.

Kiss provides 5 built-in widgets:

  • category
  • tag
  • tagcloud
  • archives
  • recent_posts

All of them are enabled by default. You can edit them in widget setting.

Development

Requirements

Grunt tasks