README.md

Jamify's blog starter

A Gatsby starter for creating blogs from headless Ghost CMS.

Turn your Ghost blog into a flaring fast static website. This Gatsby theme is a front-end replacement of the Ghost Handlebars engine featuring an enhanced Ghost Casper look and feel. All content is sourced from a headless Ghost CMS.

 

⚠️ I am no longer actively maintaining this plugin, but PRs for fixes and version updates are most welcome!

 

🔥 Alternatives

Tired of gatsby-config.js? Check out Blogody for an integrated solution with many more benefits!

Favor Next.js over Gatsby? Head over to next-cms-ghost!

 

🎓 Tutorials

Check out the Tutorials for practical guides on using this project.

 

🎉 Demo

Play with the Demo to get a first impression.

 

✨ Features

• Ghost Casper look and feel
• Images with lazy-loading and blur-up effect 🚀 🆕
• Infinite Scroll ✨
• Featured posts pinned on top 🆕
• Sticky navigation headers
• Hover on author avatar
• Styled 404 page
• SEO optimized
• Fully responsive
• Advanced routing 🆕
• Composable and extensible
• Incremental build enabled 🚀 🆕

 

📦 Included Plugins

The following plugins have been included for convenience:

Name	Version	Description
gatsby-theme-ghost-dark-mode		Dark mode toggle 🌗
gatsby-rehype-ghost-links		Rewrite CMS links from absolute to relative
gatsby-rehype-prismjs		Syntax highlighting with PrismJS
gatsby-theme-ghost-members 🆕		Member Subscriptions

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 Plugins

Additional features can be integrated by installing Gatsby themes or plugins. The following plugins have been tested to work with gatsby-starter-try-ghost:

Name	Version	Description
gatsby-rehype-inline-images 🆕		Lazy-loading inline images with blur-up
gatsby-theme-ghost-contact		Contact page
gatsby-theme-ghost-commento		Commenting system with Commento
gatsby-theme-ghost-toc 🆕		Table of Contents
gatsby-plugin-ackee-tracker		Site tracking with Ackee
gatsby-plugin-google-analytics		Site tracking with Google Analytics

 

🏁 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

   yarn 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`,

    // Maximum number of post shown per page
    // Infinite Scroll: Initial chunk of posts, subsequent posts are fetched one by one
    postsPerPage: 3,

    // 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: `Turn your Ghost blog into a flaring fast static site with Gatsby`,

    // Used for App and Offline manifest e.g. Mobile Home Screen
    shortTitle: `Ghost`,
    siteIcon: `favicon.png`,
    backgroundColor: `#e9e9e9`,
    themeColor: `#15171A`,

    // Include Gatsby images for lazy loading and image optimizations (default: true)
    gatsbyImages: true,

    // Overwrite navigation menu (default: []), label is case sensitive
    // overwriteGhostNavigation: [{ label: `Home`, url: `/` }],
};

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. By default, content is fetched from the demo location at https://cms.gotsby.org. Surely you want to source your own content. There are two ways to make your content keys available. Choose the method according to your build scenario.

Building with cloud providers

If you build your project with a cloud provider (e.g. Gatsby, Netlify, Vercel), the best option is to provide the keys with environment variables:

Key	Value (example)
GHOST_API_URL	http://localhost:2368
GHOST_CONTENT_API_KEY	9fccdb0e4ea5b572e2e5b92942

The place where you can define them depends on the provider, but you usually find the option under the site settings. This avoids publishing keys in a public repository and is most secure.

Building locally

If you build locally or on a private network where the build directory is not accessible to the world, you can safely add a new .ghost.json file in your base directory with the following JSON structure:

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

This file is part of .gitignore to avoid accidentally publishing it to your public repository. Change the apiUrl and contentApiKey to match your own Ghost CMS Content API keys.

 

🤯 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 authoritative source for search engines.

 

💫 Deploy

 

🔧 Update

It is recommended to install npm-upgrade with sudo npm install npm-upgrade -g. Change into the base directory and update all packages with:

    npm-upgrade

You will be prompted to update all packages within your package.json file. Next, download the new packages:

    yarn
    yarn clean

The update process is now complete and you can start a new build with yarn build (or yarn develop).

 

💣 Reporting issues

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

 

🧐 Disclaimer

This project is not affiliated with Gatsby or Ghost.

 

Copyright & License

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