I'd rather not have anyone left in Ruby version or dependency hell. Here's hoping this saves us all!
2.9 KiB
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.