README

本模块为 OpenEuropa 项目提供编辑功能。

支持 Drupal 10。

仅在 2.x 版本中添加对 Drupal 10 的支持。

从 1.x 升级到 2.x

在 2.x 中，已删除对 Poetry 的支持。要从 1.x 升级到 2.x

卸载 oe_editorial_corporate_workflow_translation_poetry;
升级到 2.x 版本。

开发环境设置

您可以使用提供的配置使用 Docker 和 Docker Compose 建立开发网站。

Docker 提供了必要的服务和技术，如 Web 服务器和数据库服务器，以使网站运行，无论您的本地主机配置如何。

要求

配置

默认情况下，Docker Compose 读取两个文件，一个是 docker-compose.yml 文件，另一个是可选的 docker-compose.override.yml 文件。根据惯例，docker-compose.yml 包含您的基配置，并默认提供。覆盖文件，如其名称所示，可以包含对现有服务或完全新服务的配置覆盖。如果服务在两个文件中都定义了，Docker Compose 将合并配置。

有关 Docker Compose 扩展机制的更多信息，请参阅官方 Docker Compose 文档。

用法

要启动，请运行

docker-compose up

建议不要将 docker-compose 作为守护进程运行，这样您可以在完成工作后快速将其关闭（CTRL+C）。但是，如果您想将其作为守护进程运行，您必须添加标志 -d

docker-compose up -d

然后

docker-compose exec web composer install
docker-compose exec web ./vendor/bin/run drupal:site-install

使用默认配置，开发网站文件应位于 build 目录中，开发网站应在： http://127.0.0.1:8080/build。

运行测试

要运行 grumphp 检查

docker-compose exec web ./vendor/bin/grumphp run

要运行 phpunit 测试

docker-compose exec web ./vendor/bin/phpunit

要运行 behat 测试

docker-compose exec web ./vendor/bin/behat

逐步调试

要启用从命令行进行的逐步调试，请向容器传递带有任何值的 XDEBUG_SESSION 环境变量

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

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

要从浏览器启动逐步调试，请使用浏览器扩展或像在 https://www.jetbrains.com/phpstorm/marklets/ 生成的书签一样设置正确的cookie。

贡献

请阅读完整文档了解我们的行为准则以及向我们提交拉取请求的过程。

版本控制

我们使用 SemVer 进行版本控制。有关可用版本，请参阅此存储库上的标签。

openeuropa / oe_editorial

维护者

详细信息