/casper

A port of Ghost's Casper theme to Wordpress

Primary LanguageCSSGNU General Public License v2.0GPL-2.0

Casper

A Ghost-like WordPress theme

Casper (for WordPress) is a simple yet beautiful theme for bloggers.

Inspired by the Ghost blogging platform, Casper is a WordPress port of the default theme by the same name. The goal of this project is to emulate the gorgeous theme while taking advantage of features exclusive to the WordPress framework. There are plenty of customization options included, accessible through the WordPress Customizer. Already included are hooks to serve responsive images appropriately and media queries to provide a fast and seamless experience from desktop to mobile.

Usage

Download the zip package of the theme and install either automatically through the WordPress Dashboard > Appearance tab, or by uploading the casper-wp folder to your WordPress/wp-content/themes directory.

The style.css file in the theme directory is minified. A human-readable version of is located at css/style.css.

Editing Casper

The recommended way to edit the Casper theme is to use the Casper child theme. This will ensure that none of your changes will be lost when you update Casper. Install and activate the child theme and make changes as you would normally. Any file included in the theme will override a Casper theme file (exceptions being functions.php and style.css).

If you want to make changes to the core theme, or want to contribute, read below on how to build the package.

Using Grunt to build the package

A gruntfile.js is included. cd into the theme directory and run npm install to install Grunt and all dependencies locally. Run grunt to build or grunt watch to continuously build.

i18n

To generate a .pot language file you must have xgettext installed. On OSX using homebrew run brew install gettext && brew link gettext --force to install. Run grunt i18n to generate language files.

Tasks
  • Compile src/css/style.less and other LESS and CSS files in src/css/
  • Any CSS is combed, linted, prefixed, then compiled with css/style.css
  • css/style.css is minified into style.css
  • Images in src/img/ are compressed and copied to img
  • Theme JavaScript and other js files in src/js/ are linted, minified, and combined into js/main.js

Getting Involved

Want to report a bug, request a feature, or help me build this project? The more the merrier!

Many thanks to the Ghost & WordPress teams, as well as the Underscores _s contributers, and kvendrik. Built using all of the above.

Roadmap

License

GPL v2.0 © Lacy Morrow

All assets licensed under a GPL-compatible license.