Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/teesloane/banquo
Portfolio oriented Ghost theme
https://github.com/teesloane/banquo
Last synced: about 12 hours ago
JSON representation
Portfolio oriented Ghost theme
- Host: GitHub
- URL: https://github.com/teesloane/banquo
- Owner: teesloane
- License: mit
- Created: 2016-08-10T23:40:37.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-06-27T14:13:38.000Z (over 4 years ago)
- Last Synced: 2024-11-01T09:51:45.553Z (8 days ago)
- Language: CSS
- Homepage:
- Size: 43 KB
- Stars: 21
- Watchers: 6
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - teesloane/banquo - Portfolio oriented Ghost theme (others)
README
# 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](https://github.com/Cloudoki/ghostSheet) for stripping a Ghost theme down to nothing so building from scratch was no problem at all.