General information

This repo contains the sources (markdown-content, themes, download files) (but not the built result) of the site https://pysemtec.org/.

How to build

Preparation

• Run pip install -r requirements.txt
• Note that the most files in the repo root dir were created by pelican quickstart. Some files were changed manually:
  • Makefile (specify $OUTPUTDIR)
  • pelicanconf.py (everything after # *******)

Local testing:

• pelican -lr # starts a local webserver and makes pelican regenerate built files after changes in content or templates

Building for publication

• Commit your changes to the content and theme (but not yet the the content of doc).
• Run make publish
• Ensure that you are on the default branch of the repo (i.e. main).
• bash make_and_upload_content.sh (only available for admins)