atendesigngroup/drupal-kickstart

此包的最新版本(11.x-dev)没有可用的许可证信息。

Aten Design Group Drupal网站的入门安装。

11.x-dev 2024-09-23 17:11 UTC

This package is auto-updated.

Last update: 2024-09-23 17:11:28 UTC


README

将此存储库与https://github.com/AtenDesignGroup/drupal-project合并。

Aten Drupal Kickstart 文档

Drupal网站的入门存储库。

入门指南

要开始一个新的Drupal项目,运行以下命令

composer create-project atendesigngroup/drupal-kickstart

开发工作流程

使用此入门项目构建的项目做出了一些假设。首先,项目代码库托管在Github上。这允许利用Github Actions将代码部署到各种远程托管环境。

对于所有活跃开发的项目,假设至少使用Pantheon托管来开始。这允许开发者利用Pantheon的免费沙箱和multidev环境。可以通过更新Github Actions部署脚本来配置额外的托管提供商。

feature/开头的前缀分支在针对main分支打开新的PR时将创建一个新的multidev环境。对该分支的连续推送将更新multidev环境。关闭PR将销毁multidev环境。

补丁

基于Composer的网站应使用composer-patches插件。这允许在每次运行composer install时应用补丁。为了保持整洁,所有补丁都应位于外部的composer.patches.json文件中,而不是主composer.json文件中。

最佳实践应该是将补丁贡献回其相关联的Drupal项目,并使用问题号进行引用。例如

"drupal/core": {
  "#12345: Short description...": "https://www.drupal.org/path/to/file.patch",
}

在需要本地补丁的罕见情况下,将.patch.diff文件保存在存储库的/patches文件夹中。

脚手架开发说明

要将包添加或更新到此基础安装,请在composer requirecomposer update命令中传递--no-update标志。这将确保不会创建package.json文件,并且不会安装依赖项。

有一系列脚本来测试安装程序的更新

  • composer test:ak-installer:运行测试安装。将文件放置在桌面上。
  • composer cleanup:ak-installer:删除安装目录。在新安装之前运行。