openmined / openmined-ghost-theme

SOON TO BE DEPRECATED - The theme for the OpenMined and Weekly Digs blogs.

DEPRECATION NOTICE

Warning, this repository will soon be deprecated in favor of openmined-website.

OpenMined

The default theme for all OpenMined Ghost blogs. This is based heavily on the default Ghost theme Casper.

Development

Styles are compiled using SASS. We use autoprefixer, so you don't worry about writing browser prefixes of any kind, it's all done automatically with support for the latest 2 major versions of every browser. You'll need Node and Gulp installed globally. After that, from the theme's root directory:

$ yarn install
$ yarn dev

Now you can edit /assets/scss/ files, which will be compiled to /assets/built/ automatically.

The zip Gulp task packages the theme files into dist/<theme-name>.zip, which you can then upload to the blog of your choice.

$ yarn zip

openmined-ghost-theme's Issues

Fix incompatibilities with Ghost 3.0

Upon upgrading, I am now receiving the following errors on the Ghost theme:

Errors
    File: error.hbs
    - The {{@blog}} helper should be replaced with {{@site}}
    - Replace {{error.code}} with {{error.statusCode}}
    File: partials/header.hbs
    - The {{@blog}} helper should be replaced with {{@site}}
    File: default.hbs
    - The {{lang}} helper should be replaced with {{@site.lang}}
    File: styles
    - The .kg-bookmark-card CSS class is required to appear styled in your theme
    - The .kg-bookmark-container CSS class is required to appear styled in your theme
    - The .kg-bookmark-content CSS class is required to appear styled in your theme
    - The .kg-bookmark-title CSS class is required to appear styled in your theme
    - The .kg-bookmark-description CSS class is required to appear styled in your theme
    - The .kg-bookmark-metadata CSS class is required to appear styled in your theme
    - The .kg-bookmark-icon CSS class is required to appear styled in your theme
    - The .kg-bookmark-author CSS class is required to appear styled in your theme
    - The .kg-bookmark-publisher CSS class is required to appear styled in your theme
    - The .kg-bookmark-thumbnail CSS class is required to appear styled in your theme

This issue has many parts.

1. We need to fix all the errors in error.hbs.
2. We need to fix all the errors in partials/header.hbs.
3. We need to fix all the errors in default.hbs.
4. We don't need to add styles for the places where a class is missing in our theme. However, we should add empty style definitions. Here's the first two done for you:

.kg-bookmark-card {}
.kg-bookmark-container {}

Upgrade to Ghost 2.0

This may also allow us the ability to re-combine digs and blog into one place as separate "Collections".