derekcresswell/drupalbaseproject

Drupal 9站点的基座。

v1.0.1 2020-08-07 00:51 UTC

This package is auto-updated.

Last update: 2024-09-25 12:18:20 UTC


README

这是一个用于快速创建Drupal站点的代码库。

功能

此模板提供了以下基础文件:

  • Composer文件

    • 仅包含基本内容,以避免冗余。
      • Drupal 9.x
      • Drush 10
      • 管理工具栏
  • Lando文件

    • 用于创建开发容器和站点。
    • 默认情况下,此模板会安装
      • Apache应用服务器
      • MySQL数据库
      • 节点服务
      • Mailhog服务器
    • 此外,还提供了
      • Drush
      • Phpunit
      • npm
  • 任务文件

    • 这是一个常用任务列表,可用于创建、更新、启动和停止开发站点。
  • Gulpfile(在web/themes中)

    • 这允许我们的主题使用SCSS而不是纯CSS。
  • 开发设置(在web/sites中)

    • 数据库连接和其他开发设置。
    • 如果您使用自动设置,该文件用作本地设置,因此您需要确保正常设置文件包含本地设置。

有关所使用技术的信息,请参阅技术部分。

使用方法

您可以通过三种方式复制此模板。

  1. 时尚方式

    • 在GitHub上,点击“使用此模板”按钮。
  2. 老式方式

    • 克隆仓库并运行rm -r path/to/repo/.git
  3. Composer

    • 使用Composer,您可以使用以下命令创建项目:composer create-project derekcresswell/drupalbaseproject

在克隆完仓库后,请按照以下说明设置您的站点:

  1. 将“SITE-NAME”、“PROJECT-NAME”和“THEME-NAME”替换为相应的名称。

    • 还需要更改Lando文件顶部的name
  2. 导航到项目根目录,并运行inv setup。这将启动您的站点并设置设置等。

    • 在此文件中,这是一个更新网站上数据库的骨架命令。这需要手动填充。
  3. 导航到web/sites/default/settings.php,并在底部取消注释最后三行

if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
  include $app_root . '/' . $site_path . '/settings.local.php';
}
  1. 然后您可以去composer.json,并删除最上面的几行(在repositories键上方的行)。
    • 这些行包含Packagist的信息,并且不需要在站点中使用。

然后使用Lando提供的链接导航到站点,site-name.lndo.site,并按照Drupal的安装说明完成设置。

这应该会给您一个可工作的Drupal站点来工作。

主题设置

有关设置自定义主题的信息,请参阅自定义主题基座

技术

有两种主要技术用于简化开发过程。安装说明可以在它们各自的网站上找到。

  • Lando

    Landō极大地简化了本地开发和DevOps,让您能够专注于最重要的事情;为客户提供价值。

  • Invoke

    Invoke是一个Python(2.7和3.4+)任务执行工具和库,从各种来源汲取灵感,形成强大且简洁的功能集。

这是完全利用此存储库所需的唯一两个依赖项。尽管Lando中包含其他技术,但它们在Lando中被广泛使用。