cintiadr / 2021-website

PyConline AU 2021 website

This website is generated using statik with automatic deployments by Netlify

For more information, see infrastructure.md

Submitting changes

Pull requests submitted to this repo automatically generate change previews using Netlify. Click the "deploy/netlify" check link to see your preview.

Local development

If your change is larger and you require a local development environment you will require a number of programs.

Links provided favour macOS using Homebrew, but will refer to general download information as well.

• Python 3.7 minimum
  • we recommend installing via pyenv (brew or download)
• Node.js (brew or download)
• Poetry (brew or downoad)

Once installed, fork this repo and clone, then to install this codebase's dependencies:

poetry install   # python dependencies, creates virtualenv for you
yarn install     # javascript dependencies

Finally, start the local webserver:

poetry run supervisord

Changes from previous years

2021 is running with a home timezone of "+10:00". It still uses some of the timezone hacks from 2020, but without the half hour offset.

However, all times should still be written as completely as possible.

<time datetime="2021-07-16T08:00+10:00">
	Friday 16 July, 8:00am AEST
</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 Friday 16 July, 8:00am AEST (10:00am NZST) or Friday 16 July, 8:00am ACST (Thurs, 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. +1000 won't work)!

Issues with local development

macOS issues with API_UNAVAILABLE

If you are running macOS Catalina and getting hundreds of API_UNAVAILABLE/clang issues when running poetry install, try this tip:

• Check how many SDKs you have installed:

  ls /Library/Developer/CommandLineTools/SDKs
  

• If you have both MacOSX10.14.sdk and MacOSX10.15.sdk, remove the older version:

  rm -rf /Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk
  

• Then try poetry install again.

macOS issues with invalid active developer path

If you've upgraded to Big Sur, you may need to re-install your developer tools.

Try this tip:

• (Re-)install your developer tools:

  xcode-select --install
  

• (Optional) if the above doesn't work, also try:

  xcode-select --reset
  

macOS issues with clang errors

It's probably C being fun.

Try this tip:

• (re-)install openssl:

brew install openssl

• set the flags

export LDFLAGS="-L/usr/local/opt/openssl/lib"
export CPPFLAGS="-I/usr/local/opt/openssl/include"

• run poetry install again