diff --git a/docs/composer/project/d10/index.md b/docs/composer/project/d10/index.md index 16935ab023a738949e93759fba6e7c60c35686f8..57d71282de0cf348c1021cfc34dffd4d88b4eddd 100644 --- a/docs/composer/project/d10/index.md +++ b/docs/composer/project/d10/index.md @@ -5,26 +5,60 @@ issues: https://gitlab.lakedrops.com/composer/project/drupal-10/-/issues tags: - composer --- -# Usage +# Create new project for local development -## Preparation +There are two ways to use this Drupal 10 project template. + +## By Composer - [Install composer](https://getcomposer.org): `sudo wget https://getcomposer.org/composer.phar --output-document=/usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer` - Disable XDebug for CLI - optional: `sudo phpdismod -s cli xdebug` - [Install Prestissimo](https://github.com/hirak/prestissimo) - optional: `sudo composer global require "hirak/prestissimo:^0.3"` -## Create new project for local development - ```bash -composer create-project lakedrops/d9-project [DIRNAME] --no-interaction +composer create-project lakedrops/d10-project [DIRNAME] --no-interaction --no-dev +composer update cd [DIRNAME] ``` +## By L3D + +We **strongly recommend** to it this way. Just install [L3D](../../../docker/l3d/index.md) and things are going much easier. + +- Create an empty directory, where you want to locate your project, like `mkdir drupal10` +- go into this directory and execute: + +```bash +l3d +Name your project (used as subdomain): [drupal10] +``` + +Enter a name or press `Enter` to use the name of the directory. + +```bash +Lets start a new project here ... + +Options to start: + 0 none: start with an empty container + 1 LakeDrops Drupal 11 project template + 2 LakeDrops Drupal 10 project template + 3 drupal.org recommended project template (Drupal 11) + 4 drupal.org recommended project template (Drupal 10) + 5 Drupal's community project template (Drupal 11) + 6 Drupal's community project template (Drupal 10) + 7 Custom project template + 8 Existing git repository + + +Choose an option: +``` +Just select the `LakeDrops Drupal 10 Project Template` and you are ready to go. `L3D` cares about the initial setup. + This will build the full structure and create a git repository which you can then use during the full live-cycle of that project. To install a new site with the included default configuration, use `drush site-install --existing-config` and you get a jump-start from that. -## Deploy project to upstream stages +# Deploy project to upstream stages For deployment, both initially and for later updates, follow this: @@ -35,25 +69,9 @@ git clone YOUR-GIT-REPOSITORY . composer install ``` -## Adding new and updating existing components - -Edit the composer.json file accodring to your requirements and then run `composer update`. - -## Adding JS packages - -### CKEditor Codesnippet - -```bash -composer config repositories.codesnippet '{"type": "package","package": {"name": "ckeditorplugin/codesnippet","type": "drupal-library","version": "master","dist": {"type": "zip","url": "https://download.ckeditor.com/codesnippet/releases/codesnippet_4.7.3.zip","reference": "master"}}}' -composer require ckeditorplugin/codesnippet:master drupal/codesnippet -``` - -### Chosen +# Adding new and updating existing components -```bash -composer config repositories.codesnippet '{"type": "package","package": {"name": "harvesthq/chosen","version": "1.8.2","type": "drupal-library","dist": {"url": "https://github.com/harvesthq/chosen/releases/download/v1.8.2/chosen_v1.8.2.zip","type": "zip"}}}' -composer require harvesthq/chosen -``` +Edit the composer.json file according to your requirements and then run `composer update`. # Links