Next.js for Drupal 多语言模板项目教程

1. 项目目录结构及介绍

本项目是基于 Next.js 和 Drupal 构建的一个多语言模板，旨在提供一个快速启动的 decoupled Drupal 和 Next.js 网站。以下是项目的目录结构及各部分的简要介绍：

next-drupal-starterkit/
├── .circleci/            # CircleCI 持续集成配置文件
├── .ddev/                # DDEV 本地开发环境配置文件
├── .gitattributes         # Git 属性配置文件
├── .gitignore            # Git 忽略文件列表
├── .lando.yml             # Lando 本地开发环境配置文件
├── CHANGELOG.md          # 项目更新日志
├── README.md             # 项目说明文件
├── docker-compose.yml    # Docker 编排文件
├── drupal/               # Drupal 相关文件和目录
├── next/                 # Next.js 前端项目目录
├── setup-ddev.sh         # DDEV 环境初始化脚本
├── setup-lando.sh        # Lando 环境初始化脚本
├── silta/                # SIlta 托管系统相关文件
└── wunder_search/        # 自定义 Drupal 模块目录

• .circleci/: 包含 CircleCI 的配置文件，用于自动化测试和部署。
• .ddev/: 包含 DDEV 的配置文件，用于本地开发环境。
• .gitattributes: 配置 Git 处理不同类型文件的方式。
• .gitignore: 定义哪些文件和目录应该被 Git 忽略。
• .lando.yml: 包含 Lando 的配置文件，用于本地开发环境。
• CHANGELOG.md: 记录了项目的版本更新和修改历史。
• README.md: 项目的主说明文件，包含了项目的简介和使用方法。
• docker-compose.yml: 定义了 Docker 容器的编排，包括网络和卷的配置。
• drupal/: 包含 Drupal 后端相关的文件和目录。
• next/: Next.js 前端项目的目录，包含了前端代码和静态文件。
• setup-ddev.sh: 用于初始化 DDEV 环境的脚本。
• setup-lando.sh: 用于初始化 Lando 环境的脚本。
• silta/: 包含 SIlta 托管系统相关的文件。
• wunder_search/: 自定义的 Drupal 模块目录，用于搜索功能。

2. 项目的启动文件介绍

项目的启动主要通过两个脚本来完成，分别是 setup-ddev.sh 和 setup-lando.sh。

• setup-ddev.sh: 在 DDEV 环境中运行此脚本会初始化 Drupal 和 Next.js 环境，包括安装依赖、创建数据库、导入演示内容等。
• setup-lando.sh: 在 Lando 环境中运行此脚本会执行类似的操作，但会根据 Lando 的特定配置来初始化环境。

使用这些脚本时，可以通过命令行参数进行一些额外的配置，例如使用 -c 参数来清除之前的设置并从头开始。

3. 项目的配置文件介绍

项目中的配置文件主要用于设置本地开发环境和 Drupal、Next.js 的相关配置。

• .lando.yml: Lando 的配置文件，定义了项目的服务、环境和变量等。例如，可以指定使用的 PHP 版本、数据库连接信息等。
• .ddev/: DDEV 的配置文件目录，包含了类似 .lando.yml 的配置，但适用于 DDEV 环境。
• drupal/ 目录中的配置文件: 包含 Drupal 站点的配置，如 settings.php 和 services.yml，以及可能的自定义模块和主题的配置文件。
• next/ 目录中的配置文件: Next.js 项目的配置文件，例如 next.config.js，用于定义构建和开发的参数。

确保在开始项目之前正确配置这些文件，以适应项目的特定需求和本地开发环境。