fix: source .venv/bin/activate before build

- rename `mkdocs.yml` to `mkdocs.yaml`
- same reflects in `docs/gen_docs.py`
- activates virtual environment before build

**Related items**

*Issues*

- Closes #253
- Closes #259

.github/workflows/build.yml

@@ -35,7 +35,9 @@ jobs:
  run: poetry install --no-interaction --no-ansi --only docs
  # build package
  - name: Build package
- run: python build.py
+ run: |
+ source .venv/bin/activate
+ python build.py
  # publish package
  - name: Publish to PyPI
  uses: pypa/gh-action-pypi-publish@release/v1

docs/gen_docs.py

@@ -61,11 +61,11 @@ def generate_documentation(source: Path, discard_refs: bool = True):
  # generate reference documentation
  nav_items = _generate_reference(source / "validators/__init__.py", source / "docs/reference")
  # backup mkdocs config
- _update_mkdocs_config(source / "mkdocs.yml", source / "mkdocs.bak.yml", nav_items)
+ _update_mkdocs_config(source / "mkdocs.yaml", source / "mkdocs.bak.yml", nav_items)
  # build docs as subprocess
  print(run(("mkdocs", "build"), capture_output=True).stderr.decode())
  # restore mkdocs config
- move(str(source / "mkdocs.bak.yml"), source / "mkdocs.yml")
+ move(str(source / "mkdocs.bak.yml"), source / "mkdocs.yaml")
  # optionally discard reference folder
  if discard_refs:
  rmtree(source / "docs/reference")