跳到內容

Ghost & Astro

本頁內容尚未翻譯。

Ghost is an open-source, headless content management system built on Node.js.

In this section, we’ll use the Ghost content API to bring your data into your Astro project.

To get started you will need to have the following:

  1. An Astro project - If you don’t have an Astro project yet, our Installation guide will get you up and running in no time.

  2. A Ghost site - It is assumed that you have a site set up with Ghost. If you don’t you can set one up on a local environment.

  3. Content API Key - You can make an integration under your site’s Settings > Integrations. From there you can find your Content API key

To add your site’s credentials to Astro, create an .env file in the root of your project with the following variable:

.env
CONTENT_API_KEY=YOUR_API_KEY

Now, you should be able to use this environment variable in your project.

If you would like to have IntelliSense for your environment variable, you can create a env.d.ts file in the src/ directory and configure ImportMetaEnv like this:

src/env.d.ts
interface ImportMetaEnv {
readonly CONTENT_API_KEY: string;
}

Your root directory should now include these new files:

  • 目錄src/
    • env.d.ts
  • .env
  • astro.config.mjs
  • package.json

To connect with Ghost, install the official content API wrapper @tryghost/content-api using the command below for your preferred package manager, and optionally, a helpful package containing type definitions if you are using TypeScript:

Terminal window
npm install @tryghost/content-api
npm install --save @types/tryghost__content-api

Making a blog with Astro and Ghost

Section titled Making a blog with Astro and Ghost

With the setup above, you are now able to create a blog that uses Ghost as the CMS.

  1. A Ghost blog
  2. An Astro project integrated with the Ghost content API - See integrating with Astro for more details on how to set up an Astro project with Ghost.

This example will create an index page that lists posts with links to dynamically-generated individual post pages.

You can fetch your site’s data with the Ghost content API package.

First, create a ghost.ts file under a lib directory.

  • 目錄src/
    • 目錄lib/
      • ghost.ts
    • 目錄pages/
      • index.astro
  • astro.config.mjs
  • package.json

Initialize an API instance with the Ghost API using the API key from the Ghost dashboard’s Integrations page.

src/lib/ghost.ts
import GhostContentAPI from '@tryghost/content-api';
// Create API instance with site credentials
export const ghostClient = new GhostContentAPI({
url: 'http://127.0.0.1:2368', // This is the default URL if your site is running on a local environment
key: import.meta.env.CONTENT_API_KEY,
version: 'v5.0',
});

The page src/pages/index.astro will display a list of posts, each with a description and link to its own page.

  • 目錄src/
  • 目錄lib/
    • ghost.ts
  • 目錄pages/
    • index.astro
  • astro.config.mjs
  • package.json

Import ghostClient() in the Astro frontmatter to use the posts.browse() method to access blog posts from Ghost. Set limit: all to retrieve all posts.

src/pages/index.astro
---
import { ghostClient } from '../lib/ghost';
const posts = await ghostClient.posts
.browse({
limit: 'all',
})
.catch((err) => {
console.error(err);
});
---

Fetching via the content API returns an array of objects containing the properties for each post such as:

  • title - the title of the post
  • html - the HTML rendering of the content of the post
  • feature_image - the source URL of the featured image of the post
  • slug - the slug of the post

Use the posts array returned from the fetch to display a list of blog posts on the page.

src/pages/index.astro
---
import { ghostClient } from '../lib/ghost';
const posts = await ghostClient.posts
.browse({
limit: 'all',
})
.catch((err) => {
console.error(err);
});
---
<html lang="en">
<head>
<title>Astro + Ghost 👻</title>
</head>
<body>
{
posts.map((post) => (
<a href={`/post/${post.slug}`}>
<h1> {post.title} </h1>
</a>
))
}
</body>
</html>

The page src/pages/post/[slug].astro dynamically generates a page for each post.

  • 目錄src/
  • 目錄lib/
    • ghost.ts
  • 目錄pages/
    • index.astro
    • 目錄post/
      • [slug].astro
  • astro.config.mjs
  • package.json

Import ghostClient() to access blog posts using posts.browse() and return a post as props to each of your dynamic routes.

src/pages/post/[slug].astro
---
import { ghostClient } from '../../lib/ghost';
export async function getStaticPaths() {
const posts = await ghostClient.posts
.browse({
limit: 'all',
})
.catch((err) => {
console.error(err);
});
return posts.map((post) => {
return {
params: {
slug: post.slug,
},
props: {
post: post,
},
};
});
}
const { post } = Astro.props;
---

Create the template for each page using the properties of each post object.

src/pages/post/[slug].astro
---
import { ghostClient } from '../../lib/ghost';
export async function getStaticPaths() {
const posts = await ghostClient.posts
.browse({
limit: 'all',
})
.catch((err) => {
console.error(err);
});
return posts.map((post) => {
return {
params: {
slug: post.slug,
},
props: {
post: post,
},
};
});
}
const { post } = Astro.props;
---
<!DOCTYPE html>
<html lang="en">
<head>
<title>{post.title}</title>
</head>
<body>
<img src={post.feature_image} alt={post.title} />
<h1>{post.title}</h1>
<p>{post.reading_time} min read</p>
<Fragment set:html={post.html} />
</body>
</html>

To deploy your site visit our deployment guide and follow the instructions for your preferred hosting provider.

More CMS guides

Contribute

What’s on your mind?

Create GitHub Issue

Quickest way to alert our team of a problem.

Community