codesquadhud / banquo

Portfolio oriented Ghost theme

BANQUO

Good sir, why do you start; and seem to fear / Things that do sound so fair?

Please Note! This project is no longer maintained. At the time of building it, I believe I was working with Ghost 0.9! ⚓️⚓️⚓️

The Banquo home page

---

Banquo is a Ghost theme that aims to be a portfolio-first site, with a side of blogging/note taking. Banquo operates a bit differently than some standard Ghost themes, in that post-loops exist in more than one place, and are targeted at specific post types. This functionality comes with some trade-offs due to the way Ghost handles working with different loops, so before I go on any further, let me describe a use case. This theme maybe be useful for you if you:

• want to display your work immediately when people visit your site,
• You want your work / portfolio / projects (henceforth, "projects") page to be image-first / have thumbnails.
• You want the option of blogging.

Seeing that this is a bit more specialized of a theme, it does take a bit of setup to get started. Please note that this theme currently does not work with Ghost's new "upload theme" feature. You will have to manually clone the theme into your Ghost themes folder on your server.

Enable Public API

You'll need to enable public API in your (at the time of writing this) Ghost Labs in the dashboard. This allows post loops to query the database for posts by specific filters (in this case, by the tags). See the screenshot below:

The Project Page (Home Page)

• Any post that you want to be featured as a "project" post on the home page needs to be tagged as "project".

• If you do not include a featured image, you will have an nice broken image link displayed instead. I might eventually put something in that anticipates that mistake (a placeholder image), but for now, forgetting to upload a post image will result in this:

_{^{Note: The title of the post won't automatically become "SHIT". That was my post title for demonstrative purposes.}}

The Notes / Blog page.

"Notes" page

• Creating a blog is a bit involved, but stick with me here.
• In your ghost admin dash you'll need to create a static page called "notes". Because ghost allows you to create custom pages with their own custom styling, the page (for now, pending future updates) needs to called notes in order to line up with the page-notes.hbs file.
• Similar to any project post you create, you'll need to add a note tag when creating your post.

Other Screenshots

---

A standard post

Build Instructions

Note: you may need to preface build instructions with sudo depending on where you are building.

git clone https://github.com/teesloane/banquo.git

npm install

bower install

grunt staging // compiles the css / js assets

Contributions

All development happens on the develop branch.

Credits

Thanks to GhostSheet for stripping a Ghost theme down to nothing so building from scratch was no problem at all.