From d7782c4953f18e9bfd5f1d32192a98bda4889818 Mon Sep 17 00:00:00 2001 From: shenxianpeng Date: Wed, 22 Apr 2026 21:06:29 +0300 Subject: [PATCH 1/4] Remove requirements files and update CI workflow --- .github/workflows/docs.yml | 8 +- pyproject.toml | 4 +- requirements/requirements-docs.txt | 134 ---------------------------- requirements/requirements-style.txt | 24 ----- 4 files changed, 5 insertions(+), 165 deletions(-) delete mode 100644 requirements/requirements-docs.txt delete mode 100644 requirements/requirements-style.txt diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 7a3ff7d6..e119a4c1 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -15,9 +15,9 @@ jobs: with: python-version: '3.11' - name: Install dependencies - run: pip install --no-deps -r requirements/requirements-docs.txt + run: pip install hatch - name: Build site - run: mkdocs build --strict + run: hatch run docs:build deploy: runs-on: ubuntu-latest @@ -33,6 +33,6 @@ jobs: with: python-version: '3.11' - name: Install dependencies - run: pip install --no-deps -r requirements/requirements-docs.txt + run: pip install hatch - name: Deploy to GitHub Pages - run: mkdocs gh-deploy --force + run: hatch run docs:deploy diff --git a/pyproject.toml b/pyproject.toml index c6a4b99d..7bce6463 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -106,7 +106,7 @@ dependencies = [ ] [tool.hatch.env] -requires = ["hatch-mkdocs", "hatch-pip-compile"] +requires = ["hatch-mkdocs"] [tool.hatch.envs.default.scripts] all = [ @@ -169,7 +169,6 @@ dependencies = [ check = "mypy mkdocs" [tool.hatch.envs.style] -type = "pip-compile" detached = true dependencies = [ "black", @@ -208,7 +207,6 @@ check = ["markdown", "js", "css", "spelling"] [tool.hatch.env.collectors.mkdocs.docs] path = "mkdocs.yml" [tool.hatch.envs.docs] -type = "pip-compile" detached = false [tool.black] diff --git a/requirements/requirements-docs.txt b/requirements/requirements-docs.txt deleted file mode 100644 index 670f9bf0..00000000 --- a/requirements/requirements-docs.txt +++ /dev/null @@ -1,134 +0,0 @@ -# -# This file is autogenerated by hatch-pip-compile with Python 3.11 -# -# - markdown-callouts -# - mdx-gh-links -# - mkdocs -# - mkdocs-autorefs -# - mkdocs-click -# - mkdocs-literate-nav -# - mkdocs-redirects -# - mkdocstrings -# - mkdocstrings-python -# - pymdown-extensions -# - click>=7.0 -# - colorama>=0.4; platform_system == "Windows" -# - ghp-import>=1.0 -# - importlib-metadata>=4.4; python_version < "3.10" -# - jinja2>=2.11.1 -# - markdown>=3.3.6 -# - markupsafe>=2.0.1 -# - mergedeep>=1.3.4 -# - mkdocs-get-deps>=0.2.0 -# - packaging>=20.5 -# - pathspec>=0.11.1 -# - pyyaml-env-tag>=0.1 -# - pyyaml>=5.1 -# - watchdog>=2.0 -# - -click==8.1.8 - # via - # hatch.envs.docs - # mkdocs - # mkdocs-click - # mkdocstrings -colorama==0.4.6 - # via griffe -ghp-import==2.1.0 - # via - # hatch.envs.docs - # mkdocs -griffe==1.14.0 - # via mkdocstrings-python -jinja2==3.1.6 - # via - # hatch.envs.docs - # mkdocs - # mkdocstrings -markdown==3.9 - # via - # hatch.envs.docs - # markdown-callouts - # mdx-gh-links - # mkdocs - # mkdocs-autorefs - # mkdocs-click - # mkdocstrings - # pymdown-extensions -markdown-callouts==0.4.0 - # via hatch.envs.docs -markupsafe==3.0.3 - # via - # hatch.envs.docs - # jinja2 - # mkdocs - # mkdocstrings -mdx-gh-links==0.4 - # via hatch.envs.docs -mergedeep==1.3.4 - # via - # hatch.envs.docs - # mkdocs - # mkdocs-get-deps -mkdocs==1.6.1 - # via - # hatch.envs.docs - # mkdocs-autorefs - # mkdocs-literate-nav - # mkdocs-redirects - # mkdocstrings -mkdocs-autorefs==1.4.4 - # via - # hatch.envs.docs - # mkdocstrings -mkdocs-click==0.9.0 - # via hatch.envs.docs -mkdocs-get-deps==0.2.2 - # via hatch.envs.docs -mkdocs-literate-nav==0.6.3 - # via hatch.envs.docs -mkdocs-redirects==1.2.2 - # via hatch.envs.docs -mkdocstrings==0.30.1 - # via - # hatch.envs.docs - # mkdocstrings-python -mkdocstrings-python==1.18.2 - # via hatch.envs.docs -packaging==26.1 - # via - # hatch.envs.docs - # mkdocs -pathspec==1.0.4 - # via - # hatch.envs.docs - # mkdocs -platformdirs==4.4.0 - # via - # mkdocs - # mkdocs-get-deps - # mkdocstrings -pymdown-extensions==10.21.2 - # via - # hatch.envs.docs - # mkdocstrings -python-dateutil==2.9.0.post0 - # via ghp-import -pyyaml==6.0.3 - # via - # hatch.envs.docs - # mkdocs - # mkdocs-get-deps - # pymdown-extensions - # pyyaml-env-tag -pyyaml-env-tag==1.1 - # via - # hatch.envs.docs - # mkdocs -six==1.17.0 - # via python-dateutil -watchdog==6.0.0 - # via - # hatch.envs.docs - # mkdocs diff --git a/requirements/requirements-style.txt b/requirements/requirements-style.txt deleted file mode 100644 index a022836f..00000000 --- a/requirements/requirements-style.txt +++ /dev/null @@ -1,24 +0,0 @@ -# -# This file is autogenerated by hatch-pip-compile with Python 3.11 -# -# - black -# - isort -# - ruff -# - -black==25.11.0 - # via hatch.envs.style -click==8.1.8 - # via black -isort==6.1.0 - # via hatch.envs.style -mypy-extensions==1.1.0 - # via black -packaging==26.1 - # via black -pathspec==1.0.4 - # via black -platformdirs==4.4.0 - # via black -ruff==0.15.11 - # via hatch.envs.style From 16ed5e4ddfc072b531789367c663fbece5030186 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 22 Apr 2026 18:29:18 +0000 Subject: [PATCH 2/4] docs: update CONTRIBUTING docs dependency instructions Agent-Logs-Url: https://github.com/mkdocs-ng/mkdocs/sessions/4406160a-20af-46e1-a2bb-3277bf302bea Co-authored-by: shenxianpeng <3353385+shenxianpeng@users.noreply.github.com> --- CONTRIBUTING.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c9fe5811..439a540b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -121,10 +121,10 @@ hatch run lint:check If you add a new plugin to mkdocs.yml, you don't need to add it to any "requirements" file, because that is managed automatically. -> INFO: If you don't want to use Hatch, for documentation you can install requirements into a virtualenv, in one of these ways (with `.venv` being the virtualenv directory): +> INFO: If you don't want to use Hatch, for documentation you can install dependencies into a virtualenv (with `.venv` being the virtualenv directory): > > ```bash -> .venv/bin/pip install -r requirements/requirements-docs.txt # Exact versions of dependencies. +> .venv/bin/pip install --editable . > .venv/bin/pip install -r $(mkdocs get-deps) # Latest versions of all dependencies. > ``` From 7ddb3b4228b2059d003d6537d56cb1fa04bcb9fe Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 22 Apr 2026 18:29:52 +0000 Subject: [PATCH 3/4] docs: clarify fallback docs dependency command comments Agent-Logs-Url: https://github.com/mkdocs-ng/mkdocs/sessions/4406160a-20af-46e1-a2bb-3277bf302bea Co-authored-by: shenxianpeng <3353385+shenxianpeng@users.noreply.github.com> --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 439a540b..65d51736 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -125,7 +125,7 @@ If you add a new plugin to mkdocs.yml, you don't need to add it to any "requirem > > ```bash > .venv/bin/pip install --editable . -> .venv/bin/pip install -r $(mkdocs get-deps) # Latest versions of all dependencies. +> .venv/bin/pip install -r $(mkdocs get-deps) # Additional dependencies from mkdocs.yml plugins/themes. > ``` ## Translating themes From f367d9c21f5188b4db51a61564e8da517b3f8daa Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 22 Apr 2026 18:30:39 +0000 Subject: [PATCH 4/4] docs: fix mkdocs get-deps install command in CONTRIBUTING Agent-Logs-Url: https://github.com/mkdocs-ng/mkdocs/sessions/4406160a-20af-46e1-a2bb-3277bf302bea Co-authored-by: shenxianpeng <3353385+shenxianpeng@users.noreply.github.com> --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 65d51736..d0d5f846 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -125,7 +125,7 @@ If you add a new plugin to mkdocs.yml, you don't need to add it to any "requirem > > ```bash > .venv/bin/pip install --editable . -> .venv/bin/pip install -r $(mkdocs get-deps) # Additional dependencies from mkdocs.yml plugins/themes. +> .venv/bin/pip install $(mkdocs get-deps) # Additional dependencies from mkdocs.yml plugins/themes. > ``` ## Translating themes