Strapi 与 Gatsby 搭建的博客项目启动和配置教程

1. 项目目录结构及介绍

在克隆了 Strapi 与 Gatsby 搭建的博客项目后，你会看到一个如下的目录结构：

strapi-starter-gatsby-blog/
├── gatsby-site/                 # Gatsby 博客站点目录
│   ├── src/                     # 源代码目录
│   │   ├── components/          # React 组件
│   │   ├── templates/           # 页面模板
│   │   ├── utils/               # 工具函数
│   │   └── ...                  # 其他文件和目录
│   ├── gatsby-config.js         # Gatsby 配置文件
│   ├── gatsby-browser.js        # 浏览器相关的 Gatsby API
│   ├── gatsby-node.js           # Gatsby Node API
│   └── ...                      # 其他文件和目录
├── strapi/                      # Strapi 后端目录
│   ├── api/                     # API 目录
│   ├── config/                  # 配置文件目录
│   ├── extensions/              # 扩展目录
│   ├── plugins/                 # 插件目录
│   ├── scripts/                 # 脚本目录
│   └── ...                      # 其他文件和目录
├── docker-compose.yml           # Docker 配置文件
└── ...                          # 其他文件和目录

• gatsby-site/: 包含 Gatsby 博客站点的所有文件和目录。
• strapi/: Strapi 后端的代码和配置文件。

2. 项目的启动文件介绍

在 Strapi 项目中，启动文件通常是 strapi 目录下的 index.js 文件。以下是启动 Strapi 服务的基本步骤：

// strapi/index.js
const { createStrapi } = require('@strapi/strapi');

createStrapi().then(strapi => {
  strapi.start().then(() => {
    console.log('Strapi server is running on http://localhost:1337');
  });
});

在 Gatsby 项目中，启动文件是 gatsby-site/ 目录下的 gatsby-cli.js 或者你可以直接使用 npm run develop 或 yarn develop 命令来启动开发服务器。

3. 项目的配置文件介绍

• Strapi 配置文件: Strapi 的配置文件通常位于 strapi/config 目录下。以下是其中几个重要的配置文件：

  • config/database.js: 数据库配置，可以设置数据库的类型、连接信息等。
  • config/environments/development.js: 开发环境的特定配置。
  • config/environments/production.js: 生产环境的特定配置。

• Gatsby 配置文件: Gatsby 的主要配置文件是 gatsby-config.js，它位于 gatsby-site/ 目录下。以下是 gatsby-config.js 文件的一个基础示例：

module.exports = {
  siteMetadata: {
    title: `你的博客标题`,
    description: `你的博客描述`,
    author: `你的名字`,
  },
  plugins: [
    `gatsby-plugin-react-helmet`,
    `gatsby-plugin-image`,
    {
      resolve: `gatsby-source-filesystem`,
      options: {
        name: `images`,
        path: `${__dirname}/src/images`,
      },
    },
    `gatsby-transformer-sharp`,
    `gatsby-plugin-sharp`,
    // 更多插件...
  ],
};

这个配置文件定义了站点元数据，以及项目中使用的 Gatsby 插件。