Repository files navigation

They say three times the charm, so here is another free responsive Jekyll theme for you. I've learned a ton since open sourcing my first two themeson Github, and wanted to try a few new things this time around. If you've used my previous themes most of this should be familiar territory...

• Responsive templates for post, page, and post index_layouts. Looks great on mobile, tablet, and desktop devices.
• Gracefully degrades in older browsers. Compatible with Internet Explorer 8+ and all modern browsers.
• Modern and minimal design.
• Sweet animated menu.
• Readable typography to make your words shine.
• Support for large images to call out your favorite posts.
• Comments powered byDisqus if you choose to enable.
• Social Sharing links for Facebook, Twitter, and Google+ if you choose to enable.
• Simple and clear permalink structure.
• Open Graph andTwitter Cards support for a better social sharing experience.
• Simplecustom 404 page to get you started.
• Stylesheets for Pygments and Coderaysyntax highlighting to make your code examples look snazzy
• Grunt build script for easy theme development
• Available in Spanish. Thanks@cruznick!

General notes and suggestions for customizingHPSTR.

1. Install Bundlergem install bundler and then installJekyll and all dependenciesbundle install.
2. Fork theHPSTR Jekyll Theme repo.
3. Clone the repo you just forked and rename it.
4. Edit_config.yml to personalize your site.
5. Check out the sample posts in_posts to see examples for pulling in large feature images, assigning categories and tags, and other YAML data.
6. Read the documentation below for further customization pointers and documentation.

Demo the Theme

Pro-tip: Delete thegh-pages branch after cloning and start fresh by branching offmaster. There is a bunch of garbage ingh-pages used for the theme's demo site that I'm guessing you don't want on your site.

1. Clone the following folders:_includes,_layouts,assets, andimages.
2. Clone the following files and personalize content as need:about.md,posts.html,index.html,tags.html, andfeed.xml.
3. Set the following variables in yourconfig.yml file:

title:Site Titledescription:Describe your website here.disqus_shortname:shortname# Your site's domain goes here. When working locally use localhost server leave blank# PS. If you set this wrong stylesheets and scripts won't load and most links will break.# PPS. If you leave it blank for local testing home links won't work, they'll be fine for live domains though.url:http://localhost:4000# Owner/author informationowner:name:Your Nameavatar:avatar.jpgbio:"Your bio goes here. It shouldn't be super long but a good two sentences or two should suffice."email:you@email.com# Social networking links used in footer. Update and remove as you like.twitter:facebook:github:stackexchange:linkedin:instagram:flickr:tumblr:# For Google Authorship https://plus.google.com/authorshipgoogle_plus:# Analytics and webmaster tools stuff goes heregoogle_analytics:google_verify:# https://ssl.bing.com/webmaster/configure/verify/ownership Option 2 content= goes herebing_verify:# Links to include in top navigation# For external links add external: truelinks:  -title:Theme Setupurl:/theme-setup  -title:External Linkurl:http://mademistakes.comexternal:true# http://en.wikipedia.org/wiki/List_of_tz_database_time_zonestimezone:America/New_Yorkfuture:truepygments:truemarkdown:kramdown# Amount of posts to show on home pagepaginate:5

To learn more about how to customize the theme, include feature images in posts, use the Grunt build script, and some other junk,read up here.

Having a problem getting something to work or want to know why I setup something in a certain way? Ping me on Twitter@mmistakes orfile a GitHub Issue. And if you make something cool with this theme feel free to let me know.

This theme is free and open source software, distributed under theGNU General Public License version 2 or later. So feel free to to modify this theme to suit your needs.