docs(ci): Publish to libtmux.org alongside git-pull.com

.github/dependabot.yml

@@ -0,0 +1,9 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      actions:
+        patterns: ['*']

.github/workflows/docs.yml

@@ -1,70 +1,133 @@
 name: docs
 
 on:
+  pull_request:
+    paths: &docs-paths
+      - CHANGES
+      - README.*
+      - 'docs/**'
+      - 'examples/**'
+      - 'src/libtmux/**'
+      - uv.lock
+      - pyproject.toml
+      - '.github/workflows/docs.yml'
   push:
-    branches:
-      - master
+    branches: [master]
+    tags: ['v*']
+    paths: *docs-paths
+  workflow_dispatch:
+    inputs:
+      source-ref:
+        description: Exact source ref to build
+        required: true
+        default: master
+      version:
+        description: URL version slug
+        required: true
+        default: latest
+      version-kind:
+        description: Version policy
+        required: true
+        type: choice
+        options: [trunk, tag, alias]
+        default: trunk
+      is-default:
+        description: Make this version canonical
+        required: true
+        type: boolean
+        default: false
+      resolves-to:
+        description: Immutable target for an alias
+        required: false
+        default: ''
+      publish:
+        description: Publish the selected revision to libtmux.org
+        required: true
+        type: boolean
+        default: false
 
 permissions:
   contents: read
-  id-token: write
 
 jobs:
-  build:
+  build-libtmux-org:
+    uses: libtmux/docs/.github/workflows/port-docs.yml@133013c4817fb8c654ca1e049d7ce2591e640c05
+    with:
+      port: py
+      source-ref: ${{ inputs.source-ref }}
+      version: ${{ inputs.version }}
+      version-kind: ${{ inputs.version-kind }}
+      is-default: ${{ inputs.is-default == true }}
+      resolves-to: ${{ inputs.resolves-to }}
+      publish: ${{ inputs.publish == true }}
+
+  # Both reusable workflows must move together to the same reviewed commit.
+  # Pull requests build only; dispatch publication is an explicit input.
+  publish-libtmux-org:
+    needs: build-libtmux-org
+    if: needs.build-libtmux-org.outputs.should-publish == 'true'
+    concurrency:
+      group: docs-deploy-${{ github.repository }}-py
+      queue: max
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJSON(needs.build-libtmux-org.outputs.matrix) }}
+    permissions:
+      contents: read
+      id-token: write
+    uses: libtmux/docs/.github/workflows/reusable-deploy.yml@133013c4817fb8c654ca1e049d7ce2591e640c05
+    with:
+      path-prefix: py/${{ matrix.version }}
+      artifact: docs-py-${{ matrix.version }}
+      version-kind: ${{ matrix.kind }}
+      port: py
+      version: ${{ matrix.version }}
+      label: ${{ matrix.version }}
+      is-default: ${{ matrix.isDefault }}
+      resolves-to: ${{ matrix.resolvesTo }}
+      environment: docs
+    secrets:
+      role-arn: ${{ secrets.LIBTMUX_ORG_ROLE_ARN }}
+      bucket: ${{ secrets.LIBTMUX_ORG_BUCKET }}
+      distribution: ${{ secrets.LIBTMUX_ORG_DISTRIBUTION }}
+
+  # The standalone site keeps its root Sphinx build and follows local symlinks.
+  # Only a default-branch push publishes it; branch dispatches target libtmux.org.
+  publish-git-pull-com:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
     runs-on: ubuntu-latest
     environment: docs
-    strategy:
-      matrix:
-        python-version: ['3.14']
+    env:
+      UV_FROZEN: 'true'
+    permissions:
+      contents: read
+      id-token: write
+    concurrency:
+      group: docs-git-pull-com-${{ github.repository }}
+      queue: max
     steps:
       - uses: actions/checkout@v7
 
-      - name: Filter changed file paths to outputs
-        uses: dorny/paths-filter@v4
-        id: changes
-        with:
-          filters: |
-            root_docs:
-              - CHANGES
-              - README.*
-            docs:
-              - 'docs/**'
-              - 'examples/**'
-            python_files:
-              - 'src/libtmux/**'
-              - uv.lock
-              - pyproject.toml
-
-      - name: Should publish
-        if: steps.changes.outputs.docs == 'true' || steps.changes.outputs.root_docs == 'true' || steps.changes.outputs.python_files == 'true'
-        run: echo "PUBLISH=$(echo true)" >> $GITHUB_ENV
-
       - name: Install uv
-        if: env.PUBLISH == 'true'
         uses: astral-sh/setup-uv@v10.0.1
         with:
           enable-cache: true
 
-      - name: Set up Python ${{ matrix.python-version }}
-        if: env.PUBLISH == 'true'
-        run: uv python install ${{ matrix.python-version }}
+      - name: Set up Python
+        run: uv python install 3.14
 
       - name: Install dependencies [w/ docs]
-        if: env.PUBLISH == 'true'
-        run: uv sync --all-extras --dev
+        run: uv sync --frozen --all-extras --dev
 
       - name: Install just
-        if: env.PUBLISH == 'true'
         uses: extractions/setup-just@v4
 
       - name: Print python versions
-        if: env.PUBLISH == 'true'
         run: |
           python -V
           uv run python -V
 
       - name: Cache sphinx fonts
-        if: env.PUBLISH == 'true'
         uses: actions/cache@v6
         with:
           path: ~/.cache/sphinx-fonts
@@ -73,32 +136,29 @@ jobs:
             sphinx-fonts-
 
       - name: Build documentation
-        if: env.PUBLISH == 'true'
+        env:
+          LIBTMUX_DOCS_STANDALONE: '1'
         run: |
           cd docs && just html
 
-      - name: Configure AWS Credentials
-        if: env.PUBLISH == 'true'
+      - name: Configure AWS credentials for libtmux.git-pull.com
         uses: aws-actions/configure-aws-credentials@v6
         with:
           role-to-assume: ${{ secrets.LIBTMUX_DOCS_ROLE_ARN }}
           aws-region: us-east-1
 
       - name: Push documentation to S3
-        if: env.PUBLISH == 'true'
         run: |
           aws s3 sync docs/_build/html "s3://${{ secrets.LIBTMUX_DOCS_BUCKET }}" \
             --delete --follow-symlinks
 
       - name: Invalidate CloudFront
-        if: env.PUBLISH == 'true'
         run: |
           aws cloudfront create-invalidation \
             --distribution-id "${{ secrets.LIBTMUX_DOCS_DISTRIBUTION }}" \
             --paths "/index.html" "/objects.inv" "/searchindex.js"
 
       - name: Purge cache on Cloudflare
-        if: env.PUBLISH == 'true'
         uses: jakejarvis/cloudflare-purge-action@v0.3.0
         env:
           CLOUDFLARE_TOKEN: ${{ secrets.CLOUDFLARE_TOKEN }}

.github/workflows/tests.yml

@@ -43,6 +43,9 @@ jobs:
           path: ~/tmux-builds/tmux-${{ matrix.tmux-version }}
           key: tmux-${{ matrix.tmux-version }}
 
+      - name: Refresh system package index
+        run: sudo apt-get update
+
       - name: Build tmux ${{ matrix.tmux-version }}
         if: steps.tmux-build-cache.outputs.cache-hit != 'true'
         run: |
@@ -53,7 +56,7 @@ jobs:
           cd ~/tmux-src/tmux-${{ matrix.tmux-version }}
           git checkout ${{ matrix.tmux-version }}
           sh autogen.sh
-          ./configure --prefix=$HOME/tmux-builds/tmux-${{ matrix.tmux-version }} && make && make install
+          ./configure --prefix="$HOME/tmux-builds/tmux-${{ matrix.tmux-version }}" && make && make install
           export PATH=$HOME/tmux-builds/tmux-${{ matrix.tmux-version }}/bin:$PATH
           cd ~
           tmux -V
@@ -77,7 +80,7 @@ jobs:
         run: |
           sudo apt install libevent-2.1-7
           export PATH=$HOME/tmux-builds/tmux-${{ matrix.tmux-version }}/bin:$PATH
-          ls $HOME/tmux-builds/tmux-${{ matrix.tmux-version }}/bin
+          ls "$HOME/tmux-builds/tmux-${{ matrix.tmux-version }}/bin"
           tmux -V
           uv run py.test --cov=./ --cov-append --cov-report=xml -n auto --verbose
         env:

.nvmrc

@@ -1 +1 @@
-24.20.0
+24.21.0

.tool-versions

@@ -1,3 +1,3 @@
 just 1.58.0
-uv 0.12.9
+uv 0.12.15
 python 3.14 3.13 3.12 3.11 3.10

CHANGES

@@ -47,6 +47,13 @@ _Notes on the upcoming release will go here._
 
 ### Documentation
 
+#### libtmux.org chrome and site-wide search (#755)
+
+Documentation pages carry libtmux.org's header, footer, and version switcher,
+and take their colors from the site's shared design tokens. Sphinx's own
+search page redirects to the site-wide search, which covers every libtmux
+port. Pages render as stock Furo when the shared stylesheet is unreachable.
+
 #### Cleaner `from_env` examples (#719)
 
 The rendered examples for {meth}`Pane.from_env() <libtmux.Pane.from_env>` and
@@ -59,6 +66,21 @@ it.
 
 ### Development
 
+#### Docs publish to libtmux.org (#756)
+
+The docs build publishes to `libtmux.org` under `en/py/latest/` through the
+shared deploy workflow every libtmux port calls, and keeps publishing to
+libtmux.git-pull.com unchanged. Each destination takes its own build:
+libtmux.org gets the site's shared shell with this port's reference nested
+at `api/`, libtmux.git-pull.com the Sphinx site at a root.
+
+#### Docs toolchain on gp-sphinx 0.1.0a38 (#755)
+
+`gp-sphinx` and its sibling extensions move to 0.1.0a38. `sphinx-gp-llms`
+resolves from a pinned upstream commit until a release carries its fix:
+`genindex`, `py-modindex`, and `search` no longer link a `.md` twin that was
+never written.
+
 #### CI actions updated to current majors
 
 Workflow actions moved to their current major releases: `actions/checkout` v7,