Managing a ghost(pro) blog

Notes on ghost theme management for a future Melanie

Your repository

You have a ghost development repository in your projects directory called dev-ghost.

Casper theme development

To modify the Casper theme, you'll need to cd into the casper directory, located at content/themes/casper. You've set up a nice shortcut in your .bash_profile too at casper.

Casper uses Handlebars as its templating language. Refer to the wonderful docs to remind yourself how to use for theme development: https://ghost.org/docs/api/v3/handlebars-themes/

This time around, you've decided to migrate to collections to organize your content. Read about collections here: https://ghost.org/docs/api/v2/handlebars-themes/routing/collections/

When you make CSS changes, you will have to push the built assets to github. Don't forget to follow Casper's instructions for building your CSS! At the time of this writing, you would use yarn install and yarn dev to build your assets automatically. You can read the docs for the Casper theme here.

The github repository casper, when downloaded as a ZIP file, is uploaded directly on your ghost(pro) admin page. This means that there is no building or compiling happening for you outside of the local build. If you decide to get fancier and automate the update process, perhaps this will change.

Keep in mind: Handlebars provides many helper functionalities that work like magic. View the get request or next_post for info:

Also, certain words are keywords within Ghost. In particular, having a collection named private does not work; it conflicts with the naming of a password-protected domain, which will redirect to [url]/private to ask the visitor for a password.