openeuropa/oe_profile

Name: oe_profile

Owner: OpenEuropa

Description: OpenEuropa minimal profile.

Created: 2017-03-17 12:32:03.0

Updated: 2018-05-14 14:47:57.0

Pushed: 2018-05-14 14:47:59.0

Homepage: https://github.com/openeuropa/openeuropa

Size: 38

Language: Gherkin

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Installation profile

Basic installation profile, all it does is:

  1. Enable the bare minimum amount of core modules.
  2. Setup seven as administrative theme and oe_theme as front-end theme.
Rationale

Opting for a minimalistic installation profile will make it easier to deal with a fully distributed approach: the installation profile is seen as an empty shell that will never pose any compatibility issue to any of the site's modules and themes. Most importantly this will allow modules and themes maintainers to properly version their work semantically.

This profile will also be used to build a basic site using the multiple comonents of OpenEuropa, including oe_multilingual, oe_paragraphs and oe_webtools.

Installation

The recommended way of installing the OpenEuropa profile is via a Composer-based workflow.

In the root of the project, run

mposer install

Build the theme In order to build the oe_theme in your project perform the following steps:

uild/themes/custom/oe_theme
install && npm run build
./../../../

Before setting up and installing the site make sure to customize default configuration values by copying runner.yml.dist to ./runner.yml and override relevant properties. To set up the project run:

vendor/bin/run drupal:site-setup

This will:

Symlink the theme in ./build/themes/custom/oe_theme so that it's available to the target site

Setup Drush and Drupal's settings using values from ./runner.yml.dist

Setup PHPUnit and Behat configuration files using values from ./runner.yml.dist

After a successful setup install the site by running:

vendor/bin/run drupal:site-install

This will:

Install the target site

Set the OpenEuropa Theme as the default theme

Enable OpenEuropa Theme Demo and Configuration development modules

Using Docker Compose

The setup procedure described above can be sensitively simplified by using Docker Compose.

Requirements:

Run:

cker-compose up -d

Then:

cker-compose exec -u web web composer install
cker-compose exec -u node node npm install
cker-compose exec -u node node npm run build
cker-compose exec -u web web ./vendor/bin/run drupal:site-setup
cker-compose exec -u web web ./vendor/bin/run drupal:site-install

Your test site will be available at http://localhost:8080/build.

Run tests as follows:

cker-compose exec -u web web ./vendor/bin/phpunit
cker-compose exec -u web web ./vendor/bin/behat

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.