README

Saplings - Drupal构建起始配方

此配方旨在帮助启动一个高度配置的Drupal项目。

而不是一个试图做所有事情的庞大配方，我们将它分解为多个子配方。此配方安装了所有这些子配方，但您也可以单独安装这些子配方（一旦Drupal问题得到解决）。

• kanopi/gin-admin-experience
• kanopi/saplings-base
• kanopi/saplings-editorial
• kanopi/saplings-launch
• kanopi/saplings-tests [Cypress]
• kanopi/saplings-content-types
  • kanopi/saplings-content-base
  • kanopi/saplings-component-types
    • kanopi/saplings-component-base
      • kanopi/saplings_paragraphs [模块]
  • kanopi/saplings-media
    • kanopi/imagemagick-configuration
  • kanopi/saplings-theme
    • kanopi/saplings_child [主题]
  • kanopi/saplings_custom [模块]

要求和使用此配方

将配方应用于使用最小配置文件安装的Drupal。如果您想设置一个快速测试环境，请参阅以下内容。

• 按照kanopi/drupal-starter中的说明进行操作，以按照配置启动新项目，因为它为配方和所需的工具进行了配置。
• 运行fin composer require kanopi/saplings:^1以要求此存储库。
• 运行fin recipe-apply saplings以应用此配方。
• 运行以下命令，将所有kanopi/saplings配方中的依赖项解包到站点项目的composer.json文件中。

fin recipe-unpack kanopi/saplings && fin recipe-unpack kanopi/gin-admin-experience && fin recipe-unpack kanopi/saplings-base && fin recipe-unpack kanopi/saplings-editorial && fin recipe-unpack kanopi/saplings-launch && fin recipe-unpack kanopi/saplings-content-types && fin recipe-unpack kanopi/saplings-component-types && fin recipe-unpack kanopi/saplings-component-base && fin recipe-unpack kanopi/saplings-content-base && fin recipe-unpack kanopi/saplings-media && fin recipe-unpack kanopi/imagemagick-configuration && fin recipe-unpack kanopi/saplings-theme && fin recipe-unpack kanopi/saplings-editorial

• 导出配置。

然后，一旦应用并解包了配方，您就可以删除它，因为配置现在在您的Drupal中，而依赖项在您的composer中。

• fin composer remove kanopi/saplings
• 导出配置。

路线图

阶段1

功能完整。

阶段2

• 将页面和帖子内容类型分解为其自己的配方。
• 根据需要添加其他组件。
• kanopi/saplings-ai - [WIP] 为内容创作者提供有用的AI功能。
• kanopi/saplings-person - [WIP] 创建Person内容类型和相关配置。
• kanopi/saplings-events - [WIP] Saplings活动的配置
• kanopi/saplings-demo-events - [WIP] Saplings活动的演示内容
• kanopi/solr-search-pantheon-recipe - 目标是为不会使用saplings的站点配置Solr。

阶段3

研究扩展Drupal CMS的配方。

其他Kanopi配方

• kanopi/saplings-domain - 安装和配置域名模块。
• kanopi/saplings-demo-content - Saplings的演示内容。
• kanopi/saplings-solr - 在Pantheon上为Saplings配置后端和前端Solr搜索。
• kanopi/password-policy-90-days - 安装并配置密码策略，默认设置为90天过期。
• kanopi/remote-video-youtube-lite - 配置远程视频媒体实体使用轻量级YouTube嵌入。

其他与Saplings相关的模块

• kanopi/saplings_navbar - 为Saplings创建一个导航栏模式，允许父级成为链接，然后通过下拉指示器访问子菜单项。

贡献/测试

我们很乐意在测试、构思和开发方面得到您的帮助。

设置快速测试环境

为您的测试环境选择一个名称。在这个例子中，我将使用kanland。

• 将kanopi/drupal-starter检出为其自己的仓库。
• git clone git@github.com:kanopi/drupal-starter.git kanland && cd kanland
• 在您的编辑器中打开/.docksal/docksal.env。
• 更新第28行hostingsite="kanland"并保存。
• 运行fin init
• 构建将失败，出现以下错误消息，因为我们还没有安装Drupal：Error: Class "Drupal\user\Entity\User" not found
• 运行fin drush si minimal -y && fin drush uli来安装Drupal并登录。
• 单击一次性登录以验证最小安装已成功。
• 要求此存储库：fin composer require kanopi/saplings:^1
• 应用配方：fin recipe-apply saplings

在您完成一些测试后重置

• 运行fin init
• 构建将失败，出现以下错误消息，因为我们还没有安装Drupal：Error: Class "Drupal\user\Entity\User" not found
• 运行fin drush si minimal -y && fin drush uli来安装Drupal并登录。

要求配方

使用composer要求所需的配方。我们目前托管在我们的packagist上。

在Drupal中应用和展开配方

要应用contrib/composer安装的配方，运行以下命令

fin recipe-apply recipe-name

每个配方都可以有composer依赖项。"展开"将这些依赖项从配方中提取出来并应用到项目的composer.json文件。

要展开contrib/composer安装的配方，运行以下命令

fin recipe-unpack recipe-name

注意：Drupal核心补丁是实验性的，但它主要是新增功能。如果您不想在生产网站上使用补丁，好消息是您在应用并展开配方后不需要补丁。您可以简单地删除补丁并更新核心，因为配方现在是您自己的。

依赖关系图

使用JBZoo/Composer-Graph创建。