To build this website, you will need the following:
- Python 3.7 installed and activated.
- Node.js and Yarn installed.
- Poetry installed; see the installation documentation.
Then:
- Run
poetry install. Poetry will create a virtualenv for you. - Run
yarn install. - Run
poetry run supervisord. Supervisor will start up the two processes you'll need for local development:parcel(to build frontend static assets) andstatik(to build the site itself).
From there, the Statik documentation will be the place to look for most things.
Deployment is automated, and runs on Netlify; see the netlify.toml for details. When you file a pull request against this repo, Netlify will build the site (provided the original branch is also inside this repo; sorry, folks outside the core team). A "check" will come up with the name deploy/netlify; click Details next to it to go to the preview for that PR.
It turns out that, regrettably, the world does not run entirely on the Australia/Adelaide timezone. To accommodate those who insist on using whole-hour UTC offsets, all times should be written like this:
<time datetime="2020-07-16T08:30+09:30">Thursday 16 July, 8:30am ACST</time>
The site has some JavaScript that will pick this up, and if the user's timezone differs from the one in the timestamp, append the local time. (For instance, they might see Thursday 16 July, 8:30am ACST (9:00am AEST) or Thursday 16 July, 8:30am ACST (Wed, 7:00pm ET).)
This works in HTML and Markdown (since Markdown can have arbitrary HTML in most places).
Note that the colon between the offset hours and minutes must be present (e.g. +0930 won't work)!
Are you on macOS Catalina and getting hundreds of API_UNAVAILABLE/clang issues when running poetry install?
Try this tip:
-
Check how many SDKs you have installed in
/Library/Developer/CommandLineTools/SDKs. -
If you have both
MacOSX10.14.sdkandMacOSX10.15.sdk:rm -rf /Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk -
Then try
poetry installagain.