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 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 aj@lkn.io | @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)