readme.md

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.

Table of Contents

Usage

Download the zip package of the theme and install either automatically through the WordPress Dashboard > Appearance tab, or by uploading the casper 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.

Building Casper

Casper is open-source and simple to develop and extend.

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.

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

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.

Getting Involved

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