voicegardens/README.md

111 lines
2.3 KiB
Markdown

# voicegardens
> https://voicegardens.org
>
> http://doesitsparkjoy.voicegardens.org
## @ 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
```
### The curious case of GDAL
It's really hard to install GDAL. We need it to generate the tiles for the map.
Here is one way to do it but you might run into problems and need to research a
bit.
```bash
$ sudo apt install -y libgdal-dev
$ pip install pygdal=="`gdal-config --version`.*"
$ pip install gdal2tiles
```
And then it should be possible to run the tile generation.
```bash
$ gdal2tiles.py -l -p raster -z 0-5 -w none tiles2
```
You may need to use `python gdal2tiles.py` instead?
### 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 release the site with the following targets.
```bash
$ make doesitsparkjoy # https://doesitsparkjoy.voicegardens.org
$ make voicegardens # 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.