A bootswatch theme for hexo.
CSS JavaScript
Pull request Compare This branch is 18 commits ahead, 72 commits behind wzpan:master.
Latest commit 1096b8d Aug 30, 2014 yieme clean up
Permalink
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

README.md

Hexo-Theme-Freewill

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.

Features

  • 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;

Samples

Edit theme/freewill/_config.yml

Normal Bootstrap (v3.2.0)

bootswatch:


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


Install

1) install theme:

$ git clone https://github.com/yieme/hexo-theme-freewill.git themes/freewill

2) install hexo-tag-bootstrap:

$ npm install hexo-tag-bootstrap --save

3) 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.

Enable

Modify theme setting in your _config.yml to freewill.

Update

$ cd themes/freewill
$ git pull

Configuration

slogan: Yet another bootstrap theme.

menu:
  - 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

links:
  - 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

widgets:
- search
- category
- tagcloud
- recent_posts
- links

rss: atom.xml
favicon: favicon.png
fancybox: true
google_analytics:
  • 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

Front-Matter

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
---

License

This theme is provided under MIT License.