PyBeach 2020

This is the source repo for 2020.pybeach.org.

The site is built using Lektor and Sass, and below instructions will rely on Poetry as well.

Setup

# initialize virtual environment and install dependencies
poetry install

Developing

# run the Lektor server and SASS watcher concurrently
make serve
# go to http://localhost:5000

Files

Below is an overview of files likely to be of use when updating the site. Not all files are mentioned here.

Templates

• templates/layout.html: main site layout
• templates/page.html: default page layout

Stylesheets

• assets/static/style/_main.scss: main styles
• assets/static/style/_variables.scss: SCSS variables, for convenience
• assets/static/style/style.css: output CSS generated by lektor-scsscompile (do not edit this file directly!)

Content

• content/contents.lr: main page
• content/conduct/contents.lr: CoC page

Add and modify content as you wish. Documentation on how Lektor organizes content can be found here: https://www.getlektor.com/docs/content/.

Infrastructure

The site is deployed in @nkantar's `Render <https://render.com`_ account from the main branch of this repository, fully regenerated on every build. The domain is registered by @nkantar through Porkbun, DNS is managed by DNSimple, and SSL is provided by Let's Encrypt.

Code of Conduct

PyBeach employs a Code of Conduct which was forked from the North Bay Python Code of Conduct under an MIT License , which was formed from the PyCon US Code of Conduct under a Creative Commons Attribution 3.0 Unported license, itself originally forked from the example policy in Geek Feminism wiki , created by the Ada Initiative and other volunteers, which is under a Creative Commons Zero license. Everyone contributing to this repository is bound by it. The full text can be found in the CODE_OF_CONDUCT.md file.