Spo - A Theme for Ghost
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
partials
README.md
default.hbs
error.hbs
index.hbs
package.json
page.hbs
post.hbs
tag.hbs

README.md

Spo - A Theme for Ghost

Spo - A Theme for Ghost is an inspiration from the Uno Ghost theme. The theme features a minimal, responsive design with a cover page, disqus comment integration, foundation icons and various colour options.

Features

Cover page The landing page for Uno is a full screen 'cover' featuring your avatar, blog title, mini-bio and cover image.

Built with SASS, using BEM If you know HTML and CSS making modifications to the theme should be super simple.

Responsive Uno looks great on all devices, even those weird phablets that nobody buys.

Disqus comments Disqus integration allows users to comment on your posts.

Foundation icons Uno contains the Foundation icon font by Zurb which means you can easily add icons. A full list of available icons can be found on the Foundation Icon website.

No-JS fallback While JS is widely used, some themes and websites don't provide fallback for when no JS is available (I'm looking at you Squarespace). If for some weird reason a visitor has JS disabled your blog will still be useable.

1 theme, 5 colour options Spo includes 5 different colour options for you to chose from.

Licence

Creative Commons Attribution 4.0 International

Development

In order to develop or make changes to the theme you will need to have the sass compiler and bourbon both installed. If you are running a Ghost environment locally then you should already have these installed as those are required to run Ghost.

To check installation run the following commands from a terminal and you should see the > cli output but your version numbers may vary.

** SASS **

sass -v
> Sass 3.3.4 (Maptastic Maple)

If for some reason SASS isn't installed follow the instructions from the Sass install page

** Bourbon **

bourbon help
> Bourbon 3.1.8

If Bourbon isn't installed follow the installation instructions on the Bourbon website

Once installation is verified we will need to go mount the bourbon mixins into the scss folder.

From the project root run bourbon install with the correct path

bourbon install --path assets/scss
> bourbon files installed to assets/scss/bourbon/

Now that we have the bourbon mixins inside of the scss src folder we can now use the sass cli command to watch the scss files for changes and recompile them.

sass --watch assets/scss:assets/css
>>>> Sass is watching for changes. Press Ctrl-C to stop.

** MacOSX Maverick **

Some people may receive this error when trying to run the sass --watch command

> LoadError: cannot load such file -- rb-fsevent
  Use --trace for backtrace.

This is a known issue with the Sass on MaxOS Maverick as indicated install the rb-fsevent gem

gem install rb-fsevent