lastcall/drupal-scaffold

适用于企业级Drupal构建的脚手架

2.1.0 2020-05-04 13:50 UTC

README

Build Status Latest Stable Version

LCM Drupal 8 脚手架由 Last Call Media 的朋友提供,它是一个捆绑了一些标准工具的 Drupal 8 构建模板,是一个企业级 Drupal 构建的不错起点。它与 drupal-composer/drupal-scaffold 概念上相似,但拥有更简单(且更手动)的 Composer 设置,并包含了一些额外的工具。有关此项目的更多信息,请参阅 2016 Badcamp 演示文稿

开始新项目

  • 使用 composer 从此存储库创建新项目,以此作为模板
    composer create-project lastcall/drupal-scaffold PROJECTNAME
  • 启动 Docker 容器并进入 Drupal 容器。
    docker-compose up -d drupal
    docker-compose exec drupal /bin/bash
  • 在 Drupal 容器内的存储库根目录(/var/www)中安装 NPM 和 composer 依赖项
    yarn install
    composer install
  • 在浏览器中访问 Drupal 网站以安装 Drupal 并继续。默认 URL 将是 https://:8080

有关下一步操作的说明,请参阅 scaffold 文档

到此为止!

以下内容适用于已设置好的脚手架项目。以下部分将是您项目 README 的起点。

为本地开发设置

此项目使用 Drupal Scaffold 构建。在开始之前,您必须在本地机器上安装 Docker 和 Docker Compose。有关安装说明,请参阅 Drupal Scaffold - Docker 文档

  1. 克隆此存储库。

  2. 如果您尚未创建和 设置您的 Pantheon machine token,请现在进行。

  3. 启动 Docker 环境并进入 shell

    docker-compose up -d drupal
    docker-compose exec drupal bash
  4. 安装 Composer 依赖项

    composer install
  5. 安装 NPM 依赖项

    yarn install
  6. 运行 composer site:import 以拉取并导入网站的数据库副本。如果 Pantheon 在此处给您错误,请确保您已正确遵循上述第 2 步,并且您正在新的终端窗口中运行 Docker

  7. 运行 drupal site:mode dev 以切换到开发配置。

  8. 运行 gulp build(或 gulp watch)和 drush cr(在 Drupal 根目录 /var/www/web 中)以编译主题。

  9. 在浏览器中查看您的新本地网站 https://:8080/

有关如何使用工具以及如何使用此项目的更多信息,请参阅 Drupal Scaffold 文档。有关 Docker 堆栈的更多信息,请访问 Docker 文档

测试

以下列出的两种测试工具都使用以下 JSON 文件来切换环境并获取这些测试工具的 URL。如有任何更改,请更改以下文件

可以通过添加以下命令到命令行来使用环境切换选项 --target=prod。如果没有指定目标,它将默认为本地。

夜行者

夜行者将在每次Pull Request时在CircleCI上运行,但如果你想在本地测试PR,请使用以下命令

$ docker-compose run drupal node_modules/.bin/nightcrawler crawl

Backstop

Backstop仅通过手动测试,请参阅文档来测试你的分支。