A bootswatch theme for hexo.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 18 commits ahead, 107 commits behind wzpan:master.
yieme clean up
Latest commit 1096b8d Aug 30, 2014
Failed to load latest commit information.
languages cleanup Aug 14, 2014
layout more bootstrap classes Aug 15, 2014
source more bootstrap classes Aug 15, 2014
.gitignore initial Aug 14, 2014
LICENSE first commit Mar 16, 2014
README.md clean up Aug 29, 2014
_config.yml default to cerulean Aug 29, 2014
package.json clean up Aug 29, 2014



A Hexo bootstrap theme based on freewill. Freewill aims at fully taking advantages of Bootstrap and the strengths of freewill with an styling adjusted for personal preference.


  • Bootstrap - get the power of Twitter Bootstrap with minimal hassle;
  • Bootswatch - get the ease of Bootswatch
  • Tag plugins - Bootstrap tag plugins by hexo-tag-bootstrap, including:
    • textcolor - a paragraph of text with specified color;
    • button - a button with target links, text and specified color;
    • label - a label with text and specified color;
    • badge - a badge with text;
    • alert - alert messages with text and specified color;


Edit theme/freewill/_config.yml

Normal Bootstrap (v3.2.0)


Bootswatch Cerulean (v3.2.0)

bootswatch: cerulean

Bootswatch Flatly (v3.2.0)

bootswatch: flatly

Bootswatch Journal (v3.2.0)

bootswatch: journal

Bootswatch Lumen (v3.2.0)

bootswatch: lumen

Bootswatch Readable (v3.2.0)

bootswatch: readable

Bootswatch Simplex (v3.2.0)

bootswatch: simplex

Bootswatch Space Lab (v3.2.0)

bootswatch: spacelab

Bootswatch United (v3.2.0)

bootswatch: united

Bootswatch Yeti (v3.2.0)

bootswatch: yeti


  1. install theme:
$ git clone https://github.com/yieme/hexo-theme-freewill.git themes/freewill
  1. install hexo-tag-bootstrap:
$ npm install hexo-tag-bootstrap --save
  1. Create pages

freewill offers you the customized Categories, Tags and About pages. But you need to manually create these page at your 'source' folder.

For example, to create a Categories page, you may create a index.html file at source/categories/ folder with the following contents:

title: Categories
layout: categories

Tags and About pages are created in a similar way, except that the layouts are tags and page respectively.

Some people may argue that I should embed these pages in the theme. This really makes sense, but currently I don't have time to do so. If you know how, welcome to send me patches.


Modify theme setting in your _config.yml to freewill.


$ cd themes/freewill
$ git pull


slogan: Yet another bootstrap theme.

  - title: Archives
    url: archives
    intro: All the articles.
    icon: fa fa-archive
  - title: Categories
    url: categories
    intro: All the categories.
    icon: fa fa-folder
  - title: Tags
    url: tags
    intro: All the tags.
    icon: fa fa-tags
  - title: About
    url: about
    intro: About me.
    icon: fa fa-user

  - title: My Github
    url: http://www.github.com/wzpan
    intro: My Github account.
    icon: fa fa-github
  - title: My LinkedIn
    url: http://www.linkedin.com/pub/weizhou-pan/5b/8a0/161
    intro: My Linkin account.
    icon: fa fa-linkedin

- search
- category
- tagcloud
- recent_posts
- links

rss: atom.xml
favicon: favicon.png
fancybox: true
  • slogan - slogan display at the index page
  • menu - Navigation menu
  • links - reference links at the links widget
  • widgets - Widgets displaying in sidebar
  • rss - RSS link
  • fancybox - Enable Fancybox
  • google_analytics - Google Analytics ID


There are some new front-matter settings in freewill that you can use to decorate your articles.

  • description - a short description about the articles that will be display at the top of the post
  • feature - sets a feature image that will be show at the index page
  • toc - renders a table of contents

For example:

title: Tag Plugins
date: 2014-03-16 10:17:16
tags: plugins
categories: Docs
description: Introduce tag plugins in freewill.
feature: images/tag-plugins/plugins.jpg
toc: true


This theme is provided under MIT License.