README

注意：仅限本地环境测试

该组件正在积极开发中。它尚未准备好使用。

这是一个包含欧洲委员会企业实体类型的Drupal模块。

该模块使用RDF SKOS模块为出版物局分类词汇表提供SKOS建模。这些直接在依赖的RDF三元组存储中提供。

目录

• 需求
• 安装
• 使用
• 开发环境搭建
• 贡献
• 版本控制

需求

此软件依赖于以下软件

• PHP 7.1
• Virtuoso（或等效）三元组存储，其中包含以下出版物局（OP）词汇表的RDF表示：企业实体、目标受众、组织类型、资源类型、Eurovoc

安装

安装软件包及其依赖项

composer require openeuropa/oe_content

强烈建议使用包含已预装OP词汇表的Virtuoso提供的Docker镜像。为此，将镜像添加到您的docker.compose.yml文件中

  sparql:
    image: openeuropa/triple-store-dev
    environment:
    - SPARQL_UPDATE=true
    - DBA_PASSWORD=dba
    ports:
      - "8890:8890"

否则，请确保您已启动三元组存储实例，并已导入这些词汇表。

接下来，如果您正在使用任务运行器设置您的网站，请添加用于连接到三元组存储的runner.yml配置。在drupal键下

  sparql:
    host: "sparql"
    port: "8890"

在runner.yml中，添加创建连接到三元组存储的Drupal设置的指令。在drupal.settings.databases键下

  sparql_default:
    default:
      prefix: ""
      host: ${drupal.sparql.host}
      port: ${drupal.sparql.port}
      namespace: 'Drupal\Driver\Database\sparql'
      driver: 'sparql'

然后您可以使用常规的任务运行器命令来设置网站。

否则，请确保在您的网站setting.php文件中您有连接到您自己的三元组存储实例的信息

$databases["sparql_default"] = array(
  'default' => array(
    'prefix' => '', 
    'host' => 'your-triple-store-host',
    'port' => '8890',
    'namespace' => 'Drupal\\Driver\\Database\\sparql',
    'driver' => 'sparql'
  )
);

使用

OpenEuropa 内容

如果您想使用OpenEuropa内容，请启用该模块

drush en oe_content

开发环境搭建

需求

• Virtuoso 7（三元组存储数据库）

初始设置

您可以通过以下步骤构建测试站点。

• 安装Virtuoso。最简单的方法是使用OpenEuropa 三元组存储开发Docker容器，该容器还预装了主要欧洲词汇表。

• 安装所有composer依赖项

composer install

• 通过复制runner.yml.dist到runner.yml并更改相关值（如您的数据库凭证）来自定义构建设置。

这将还将主题符号链接到测试站点的适当目录，并在测试配置文件（如behat.yml.dist）中进行令牌替换。

• 通过运行以下命令安装测试站点

./vendor/bin/run drupal:site-install

您的测试站点将在./build中可用。

使用Docker Compose

或者，您可以使用提供的配置使用Docker和Docker Compose构建开发站点。

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

需求

• Docker
• Docker Compose

配置

默认情况下，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

与内容一起工作

该项目提供了以下 Task Runner 命令来处理 RDF 存储中的内容，它们要求 Docker Compose 服务处于运行状态。

清除所有数据

docker-compose exec sparql ./vendor/bin/robo purge

或者，如果您可以在主机上运行命令

./vendor/bin/run sparql:purge

导入默认数据

docker-compose exec sparql ./vendor/bin/robo import

或者，如果您可以在主机上运行命令

./vendor/bin/run sparql:import

重置所有数据，即运行清除和导入

docker-compose exec sparql ./vendor/bin/robo purge
docker-compose exec sparql ./vendor/bin/robo import

或者，如果您可以在主机上运行命令

./vendor/bin/run sparql:reset

贡献

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

版本控制

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