diff --git a/Documentation/Environment.rst b/Documentation/Environment.rst index 0f12a0f..f85b60e 100644 --- a/Documentation/Environment.rst +++ b/Documentation/Environment.rst @@ -8,3 +8,63 @@ Development environment You can run the code quality checks and automated tests locally (using a local PHP, Composer, and database) or using runTests.sh. + +To kickstart the project we suggest the usage of the `TYPO3-testing-distribution `__ by Oliver Klee +as development environment. The distribution comes with a frontend, example data and predefined +plugins. + +.. index:: Clone TYPO3 Testing Distribution +.. code-block:: bash + + git clone git@github.com:oliverklee/TYPO3-testing-distribution.git + +Also clone the tea extension. + +.. index:: Clone Tea Extension +.. code-block:: bash + + git clone git@github.com:FriendsOfTYPO3/tea.git + +You can organize the folder structure as you wish, but lets say your folder structure looks like this: + +.. index:: Folder structure +.. code-block:: bash + + git\ + TYPO3-testing-distribution + tea + + +Inside the testing distribution there is a file **docker-compose.extensions.yaml.template** +which mounts the used extensions. This file need to be renamed and adjusted. + +.. index:: Create docker-compose.extensions.yaml +.. code-block:: bash + + cp .ddev/docker-compose.extensions.yaml.template .ddev/docker-compose.extensions.yaml + +The file needs to mount the tea extension into the testing distribution. Keep in mind +that you use the correct paths here. + + +.. index:: Mount extension into testing distribution +.. code-block:: yaml + + services: + web: + volumes: + - "$HOME/git/tea:/var/www/html/src/extensions/tea:cached,ro" + +After that you can start the testing distribution using ddev. + +.. index:: Start the testing distribution +.. code-block:: bash + + ddev start + ddev composer install + ddev install-typo3 + ddev db-import + +After that you should be able to access the frontend: + +https://typo3-testing-12-4.ddev.site:8081/tea/