introduce python venv to makefile scripts (#1206)

Makefile

@@ -5,10 +5,18 @@ help:
 	@grep -E '^[a-zA-Z_-]+:.*?# .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?# "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
 
 install-python-requirements:  # Install Python 3 required libraries
+	python -m pip install --user virtualenv; \
+	virtualenv venv; \
+	source venv/bin/activate; \
 	python -m pip install -r requirements.txt
 
-generate-site:  # Use custom-script to generate the website
+generate-site: install-python-requirements # Use custom-script to generate the website 
+	source venv/bin/activate; \
 	(cd scripts && bash Generate_Site_mkDocs.sh)
 
-serve:  # Start's a Python http.server on port 8000 serving the content of ./generated/site
+serve: # Start's a Python http.server on port 8000 serving the content of ./generated/site
+	# venv not required here as it's simply html
 	python -m http.server -d generated/site
+
+clean: # Clean up ephemeral build directories from the repo
+	rm -rf generated venv

requirements.txt

@@ -1,7 +1,30 @@
-requests
-feedgen
-wheel
-mkdocs
-mkdocs-material
-pymdown-extensions
-Pygments
+Babel==2.12.1
+certifi==2023.7.22
+charset-normalizer==3.2.0
+click==8.1.7
+colorama==0.4.6
+feedgen==0.9.0
+ghp-import==2.1.0
+idna==3.4
+Jinja2==3.1.2
+lxml==4.9.3
+Markdown==3.4.4
+MarkupSafe==2.1.3
+mergedeep==1.3.4
+mkdocs==1.5.3
+mkdocs-material==9.3.2
+mkdocs-material-extensions==1.2
+packaging==23.1
+paginate==0.5.6
+pathspec==0.11.2
+platformdirs==3.10.0
+Pygments==2.16.1
+pymdown-extensions==10.3
+python-dateutil==2.8.2
+PyYAML==6.0.1
+pyyaml_env_tag==0.1
+regex==2022.10.31
+requests==2.31.0
+six==1.16.0
+urllib3==2.0.5
+watchdog==3.0.0