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.
🔥 Variants
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
-
Install this starter by running
gatsby new try-ghost https://github.com/styxlab/gatsby-starter-try-ghost
-
Change directory
cd try-ghost
-
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.