jekyll-theme-strata

jekyll-theme-strata is a Jekyll theme based on the Strata HTML5 UP.

See example site.

Installation

Add this line to your Jekyll site's Gemfile:

gem "jekyll-theme-strata"

And add this line to your Jekyll site's _config.yml:

theme: jekyll-theme-strata

And then execute:

$ bundle

Usage

Strata comes with the jekyll-seo-tag plugin preinstalled. It uses the logo attribute as the site's avatar. Otherwise see usage for more details on the SEO plugin.

Changing Background

Changing the background can be done by adding the image you would like at the assets/images/bg.jpg path. This image should be 1274px x 1274px.

Social Icons

You can add links to your social accounts by adding one or more of the following options to your config.

twitter_username: ~
github_username:  ~
dribbble_username: ~
facebook_username: ~
flickr_username: ~
instagram_username: ~
linkedin_username: ~
pinterest_username: ~
youtube_username: ~
googleplus_username: ~
rss: true # false to hide rss icon

Enabling comments (via Disqus)

If you use Disqus for comments on your Jekyll blog, you can enable this with the following configuration:

disqus:
  shortname: my_disqus_shortname

Comments are only enabled in production builds (JEKYLL_ENV=production).

You can disable comments on a specific post by adding comments: false to the post's front matter.

Enabling Google Analytics

To enable Google Analytics, add this configuration:

google_analytics: UA-NNNNNNNN-N

Google Analytics are only enabled in production builds (JEKYLL_ENV=production).

Enabling Excerpts on the Home Page

To display post excerpts on the home page, add the following configration:

show_excerpts: true

Change Post Date Format

You can specify the date format of posts with the following configuration:

date_format: "%b %-d, %Y"

The format documentation can be found online.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/mloberg/strata-jekyll-theme. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Development

To set up your environment to develop this theme, run bundle install.

This theme is setup just like a normal Jekyll site! To test this theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using this theme and contents. As you make modifications, your site will regenerate and you should see the changes in the browser after a refresh.

License

The theme is available as open source under the terms of the MIT License.

Credits

This Jekyll theme is taken from Strata by HTML5 UP. Additionally, a lot inspiration was taken from Minima.

Original README from HTML5 UP:

Strata by HTML5 UP
html5up.net | @ajlkn
Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)


A simple, minimalist template that actually began life as an unused redesign of my
personal site. Includes a (configurable) parallax background effect, Poptrox-powered
lightbox gallery, a bunch of pre-styled elements, and Sass sources for the Sass-inclined.

Demo images* courtesy of Unsplash, a radtastic collection of CC0 (public domain) images
you can use for pretty much whatever.

(* = Not included)

Feedback, bug reports, and comments are not only welcome, but strongly encouraged :)

AJ
[email protected] | @ajlkn

PS: Not sure how to get that contact form working? Give formspree.io a try (it's awesome).


Credits:

    Demo Images:
        Unsplash (unsplash.com)

    Icons:
        Font Awesome (fontawesome.io)

    Other:
        jQuery (jquery.com)
        Responsive Tools (github.com/ajlkn/responsive-tools)