README

此项目已被停止开发。如果您需要启动新站点的开发，请检查：https://github.com/ec-europa/subsite/tree/release/9.x

针对Drupal 8项目的OpenEuropa模板

请注意：此存储库包含生成新Drupal 8项目所需的代码，请仔细阅读此README.md。不要克隆此存储库。

您需要在本地开发环境中安装以下软件

如何获取我的新OpenEuropa项目代码库？

首先，请仔细选择您新项目的名称，它应遵循以下约定

<dg-name>-<project-id>-reference

之后，联系QA团队，他们将为您在以下位置创建新的存储库

https://github.com/ec-europa/<dg-name>-<project-id>-reference

然后，通过运行以下命令生成您的新Drupal 8项目代码库

docker run --rm -ti -v $PWD:/var/www/html -w /var/www/html fpfis/httpd-php-dev:7.3 composer create-project openeuropa/drupal-site-template --stability=dev --remove-vcs <dg-name>-<project-id>-reference

这将把此入门套件下载到<dg-name>-<project-id>-reference文件夹中，并向您询问项目名称和您的组织。它将使用这些信息来个性化项目的配置文件。

安装程序将接着下载项目的所有依赖项。这个过程可能需要几分钟。最后，您将被告知是否要删除现有的版本历史记录。建议您确认此问题，以便您可以干净地开始您的项目。

完成上述命令后，您可以推送<dg-name>-<project-id>-reference文件夹的内容到QA团队为您创建的GitHub存储库。

我已经有了代码库，接下来我该做什么？

将新站点上线并运行的步骤可以在<dg-name>-<project-id>-reference/README.md中找到。
请查阅OpenEuropa 文档以获取可用组件、最佳实践等信息。
确保您精通配置管理以及在Drupal 8中的相关开发工作流程。

我应该克隆此GitHub项目吗？

不，此存储库将仅生成您新项目的代码库，然后您需要将生成的代码库推送到上述说明中提到的专用存储库。

步骤调试

要启用从命令行的步骤调试，请将XDEBUG_SESSION环境变量传递给容器并赋予任何值

docker-compose exec -e XDEBUG_SESSION=1 web <your command>

请注意，从XDebug 3开始，如果变量已设置但您的客户端未监听调试连接，则控制台将输出连接错误消息。错误消息将导致PHPUnit测试产生假阴性。

要从浏览器中开始步骤调试，请使用浏览器扩展或书签工具，如从https://www.jetbrains.com/phpstorm/marklets/生成的工具设置正确的cookie。

openeuropa / drupal-site-template

维护者