mirror of
https://github.com/mikecarper/MeshCore.git
synced 2026-10-20 13:52:10 +00:00
Replace the download-file shortcut approach with compact self-contained picker URLs under /p/. Preserve long-link compatibility, selected install formats, and full published firmware filenames. Cover selection round trips and the redirect in the picker tests.
50 lines
1.5 KiB
YAML
50 lines
1.5 KiB
YAML
name: Build and deploy Docs site to GitHub Pages
|
|
|
|
on:
|
|
workflow_dispatch:
|
|
push:
|
|
branches:
|
|
- main
|
|
- keymindCascade
|
|
|
|
permissions:
|
|
contents: write
|
|
|
|
jobs:
|
|
github-pages:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
|
|
- name: Checkout Repo
|
|
uses: actions/checkout@v6
|
|
|
|
- name: Setup Python
|
|
uses: actions/setup-python@v6
|
|
with:
|
|
python-version: '3.13'
|
|
|
|
- name: Build
|
|
env:
|
|
GH_TOKEN: ${{ github.token }}
|
|
MKDOCS_SITE_URL: https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/
|
|
MKDOCS_REPO_NAME: ${{ github.repository }}
|
|
MKDOCS_REPO_URL: https://github.com/${{ github.repository }}/
|
|
MKDOCS_EDIT_URI: edit/${{ github.ref_name }}/docs/
|
|
run: |
|
|
pip install mkdocs-material
|
|
node test/test_firmware_picker.js
|
|
node test/test_partition_catalog_viewer.js
|
|
python scripts/sync_bootloader_manifest.py
|
|
mkdocs build
|
|
cmp firmware/esp32_partition_catalog.json site/_data/esp32_partition_catalog.json
|
|
|
|
- name: Deploy to GitHub Pages
|
|
uses: peaceiris/actions-gh-pages@v4.1.0
|
|
with:
|
|
github_token: ${{ secrets.GITHUB_TOKEN }}
|
|
# Preserve the upstream custom domain, but let forks publish at their
|
|
# normal <owner>.github.io/<repo>/ URL without claiming that domain.
|
|
cname: ${{ github.repository_owner == 'meshcore-dev' && 'docs.meshcore.io' || '' }}
|
|
publish_dir: ./site
|
|
publish_branch: 'gh-pages'
|