* feat: add GEO infrastructure for AI search visibility
* fix: guard GEO blocks with {% if page %} to fix 404 build error
* feat: GEO platform optimization — FAQPage, IndexNow, answer paragraphs
* fix: move Disallow:/0.*/ to User-agent:* in robots.txt
* fix: block all numeric versioned paths in robots.txt
---------
Co-authored-by: Claude Code <noreply@anthropic.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
112 lines
4.8 KiB
YAML
112 lines
4.8 KiB
YAML
name: Docs/Build and Publish
|
|
|
|
on:
|
|
push:
|
|
branches:
|
|
- develop
|
|
workflow_dispatch:
|
|
release:
|
|
types: [published]
|
|
|
|
# Ensure only one concurrent deployment
|
|
concurrency:
|
|
group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.ref}}
|
|
cancel-in-progress: true
|
|
|
|
# Restrict permissions by default
|
|
permissions:
|
|
contents: write # Required for committing to gh-pages
|
|
pages: write # Required for deploying to Pages
|
|
pull-requests: write # Required for PR comments
|
|
|
|
jobs:
|
|
docs-build-deploy:
|
|
name: Publish Docs
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 10
|
|
steps:
|
|
- name: 📥 Checkout the repository
|
|
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
|
with:
|
|
fetch-depth: 0
|
|
|
|
- name: 🐍 Install uv and set Python
|
|
uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
|
|
with:
|
|
python-version: "3.10"
|
|
activate-environment: true
|
|
|
|
- name: 🏗️ Install dependencies
|
|
run: uv sync --frozen --group docs
|
|
|
|
- name: ⚙️ Configure git for github-actions
|
|
run: |
|
|
git config --global user.name "${{ github.actor }}"
|
|
git config --global user.email "${{ github.actor }}@users.noreply.github.com"
|
|
|
|
- name: 🚀 Deploy Development Docs
|
|
if: (github.event_name == 'push' && github.ref == 'refs/heads/develop') || github.event_name == 'workflow_dispatch'
|
|
env:
|
|
MKDOCS_GIT_COMMITTERS_APIKEY: ${{ secrets.GITHUB_TOKEN }}
|
|
run: |
|
|
mike deploy --push develop
|
|
|
|
- name: 🚀 Deploy Release Docs
|
|
if: github.event_name == 'release' && github.event.action == 'published'
|
|
env:
|
|
MKDOCS_GIT_COMMITTERS_APIKEY: ${{ secrets.GITHUB_TOKEN }}
|
|
run: |
|
|
latest_tag=$(git tag --sort=-v:refname | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | head -1)
|
|
mike deploy --push --update-aliases $latest_tag latest
|
|
|
|
# IndexNow key: 0d5d9799b1cc4a39825146388c6781eb
|
|
# This key must stay in sync across three files:
|
|
# docs/0d5d9799b1cc4a39825146388c6781eb.txt (key file served at site root)
|
|
# docs/theme/main.html (indexnow-key meta tag)
|
|
# this workflow (inject step + notify step below)
|
|
# Bing/Yandex fetch https://supervision.roboflow.com/<key>.txt to verify ownership.
|
|
# Do NOT rename or delete the .txt file or change the key string without updating all three.
|
|
- name: 🌐 Inject GEO root files into gh-pages
|
|
if: >
|
|
(github.event_name == 'push' && github.ref == 'refs/heads/develop') ||
|
|
github.event_name == 'workflow_dispatch' ||
|
|
(github.event_name == 'release' && github.event.action == 'published')
|
|
run: |
|
|
cp docs/robots.txt /tmp/robots.txt
|
|
cp docs/llms.txt /tmp/llms.txt
|
|
cp docs/0d5d9799b1cc4a39825146388c6781eb.txt /tmp/indexnow.txt
|
|
git fetch origin gh-pages
|
|
git checkout gh-pages
|
|
cp /tmp/robots.txt robots.txt
|
|
cp /tmp/llms.txt llms.txt
|
|
cp /tmp/indexnow.txt 0d5d9799b1cc4a39825146388c6781eb.txt
|
|
git add robots.txt llms.txt 0d5d9799b1cc4a39825146388c6781eb.txt
|
|
git diff --cached --quiet || git commit -m "chore: update GEO root files (robots.txt, llms.txt, indexnow)"
|
|
git push origin gh-pages
|
|
|
|
- name: 📡 Notify IndexNow
|
|
if: >
|
|
(github.event_name == 'push' && github.ref == 'refs/heads/develop') ||
|
|
github.event_name == 'workflow_dispatch' ||
|
|
(github.event_name == 'release' && github.event.action == 'published')
|
|
run: |
|
|
curl -s -o /dev/null -w "%{http_code}" -X POST "https://api.indexnow.org/IndexNow" \
|
|
-H "Content-Type: application/json; charset=utf-8" \
|
|
-d '{
|
|
"host": "supervision.roboflow.com",
|
|
"key": "0d5d9799b1cc4a39825146388c6781eb",
|
|
"keyLocation": "https://supervision.roboflow.com/0d5d9799b1cc4a39825146388c6781eb.txt",
|
|
"urlList": [
|
|
"https://supervision.roboflow.com/",
|
|
"https://supervision.roboflow.com/latest/",
|
|
"https://supervision.roboflow.com/latest/how_to/detect_and_annotate/",
|
|
"https://supervision.roboflow.com/latest/how_to/track_objects/",
|
|
"https://supervision.roboflow.com/latest/how_to/detect_small_objects/",
|
|
"https://supervision.roboflow.com/latest/how_to/filter_detections/",
|
|
"https://supervision.roboflow.com/latest/how_to/save_detections/",
|
|
"https://supervision.roboflow.com/latest/how_to/count_in_zone/",
|
|
"https://supervision.roboflow.com/latest/how_to/benchmark_a_model/",
|
|
"https://supervision.roboflow.com/latest/how_to/process_datasets/"
|
|
]
|
|
}' || true
|