Skip to content
A Gatsby starter for creating blogs from headless Ghost CMS.
JavaScript
Branch: master
Clone or download

Latest commit

cws
Latest commit 336f7ac Apr 3, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Mar 20, 2020
src/gatsby-theme-try-ghost/styles update to new theme Mar 25, 2020
static latest Feb 25, 2020
.editorconfig init Feb 25, 2020
.eslintignore init Feb 25, 2020
.eslintrc.js init Feb 25, 2020
.gitignore checking Mar 13, 2020
LICENSE init Feb 25, 2020
README.md more addons Mar 31, 2020
gatsby-config.js introducing dark mode Mar 27, 2020
package.json fix wrong meta tags in posts Apr 3, 2020
siteConfig.js init Feb 25, 2020
starters.yml init Feb 25, 2020
yarn.lock fix wrong meta tags in posts Apr 3, 2020

README.md

gatsby-starter-try-ghost

Released under MIT license. gatsby-starter-try-ghost npm package version.

A Gatsby starter for creating blogs from headless Ghost CMS.

Turn your Ghost blog into a lightning fast static website. This Gatsby theme is a front-end replacement of the Ghost Handlebars engine featuring the standard Ghost Casper skin and functionality. All content is sourced from a headless Ghost CMS.

Demo

Play with the Demo to get a first impression.

gatsby-starter-try-ghost

 

Features

  • Ghost Casper look and feel
  • Sticky navigation headers
  • Gatsby images NEW
  • Hover on author avatar
  • Secondary navigation
  • Styled 404 page
  • SEO optimized
  • Fully responsive
  • Composable and extensible

Performance

Lighthouse Score

Included Addons

The following addons have been included for convenience:

If you don't need them, you can take them out in gatsby-config.js and package.json which may save you some time during the build process.

More Addons

Additional features can be integrated by installing Gatsby themes or plugins. The following plugins have been tested to work with this repository:

Getting Started

  1. Install this starter by running

    gatsby new try-ghost https://github.com/styxlab/gatsby-starter-try-ghost
  2. Change directory

    cd try-ghost
  3. Run

    gatsby develop

    and visit your site at http://localhost:8000.

Configure

    //siteConfig.js
    module.exports = {
        // Do not include a trailing slash!
        siteUrl: `https://your-blog.com`, 
    
        // This allows an alternative site title for meta data for pages.
        siteTitleMeta: `Gatsby Starter Ghost CMS`, 

        // This allows an site description for meta data for pages.
        siteDescriptionMeta: `Gastby Starter with Ghost CMS and Casper Skin`, 
    
        // Change to the width and height of your default share image
        shareImageWidth: 1000, 
        shareImageHeight: 523,
    
        // Used for App and Offline manifest e.g. Mobile Home Screen
        shortTitle: `Ghost`, 
        siteIcon: `favicon.png`, 
        backgroundColor: `#e9e9e9`,
        themeColor: `#15171A`,
    }

In the configuration shown above, the most important fields to be changed are siteUrl, siteTitleMeta and siteDescriptionMeta. Update at least those to fit your needs.

Ghost Content API keys

All content is sourced from a Ghost CMS. If you don't customize the file .ghost.json content is fetched from the demo location at https://cms.gotsby.org. Surely you want to source your own content. Change the keys to match your own Ghost CMS Content API keys:

    {
        "development": {
            "apiUrl": "http://localhost:2368",
            "contentApiKey": "9fccdb0e4ea5b572e2e5b92942"
        },
        "production": {
            "apiUrl": "http://localhost:2368",
            "contentApiKey": "9fccdb0e4ea5b572e2e5b92942"
        }
    }

Deploy

    gatsby build

After completion of the build process your static site can be found in the public/ folder. Copy those files over to your webserver.

Deploying on Gatsby Cloud

Fork gatsby-starter-try-ghost in GitHub. After logging into Gatsby Cloud make sure Gatsby Cloud has access rights to your forked repository. Select I already have a Gatsby Site and then pick gatsby-starter-try-ghost. Skip integrations. For a first test also skip content keys. The build should start immediately and show the demo site. Provide content keys in order to source in your own content from Ghost CMS.

Ensure headless mode of Ghost CMS

For best SEO results it is strongly recommended to disable the default Ghost Handlebars theme front-end by selecting the Make this site private flag within your Ghost admin settings. This enables password protection in front of the Ghost install and sets <meta name="robots" content="noindex" /> so your Gatsby front-end becomes the source of truth for SEO.

Reporting issues

Please report all bugs and issues at gatsby-theme-try-ghost/issues as all development is happening there.

Copyright & License

Copyright (c) 2020 styxlab - Released under the MIT license.

You can’t perform that action at this time.