Mediacurrent Theme Generator 8 使用指南

项目目录结构及介绍

Mediacurrent的Theme Generator 8是为了快速搭建Drupal 8或9主题而设计的Yeoman生成器。使用该项目时，你会得到一个结构化的初始主题环境，其中包含最佳实践和基本的配置。典型的项目结构大致如下：

my_drupal_theme/
├── .editorconfig                # 编辑器配置文件，保持代码风格一致
├── .eslintignore               # ESLint忽略文件列表
├── .eslintrc.json              # ESLint配置文件，用于JavaScript代码检查
├── .gitattributes              # Git属性文件，控制文件传输行为
├── .gitignore                  # 忽略文件列表
├── .nvmrc                      # 指定Node.js版本
├── travis.yml                   # Travis CI配置文件
├── CHANGELOG.md                 # 更新日志
├── LICENSE                      # 许可证文件，MIT许可
├── README.md                    # 项目说明文件，包含安装和使用指南
├── gulpfile.js                 # Gulp任务配置文件，用于自动化构建流程
├── package-lock.json            # 包锁定文件，确保安装相同版本的依赖
├── package.json                # 项目描述和依赖管理文件
└── (theme源代码目录)
    ├── ...

源代码目录通常包含以下结构，具体取决于生成的主题模板：

• src: 源代码存放处，包括Sass、JavaScript、模板文件等。
• docs: 可能包含文档或样式指南。
• libraries: 第三方库或组件。
• templates: Drupal主题模板文件。

项目的启动文件介绍

• package.json: 核心启动文件，定义了项目所需的所有npm脚本、依赖项和元数据。使用这个文件，你可以运行各种构建和管理任务，比如npm start或者特定的Gulp任务，它也用于执行Yeoman生成器。

• gulpfile.js: 控制自动化构建流程的文件。通过Gulp任务，你可以执行编译Sass、压缩图片、实时刷新等操作，是项目自动化的核心。

• npx yo mc-d8-theme: 主要启动命令，用于通过Yeoman生成器创建新的主题。这不是一个文件，而是执行生成器的命令，会引导你完成一系列设置并初始化项目。

项目的配置文件介绍

• .eslintrc.json: JavaScript的代码质量检查配置，定义了代码规范，帮助维护代码的一致性和质量。
• .editorconfig: 设置编辑器如何格式化代码的规则，确保团队成员间的代码风格统一。
• .nvmrc: 指定项目所需的Node.js版本，确保多环境下的一致性。
• package.json: 内含scripts部分定义了许多常用脚本命令，比如build, watch, 和 lint，是项目配置的重要部分。

通过上述结构和配置，Theme Generator 8让开发者能够快速启动一个新的Drupal主题项目，并按照最佳实践来进行开发。开发者应当根据项目需求调整这些配置和脚本，以满足特定的开发和部署要求。