8b6c3b8e53
I'd rather not have anyone left in Ruby version or dependency hell. Here's hoping this saves us all! |
||
---|---|---|
src | ||
_config.yml | ||
.gitignore | ||
.gitlab-ci.yml | ||
Gemfile | ||
README.md | ||
spectral_jekyll_theme.gemspec |
How to Use
For those unfamiliar with how Jekyll works, check out https://jekyllrb.com/ for all the details, or read up on just the basics of front matter, writing posts, and creating pages.
Quickstart
In order to not blow up your computer handling a system wide Ruby installation, it is advised that you use RVM. Once you've got that installed and configured, get the latest version of Ruby with:
$ rvm install 2.4.2
Select that version and then create an isolated gemset with:
$ rvm use 2.4.2
$ rvm gemset create autonomic
Then you can get your Ruby dependencies installed with:
$ gem install jekyll bundler
And serve the website locally with:
$ jekyll serve
You can edit content in the .md
files under src
and src/_posts
.
When you're hacking later on (or in a new shell), you'll need to run:
$ rvm use 2.4.2
$ rvm gemset use autonomic
And then you'll have access to the environment.
Credits
Original README from HTML5 UP:
Spectral by HTML5 UP
html5up.net | @ajlkn
Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)
A big, modern, blocky affair with a mobile-style menu, fully responsive styling,
and an assortment of pre-styled elements. So, pretty much what you were expecting
-- except, of course, for how it's put together, specifically:
- It's built on Skel 3*, a leaner, more modular rewrite of my responsive framework.
(* = still in development as of this writing)
- It uses flexbox*, which eliminates all kinds of terrible hacks and clunky layout
stopgaps (like CSS grid systems).
(* = not supported on IE8/9, but non-flexbox fallbacks are included)
- It uses Sass* a lot more intelligently, thanks in part to several new mixins
and functions I've been working on (as well as a few by @HugoGiraudel).
(* = still entirely optional if you prefer vanilla CSS :)
- A ton of other stuff.
In short, Spectral's the culmination of several new things I'm working on/trying out,
so please, let me know what you think :)
Demo images* courtesy of Unsplash, a radtastic collection of CC0 (public domain) images
you can use for pretty much whatever.
(* = not included)
AJ
aj@lkn.io | @ajlkn
Credits:
Demo Images:
Unsplash (unsplash.com)
Icons:
Font Awesome (fortawesome.github.com/Font-Awesome)
Other:
jQuery (jquery.com)
html5shiv.js (@afarkas @jdalton @jon_neal @rem)
background-size polyfill (github.com/louisremi)
Misc. Sass functions (@HugoGiraudel)
Respond.js (j.mp/respondjs)
Skel (skel.io)
Repository Jekyll logo icon licensed under a Creative Commons Attribution 4.0 International License.