chore: manually trigger docs

Allowing for manual trigger of docs workflow

Author: JimTools

.github/workflows/docs.yml

@@ -1,5 +1,6 @@
 name: Publish Docs
 on:
+  workflow_dispatch:
   push:
     branches:
       - main
@@ -17,19 +18,19 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Install PIP Dependencies
-        uses: actions/setup-python@v5
-        with:
-          cache: 'pip'
-      - run: |
-          cd docs
-          python -m pip install pyproject.toml
+      - name: Install UV
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install the project
+        run: uv sync --locked --all-groups --directory ./docs
 
       - name: Build Docs
         run: |
-          git fetch --tags
-          cd docs
-          sphinx-multiversion docs docs/build
+          git fetch --all
+          uv run --directory ./docs sphinx-multiversion . build
 
       - name: Setup Pages
         uses: actions/configure-pages@v5

.github/workflows/tests.yml

@@ -1,13 +1,10 @@
 name: Tests
 on:
-  push:
-    branches:
-      - main
-      - 1.x
   pull_request:
     branches:
       - main
       - 1.x
+      - 2.x
   workflow_dispatch:
 
 jobs:

docs/.gitignore

@@ -1,4 +1,3 @@
-.python-version
 build
 bin
 include

docs/conf.py

@@ -44,8 +44,8 @@
 highlight_language = "php"
 
 smv_tag_whitelist = r'^.*$'
-smv_branch_whitelist = r'^.*$'
-smv_remote_whitelist = r'^head/(\d\.x|main)$'
+smv_branch_whitelist = r'^(\d\.x|main)$'
+smv_remote_whitelist = r'^.*$'
 smv_released_pattern = r'^tags/.*$'
 smv_outputdir_format = '{ref.name}'
 smv_prefer_remote_refs = False

docs/requirements.txt

@@ -0,0 +1,24 @@
+alabaster==1.0.0
+babel==2.17.0
+certifi==2025.11.12
+charset-normalizer==3.4.4
+docutils==0.22.4
+idna==3.11
+imagesize==1.4.1
+Jinja2==3.1.6
+MarkupSafe==3.0.3
+packaging==25.0
+Pygments==2.19.2
+requests==2.32.5
+roman-numerals==4.1.0
+snowballstemmer==3.0.1
+Sphinx==9.0.4
+sphinx-multiversion==0.2.4
+sphinxcontrib-applehelp==2.0.0
+sphinxcontrib-devhelp==2.0.0
+sphinxcontrib-htmlhelp==2.1.0
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==2.0.0
+sphinxcontrib-serializinghtml==2.0.0
+urllib3==2.6.2
+uv==0.9.18