_includes | ||
_layouts | ||
_posts | ||
assets | ||
images | ||
_config.yml | ||
.gitignore | ||
.jshintrc | ||
404.md | ||
about.md | ||
archive.html | ||
favicon.ico | ||
favicon.png | ||
feed.xml | ||
Gruntfile.js | ||
index.html | ||
LICENSE | ||
package.json | ||
README.md | ||
sitemap.xml | ||
tags.html | ||
theme-setup.md |
HPSTR RDX Jekyll Theme
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 RDX brings to the table:
- Responsive templates for post, page, and post index
_layouts
. Looks great on mobile, tablet, and desktop devices. - Gracefully degrads 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.
- Simple and clear permalink structure.
- Open Graph and Twitter Cards support for a better social sharing experience.
- Simple [custom 404 page]({{ site.url }}/404.html) to get you started.
- Stylesheets for Pygments and Coderay [syntax highlighting]({{ site.url }}/code-highlighting-post/) to make your code examples look snazzy
- Grunt build script for easy theme development
Theme Preview
General notes and suggestions for customizing HPSTR RDX.
Basic Setup for a new Jekyll site
- Install Jekyll and read through the documentation if you haven't already.
- Fork the HPSTR RDX repo
- Clone the repo you just forked to your computer.
- Edit
_config.yml
to personalize your site. - Check out the sample posts in
_posts
to see examples for pulling in large feature images, tags, and other YAML data. - Read the documentation below for further customization pointers and documentation.
Download 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 that I'm guessing you don't want on your site.
{:.notice}
Setup for an Existing Jekyll site
- Clone the following folders:
_includes
,_layouts
,assets
, andimages
. - Clone the following files and personalize content as need:
about.md
,archive.html
,index.html
,tags.html
, andfeed.xml
. - Set the following variables in your
config.yml
file:
title: Site Title
description: Describe your website here.
disqus_shortname: shortname
url: http://your-website.com
# Owner/author information
owner:
name: Your Name
avatar: avatar.jpg
bio: "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/authorship
google_plus:
# Analytics and webmaster tools stuff goes here
google_analytics:
google_verify:
# https://ssl.bing.com/webmaster/configure/verify/ownership Option 2 content= goes here
bing_verify:
# Links to include in top navigation
# For external links add external: true
links:
- title: Theme Setup
url: /theme-setup
- title: External Link
url: http://mademistakes.com
external: true
# http://en.wikipedia.org/wiki/List_of_tz_database_time_zones
timezone: America/New_York
future: true
pygments: true
markdown: kramdown
# Amount of posts to show on home page
paginate: 5
More Theme Setup Goodness
To learn more about how to customize the theme, how feature images work, use the Grunt build script, and some other junk, read up here.
Questions?
Having a problem getting something to work or want to know why I setup something in a certain way? Ping me on Twitter @mmistakes or file a GitHub Issue. And if you make something cool with this theme feel free to let me know.
License
This theme is free and open source software, distributed under the GNU General Public License version 2 or later. So feel free to use this Jekyll theme on your site without linking back to me or including a disclaimer.