- 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

fix: `source .venv/bin/activate` before build

fix: id-token write permission at job level

- adds back sphinx configs
- refactors `docs/gen_docs.py` to generate both
sphinx and mkdocs based docs as needed
- ignores dynamically generated doc files
- updates development dependencies

**Related items**

*Issues*

- Closes #258

feat: docs can be built with both sphinx & mkdocs

- renames script to `build_pgk.py`
- ignores dynamically generated man pages
- pkg includes `docs/validators.1` in built package
- adds option to select between web and man, Sphinx builds
- updates `build.yml` workflow accordingly

fix: improves build process

- removes IDNA enforced 64-char limit on url path & query
- validates absurd quoted url: `http://-.~_!$&'()*+,;=:%40:80%2f::::::@example.com`
- updates dependencies, changelog and pre-commit-hooks
- bumps patch version

**Related items**

*Issues*

- Closes #257

fix: removes 64-char limit for url path & query

feat: zero required dependencies

fix: project root install is required for build