generate-documentation-site.yml

# Generate Documentation Site for Mathematics.NET

name: Generate Documentation Site

on:
  push:
    branches:
    - main
  workflow_dispatch:

permissions:
  contents: write
  pages: write
  id-token: write

concurrency:
  group: pages
  cancel-in-progress: true

jobs:
  publish-docs:
    name: Generate Documentation Site
    runs-on: ubuntu-latest
    steps:
    - name: Checkout Repository
      uses: actions/checkout@v4

    - name: Set up .NET
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: 9.x

    - name: Build Mathematics.NET Project
      run: |
        cd src/Mathematics.NET
        dotnet build -c Release

    - name: Update DocFX
      run: dotnet tool update -g docfx

    - name: Run DocFX
      run: docfx docs/docfx.json

    - name: Deploy
      uses: peaceiris/actions-gh-pages@v4
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: docs/_site
        cname: mathematics.hamlettanyavong.com
        force_orphan: true