Skip to content

Uno - a minimal, responsive theme for Ghost CMS ported to KeystoneJS

Notifications You must be signed in to change notification settings

mgan59/keystone-theme-uno

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Uno for KeystoneJS

Uno for KeystoneJS is a port of the Uno Ghost Theme originally created by daleanthony.com. The theme features a minimal, responsive design with a cover page, disqus comment integration, foundation icons and various colour options.

This project requires the setup and configuration of KeystoneJS using Handlebars (HBS) as the rendering option. Any problems / issues setting up this theme should be raised on this repo and not on the original repo by Dale Anthony.

For instructions on usage and installation view the documentation

Demo

There's a demo of the Uno-KeystoneJS theme running on my personal website morgancraft.com or you can view the original Ghost verion on the original designers personal website daleanthony.com.

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 Uno includes 5 different colour options for you to chose from.

Future KeystoneJS is a CMS and has additional features such as Photo Galleries and Contact Forms with new features being planned. There are plans to support these additional features in time. Most likely Contact Forms will be added shortly to the KeystoneJS design.

Also, css/feature parity maintenance will be attempted for Ghost as well.

FAQs

Uno-KeystoneJS is the first attempt to bridge the HBS Rendering Engine of KeystoneJS to be fully-functional with the Ghost Publishing platform. Questions or Issues with it should be expressed on this project repo and not on the primary Ghost Uno Theme.

Ghost Theme FAQ

Some common questions are answered on the Uno FAQ page

Contact

The best way to contact me is by dropping me an email or my messaging me on Twitter

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:public/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

About

Uno - a minimal, responsive theme for Ghost CMS ported to KeystoneJS

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published