mirror of https://github.com/FriendsOfTYPO3/tea.git synced 2024-12-22 23:06:11 +01:00

[TASK] Add more development documentation (#1399)

Resolves:  #1393
This commit is contained in:
Eike Starkmann 2024-07-30 19:41:28 +02:00 committed by GitHub
parent c68c72096c
commit 8e592adba7
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -8,3 +8,66 @@ 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 <https://github.com/oliverklee/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
: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:
.. code-block:: bash
ddev launch