A bootswatch theme for hexo.
CSS JavaScript
Pull request Compare This branch is 18 commits ahead, 72 commits behind wzpan:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
languages
layout
source more bootstrap classes Aug 15, 2014
.gitignore
LICENSE
README.md
_config.yml
package.json

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.