vekar / abstraktion

Jekyll based website for my personal blog and portfolio, now assuming the Abstraktion moniker

Abstraktion

My Jekyll powered blog and portfolio. I chose to open source this to provide a starting point for anyone looking to rapidly develop websites with Jekyll.

Getting started

The website is powered by Jekyll and uses a number of Ruby gems to aid frontend development. Getting started is easy though, simply git clone the repository and from it's root install gem dependencies with bundle install --path vendor/bundle.

You now have dependencies like Jekyll Assets installed, so go ahead and start jekyll with bundle exec jekyll serve --watch. You should now be able to view the website.

Development

All content and assets live in the source directory. The Jekyll assets Gem provides sprockets style compiling and serving of assets. I've used SASS and compass for elegant stylesheets. Content, where possible is written in markdown, for more complex views, I've used HAML.

Deployment

I serve the website directly from S3. Deployment comes courtesy of the S3 website Gem. In order to deploy, an s3_website.yml will need to be added to the root of the project, similar to this:

s3_id: ABC
s3_secret: XYZ
s3_bucket: 123

s3_endpoint: eu-west-1

gzip:
  - .html
  - .css
  - .md

gzip_zopfli: true

s3_reduced_redundancy: true

The website can then be built and deployed with: bundle exec jekyll build && bundle exec s3_website push.