A programming-oriented theme for Ghost
CSS HTML JavaScript
Clone or download
Pull request Compare This branch is 257 commits ahead, 10 commits behind TryGhost:master.
dlecina Merge branch 'master' of github.com:dlecina/StayPuft
# Conflicts:
#	.gitignore
#	LICENSE
#	README.md
#	amp.hbs
#	assets/css/prism.css
#	assets/css/screen.css
#	assets/js/index.js
#	author.hbs
#	default.hbs
#	index.hbs
#	package.json
#	page.hbs
#	post.hbs
#	tag.hbs
Latest commit e9de928 Apr 28, 2018

README.md

StayPuft

A programming-oriented theme for Ghost. This is the latest development version of StayPuft. If you're just looking to download the latest release, head over to the releases page.

screenshot-mockup

Features

Demo

This theme is being used in my blog.

Compatibility

The current StayPuft version is 2.2.1, is tested against Ghost 1.22.3 and is expected to work with Ghost 1.2.0.

If the current version of StayPuft is not compatible with the version of Ghost you're running, try looking for an older one in the Releases section.

Installation

  • Clone the repository or download the latest release and extract it.
  • Copy partials/custom/nav-external.hbs.example to partials/custom/nav-external.hbs and customize it with your own external links.
  • (Optional) Copy partials/custom/disqus.hbs.example to partials/custom/disqus.hbs and customize it with your Disqus shortname.
  • Run yarn zip in the theme's root directory to create dist/StayPuft.zip.
  • Go to your blog's Settings page (typically /admin or /ghost).
  • In the Design tab, upload and activate StayPuft.
  • (Optional) In the Code Injection tab, add any snippets you may need, such as Google Analytics.

FAQ

  1. Where should I report issues or request a new feature?

The appropriate place to report issues or request new features is the Issues section.

  1. Where should I discuss other topics?

To discuss other topics, please find an appropriate post in my blog's Staypuft tag and post a comment there.

  1. How can I disable comments?

To disable comments, simply remove the line {{> "post-comments"}} from post.hbs and page.hbs. You do not need disqus.hbs in this case.

  1. How can I disable comments only on pages?

To disable comments only on pages, simply remove the line {{> "post-comments"}} from page.hbs.

  1. How do I use Syntax Highlighting with Markdown?

See the Syntax highlighting demo.

Development

StayPuft styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need Node, Yarn and Gulp installed globally. After that, from the theme's root directory:

$ yarn install
$ yarn dev

Now you can edit /assets/css/ files, which will be compiled to /assets/built/ automatically.

You can keep Ghost running in your local development environment by running this from Ghost's root directory:

nodemon current/index.js --watch content/themes/StayPuft --ext hbs,js,css

Copyright & License

Copyright (c) 2013-2018 Ghost Foundation - Released under the MIT license.
Copyright (c) 2014-2018 David Lecina Fuentes - Released under the MIT license.