Hawk Radius (Built using gatsby-starter-try-ghost)

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 the standard Ghost Casper skin and functionality. All content is sourced from a headless Ghost CMS.

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
• Infinite Scroll ✨ 🆕
• Gatsby images 🚀
• Featured posts pinned on top 🆕
• Sticky navigation headers
• Hover on author avatar
• Styled 404 page
• SEO optimized
• Fully responsive
• Advanced routing 🆕
• Composable and extensible

Performance

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-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

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

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

        // Select inline texts based on your locale
        locale: `en`,
        
        // 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. In your base directory try-ghost, add a new file .ghost.json that contains the following JSON structure:

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

Change the url and keys to match your own Ghost CMS Content API keys.

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.

Deploy on Netlify

The theme and starter contain two config files specifically for deploying with Netlify. A netlify.toml file for build settings, and a /static/_headers file with default security headers set for all routes.

To deploy to your Netlify account, hit the button below.

Content API Keys are generally not considered to be sensitive information, they exist so that they can be changed in the event of abuse; so most people commit it directly to their .ghost.json config file. If you prefer to keep this information out of your repository you can remove this config and set Netlify ENV variables for production builds instead.

Once deployed, you can set up a Ghost + Netlify Integration to use deploy hooks from Ghost to trigger Netlify rebuilds. That way, any time data changes in Ghost, your site will rebuild on Netlify.

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.

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.