Skip to content
This repository has been archived by the owner on Aug 6, 2024. It is now read-only.

lacymorrow/casper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

fa1338a Β· Apr 30, 2024
Sep 2, 2018
Sep 9, 2014
Feb 3, 2018
May 19, 2015
Mar 19, 2019
Oct 16, 2014
Sep 2, 2018
Feb 24, 2018
Apr 19, 2014
Feb 5, 2018
Feb 5, 2018
Dec 9, 2015
Sep 2, 2018
Mar 20, 2014
Oct 21, 2015
Mar 20, 2014
May 10, 2014
Oct 16, 2014
Oct 16, 2014
Oct 16, 2014
Oct 21, 2015
Feb 16, 2016
Feb 16, 2016
Mar 21, 2014
May 16, 2014
Mar 31, 2014
Jun 6, 2020
Jul 15, 2018
Mar 20, 2014
Apr 30, 2024
Jul 23, 2015
Jul 15, 2018
Feb 3, 2018
Mar 20, 2014
Mar 21, 2014
Mar 20, 2014
Mar 19, 2019
Jun 6, 2020

Repository files navigation

Casper

A Ghost-like πŸ‘» WordPress theme

WordPress License: GPL v2

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.

Features

  • Search feature πŸ”¦
  • Comments section πŸ™Š
  • Customizer integration 🌈
  • Social icons pre-included 🐾
  • Responsive site and images πŸ›

screenshot

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

# Clone and install dependencies

$ git clone https://github.com/lacymorrow/casper.git
$ cd casper
$ npm install -g grunt-cli
$ npm install


# Build the distribution

$ grunt

or grunt watch to continuously build.

Grunt 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 (internationalization)

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! 🐞

Many thanks to the Ghost & WordPress teams, as well as the Underscores _s contributers, and kvendrik. β˜„οΈ

Built using all of the above. ⛄️

🏎 Roadmap

  • Update Casper WP to match the updated Ghost version - Casper 2!
  • Implement an update mechanism to pull changes from the Ghost project to keep the development in sync

License

GPL v2.0 Β© Lacy Morrow

All assets licensed under a GPL-compatible license.