Hello!
We've added language support to the site, but are still working out the best workflow for people to submit translations. (There's a small amount of manual work required on the code side!)
If you'd like to submit a translation, you can find us on Transifex. I think you can suggest translations directly on their site without needing an invite to the organisation, but I'm not sure exactly. Let us know! Let's figure it out.
Either way, open an issue on our GitHub repo, and we'll work out the best way to proceed :)
This project is a Eleventy site. If you've used a static site generator before, you're pretty much good to go. If not, take a look through the Eleventy documentation to get up to speed.
It's a JavaScript site, so you'll need node
installed. Using nvm will make sure you're using the right version.
# git clone, etc
yarn # install dependencies
yarn serve # run development server
Then open localhost:8123 in your browser, and you should be ready to disco.
Unit tests are via Mocha. Nothing too fancy there.
We use UI tests via Playwright. To ensure consistency, the snapshots are taken with a Linux container. To run this locally for convenience, you'll need two things installed: Docker and act.
Available commands:
yarn check-snapshots # do your snapshots match?
yarn update-snapshots # if not, update your snapshots!
- we use Transifex
- we use Transifex CLI (currently no
brew
package!) - the base language is English
Changed base strings? yarn strings:push
. Updated translations? yarn strings:pull
.