This repository contains the source code which builds the VanBUG website. The contents of the site are written in Markdown and are processed into a static site using python and mkdocs. All changes must be done through a pull-request to the main branch so that they can be approved by the other members. Once merged into the main branch the site will automatically build and re-deploy using github actions.
As a developer working on the website you will need to have python3.10 installed. This repository uses poetry to manage package dependencies. If you can, then install poetry globally, otherwise you can use a virtual environment which poetry will re-use during install.
poetry installTo render the docs and re-render on changes you can start the development server as follows
poetry run mkdocs serveYour build docs should now be available on localhost:8000
If you need to simply make a small change to one of the markdown files that can be done directly in GitHub by navigating to the page
