doc22940 / oscar-ghost

👻Simplistic, Clean, Content Focus Single Author Theme

Oscar for Ghost

Demo: blog.oscarmorrison.com

Introduction

The Oscar Ghost Theme is a clean, simple, minimalistic theme built for ghost. The theme is built from an original fork of the Lanyon-Ghost Theme.

This theme is ideal for single author, tag heavy, looking for a simple design, with code highlighting.

Installation

• Download the latest release .zip
• Go to your ghost settings page, and upload .zip and activate theme. More info

Updates

• v2.0.2 (26 Aug 18)
  • Fix #26 (tag header not working)
• v2.0.1 (26 Aug 18)
  • Changes for Ghost Marketplace
• v2.0.0 (26 Aug 18)
  • Changes for Ghost 2.0
• v1.1.0 (7 Jun 18)
  • Updates for Ghost v1.X
• v1.0.4 (8 Jan 17)
  • Add ability to config features
  • Add tag sub menu
• v1.0.3 (4 Jan 17)
  • Support additional language for syntax highlighting (Go, Python, MD)
• v1.0.2 (3 Dec 16)
  • Add next and previous post links to Post.hbs
  • Open all external links in new tab
• v1.0.1 (3 Dec 16)
  • Support for  Ghost 0.11.3
  • Added new icons
• v1.0.0 (24 May 16)
  • Support for Ghost 0.8.0

Features

• Configurable Features
• Custom Navigation Menu (#7)
• Submenu for tags (#20)
• Prism.js Code Highlighting (Markup, Bash, Swift, JS, C, Go, Python...)
• Font: Lato weights 100,300,300italic
• Automatic internal and external linking
• Featured Image on Posts
• Custom Tag Home Page
• Tag Styling
• Date Styling
• Single Author (no Author on Posts)
• Gallery Viewer (Photoswipe) (#10)
• Custom Gallery Post Listing

Customization

Configuration

I have included with v1.0.4 a way to do some basic feature configuration that is often asked for: These are the default values (found in oscar.js):

let oscar = {
    animatedNav: true,
    tagMenu: true,
    tagKey: '#tagnav',
    requirePosts: false
};

animatedNav: if the nav auto hides, or is shown
tagMenu: if the secondary tag menu is shown
tagMenu is dependant on ghost api beta feature this can be turned on under [Ghost Admin] -> [Labs] -> [Public API]
tagKey: what the custom key to look for in the tag description is. (this can be any string)
requirePosts: show only tags that have posts in them

Navigation

The navigation menu can be customize through the ghost admin, the theme come with 32 custom icons that can be used in the nav bar menu.
Please see here for all icons http://ogem.co/blogiconmoon
simply just use the icon class name
e.g icon-twitter for -> twitter.

Gallery

To get the full benefits of the Gallery Viewer (Photoswipe) in a blog post, simply tag the post with gallery. Any post that is of type gallery will get special behavior.

• Gallery Post will be displayed differently in a the list post view, they will show special gallery icon, and will not show any description.
• Gallery Post will have special behavior for the user. The images will all have a cursor pointer and be clickable. Once any image is clicked, the photoswipe viewer will open in full view.
• To add images to a gallery post, add them as you normally would with any post.

Code Syntax Highlighting

Use prismjs for syntax highlighting.
in your blog symply surround code block with:

```language-bash

Installation

• Download the Theme .zip
• Install the Theme (Instructions]
  • Unzip the folder and upload to 'ghost/content/themes'
  • Restart ghost and log in
  • Go to settings > themes and select Upholsterygeist

Cost

Free. As in free beer...
If you like the theme, and would like me to keep building cool free ghost themes feel free to buy me a beer.

Author

Oscar Morrison

• https://github.com/oscarmorrison
• https://twitter.com/oscargemorrison

License

Open sourced under the MIT license.