From d19f2efb1a2bf7b2d0ba3097abdaaf2c7e094274 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?benjamin=20melan=C3=A7on?= Date: Tue, 23 Jun 2020 10:48:43 -0400 Subject: [PATCH] start to give quickstart commands --- creating-new-drutopia-site.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/creating-new-drutopia-site.md b/creating-new-drutopia-site.md index c3eda1c..267fad6 100644 --- a/creating-new-drutopia-site.md +++ b/creating-new-drutopia-site.md @@ -30,4 +30,21 @@ Commands for copying throughout will assume this above setup. Ordinarily this will live under https://gitlab.com/agaric/sites (for Agaric clients) or https://gitlab.com/drutopia-platform/sites (for direct Drutopia platform members). -Copy the https://gitlab.com/drutopia-platform/build_source +Copy the composer.json used by the appropriate build source, such as the [default build source for the Drutopia Platform](https://gitlab.com/drutopia-platform/build_source). + +Replace EXAMPLE below with name of the site, usually derived from the main domain name, for instance `example-com`: + +``` +mkdir -p ~/Projects/agaric/sites/EXAMPLE +cd ~/Projects/agaric/sites/EXAMPLE +``` + +Once you have created and are in this directory, whether `agaric/sites` or `drutopia-platform/sites` or wherever you want your project to live within the GitLab namespace, you can copy-paste these commands for a quick start: + +``` +wget https://gitlab.com/drutopia-platform/build_source/-/raw/master/composer.json +ddev config --docroot=web --project-type=drupal8 --webserver-type=apache-fpm --mariadb-version=10.1 --php-version=7.3 --xdebug-enabled=true --use-dns-when-possible=false +``` + +```note +Webserver, PHP, and MySQL versions and types are selected here to match those used on Elizabeth and should be adjusted to match your live environment, including double-checking that they are still valid for `elizabeth.mayfirst.org`. Please update this documentation if it changes! The last two options (enabling Xdebug by default and not using DNS for your local site) are optional at the developer's preference.