voicegardens/README.md

# voicegardens

## @ Interwebz

* [barbican.org.uk: This is Public Space](https://www.barbican.org.uk/whats-on/2019/event/this-is-public-space)
* [upprojects.com: This is Public Space](https://www.upprojects.com/projects/this-is-public-space/)

## Meanwhile, in the padiverse

* [kari.this.is.public.space](https://pad.vvvvvvaria.org/kari.this.is.public.space) (private)
* [vocoder](https://pad.vvvvvvaria.org/vocoder) (public)

## Doodle Doodle Doo

* [wet-signal-voice-garden.pdf](./media/wet-signal-voice-garden.pdf)
* [staringcaring.com](http://staringcaring.com/)

## Hackity Hack Hack

Please note, these commands were run on a Debian Stretch system.

### Install packed lunch

```bash
$ sudo apt install -y make git
```

### Get your discount source code

```bash
$ git clone ssh://gitea@vvvvvvaria.org:12345/varia/voicegardens.git
$ cd voicegardens
```

### Do the Python dance

```bash
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt
```

### Run the server

```bash
$ make dev-serve
```

### Deploy the site

You can add the following to your SSH configuration:

```
Host voicegardens.org
  Hostname voicegardens.org
  User voicegardens
  Port 12345
  IdentityFile ~/.ssh/my-ssh-secret-key-file
```

(Where you should replace "my-ssh-secret-key-file" with the real filename.)

Make sure you can SSH into the server.

```bash
$ ssh voicegardens.org
$ sudo -i  # you have root access too
```

Then it's possible to deploy the site with the following targets.

```bash
$ make test-deploy  # https://doesitsparkjoy.voicegardens.org
$ make prod-deploy  # https://voicegardens.org
```

### Layers of the Onion

* [Flask](http://flask.palletsprojects.com/en/1.1.x/)
* [Leaflet](https://leafletjs.com)
* [Mappa.js](https://mappa.js.org)
* [p5.js](https://p5js.org)

## License

TBD.