PyConline AU 2020 website
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.
Local development issues
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.