This repo contains a set of interaction experiments the QUT Ecoacoustics lab runs to test new ideas.
Each experiment is designed for it's own purpose and must have an associated ethics document before they "go-live".
Importantly, however, experiments that are in devleopment, or no longer needed are still contained here, and may even still work in production but will be prevented from storing any of the collected data.
- Clone this repo
- Open a shell (PowerShell on Windows, Bash on Mac or Linux)
cd
to this directory- Install Hugo https://gohugo.io/getting-started/installing/
- In your shell, run the
hugo server
command - Edit files in this folder, and see the changes live at http://localhost:1313/
- Use Ctrl+c to stop the Hugo server
- Commit and and Push your changes
- Wait about 30 seconds and they will be live in production
- Ensure a recent version of Node is installed, preferably the same version as is in
netlify.toml
- Install netlify-cli:
npm install -g netlify-cli
- Link netlify-cli to Netlify:
netlify link
- Ensure the expected environment variables are set in the Netlify site settings not in the
netlify.toml
config file- these settings are managed by the repository admin
- Run
netlify dev
to simulate a netlify deploy - Submit data from an experiment and change code as needed
Please use Visual Studio Code to make changes to these files. Open this folder as a workspace and it will automatically suggest extensions to install.
Most importantly: do not mass format a file because you do not like how it is formatted. This can produce confusing diffs and unnecessarily large commits.
See .editorConfig
and .eslintrc.yml
for established style rules.
You don't need eslint installed. The files in the solution are already formatted well, so just try to maintain the style you see.
However, if you want to use the eslint extension, then:
- Ensure you have a revent version of node installed
- Install eslint with
npm install -g eslint
- If your workspace is open, you will need to re-open it