fantismo / harmony

A responsive Jekyll theme.

Harmony

Harmony is a responsive jekyll theme.

• Build for jekyll 2.x
• Support Google anaytics and RSS feeds
• Sass based styles
• Browser support: IE 8+, Chrome, Safari and Firefox
• Fluidly responsive

Contents

• Harmony
• About Jekyll
• How to install/run
• Options/Usage
  • Header navigation links
  • Footer links
  • Copyrights/Disclaimer statements
• Screenshots
• Feedback/Bugs/Suggestions
• Version history
• License

About jekyll

Jekyll is a static site generator, an open-source tool for creating simple yet powerful websites of all shapes and sizes.

How to install/run

1. Fork this repository.
2. Clone it: git clone https://github.com/YOUR-USERNAME/harmony.
3. If you completely new to jekyll, please read more about Jekyll and Github pages.
4. Change your directory into cloned repository.
5. Run bundle install
6. Edit the _config.yml on root directory. Change url property to to http://127.0.0.1:4000 since you are going to run on localhost.
7. Run the jekyll server by having: jekyll serve --baseurl '' or rake preview

Try to locate your browser at http://localhost:4000.

Note: If you are a windows user please refer this nice website - http://jekyll-windows.juthilo.com/ by Julian Thilo to configure ruby + jekyll on windows.

Options/Usage

Harmony theme has some customizable options. All the configuration details are configured in _config.yml file under root of the harmony directory.

Feel free to change your name, description, meta_description, author details, social media names and google analytics id accordingly.

# Harmony theme configuration. Please change accordingly.
harmony:
  name: Harmony
  # Little description about your site
  description: Harmony is free responsive jekyll theme.
  meta_description: Harmony is free responsive jekyll theme. It will appear in your document head meta (for Google search results) and in your feed.xml site description.
  basetheme: theme-base-01 # pre defined thmes are darken, blue-water, redish.
  author: # Author details
    name: Gayan Virajith
    email: [email protected]
    url: http://gayanvirajith.github.io

  # Google Analytics key, leave blank to ignore
  google_analytics_key: UA-xxxx-x

  # Profile links, leave blank to ignore
  social: 
    github: gayanvirajith
    twitter: gayanvirajith
    facebook: gayanvirajith
    gplus: +GayanVirajith
    dribble: gayan
    pinterest: 
  # Toggle disclaimer in footer
  show_disclaimer: true

Includes

All the partial includes are under _includes directory.

Header navigation links

Feel free to add/edit links for your header in the file header-links.html.

Footer links

Customize your footer links by editing _includes/footer-links.html

Copyrights/Disclaimer statements

All the copyrights notes are under _includes/footer.html. Also note that you can toggle on/off copyright note from front-end by setting up show_disclaimer property in _config.yml.

Screenshots

Feedback/Bugs/Suggestions

Please submit as Github issue, I am happy to response back.

Version history

Version no.	Description	Date
1.0	Initial release	9th September 2014
1.0.1	v1.0.1 with minor bug fix	9th September 2014

License

Free / Open sourced under the MIT.