viniborges / 404is.github.io

404 Blog

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 themes on 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...

What HPSTR brings to the table:

• 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 by Disqus 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 and Twitter Cards support for a better social sharing experience.
• Simple custom 404 page to get you started.
• Stylesheets for Pygments and Coderay syntax 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 customizing HPSTR.

Basic Setup for a new Jekyll site

1. Install Bundler gem install bundler and then install Jekyll and all dependencies bundle install.
2. Fork the HPSTR 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 the gh-pages branch after cloning and start fresh by branching off master. There is a bunch of garbage in gh-pages used for the theme's demo site that I'm guessing you don't want on your site.

---