agaric/documentation
10
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update project placement instructions and more importantly add the git add

Browse source
This commit is contained in:
benjamin melançon 2023-12-01 22:51:36 -05:00
parent d4c782d879
commit bbde3e90a9
1 changed files with 4 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
tools/creating-new-drutopia-site.md
View file

@ -29,19 +29,11 @@ Commands for copying throughout will assume this above setup.
## Create a new site project
Ordinarily this will live under https://git.agaric.com/example-client (for Agaric clients) or https://git.agaric.com/drutopia-platform (for direct Drutopia platform members).
For Agaric clients, the online home for the project will usually be at [Agaric's Forgejo project hosting site](https://git.agaric.com), first creating an organization (such as `example-client`, the short name that Forgejo takes first must be treated as a machine name) and then the project (such as `example-org`) that would live a URL such as `https://git.agaric.com/example-client/example-org`.
Copy the `composer.json`, `composer.lock`, and `.gitignore` files used by the appropriate build source, such as the [default build source for the Drutopia Platform](https://gitlab.com/drutopia-platform/build_source).
Copy the part of the URL after `git.agaric.com` so the namespace will be consistent on your local machine and create the directory at `~/Projects`. With the examples above it would be `mkdir -p ~/Projects/example-client/example-org` and `cd ~/Projects/example-client/example-org`.
Replace "example" below with name of the site, usually derived from the main domain name, for instance `example-com`:
```
MY_SITE="example"
mkdir -p ~/Projects/agaric/sites/$MY_SITE
cd ~/Projects/agaric/sites/$MY_SITE
```
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:
Once you have created and are in this directory, wherever you want your project to live within that namespace, you can copy-paste these commands for a quick start:
```
wget https://gitlab.com/drutopia-platform/build_source/-/raw/main/composer.json
@ -57,6 +49,7 @@ ddev start
ddev auth ssh
ddev composer install
git init
git add .
git commit -m "Begin repository based on build_source main"
```