Render Docs Website #93
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Render Docs Website | |
| on: | |
| push: | |
| branches: | |
| - master | |
| - backport-v0.* | |
| workflow_dispatch: # manual trigger for testing | |
| concurrency: | |
| group: docs | |
| cancel-in-progress: true | |
| jobs: | |
| build-and-deploy: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Setup Julia | |
| uses: julia-actions/setup-julia@v2 | |
| with: | |
| version: '1.10' | |
| - name: Load Julia packages from cache | |
| uses: julia-actions/cache@v2 | |
| # Note: needs resolve() to fix #518 | |
| - name: Instantiate Julia environment | |
| run: julia --project=. -e 'using Pkg; Pkg.instantiate(); Pkg.resolve()' | |
| - name: Set up Quarto | |
| uses: quarto-dev/quarto-actions/setup@v2 | |
| with: | |
| # Needs Quarto 1.6 to fix #533, which is currently a pre-release version | |
| version: pre-release | |
| - name: Install jq | |
| run: sudo apt-get install jq | |
| - name: Restore cached _freeze folder | |
| id: cache-restore | |
| uses: actions/cache/restore@v4 | |
| with: | |
| path: | | |
| ./_freeze/ | |
| key: | | |
| ${{ runner.os }}-${{ hashFiles('**/Manifest.toml') }}-${{ hashFiles('**/index.qmd') }} | |
| restore-keys: | | |
| ${{ runner.os }}-${{ hashFiles('**/Manifest.toml') }} | |
| - name: Extract version from _quarto.yml | |
| id: extract_version | |
| run: | | |
| minor_version=$(grep -oP 'text:\s+"v\K\d+\.\d+' _quarto.yml) | |
| echo "minor_version=$minor_version" >> $GITHUB_ENV | |
| - name: Fetch latest bugfix version for the extracted minor version | |
| id: fetch_latest_bugfix | |
| run: | | |
| repo_url="https://api.github.com/repos/TuringLang/Turing.jl/tags" | |
| tags=$(curl -s $repo_url | jq -r '.[].name') | |
| stable_tags=$(echo "$tags" | grep -Eo 'v[0-9]+\.[0-9]+\.[0-9]+$') | |
| latest_bugfix=$(echo "$stable_tags" | grep "^v${{ env.minor_version }}" | sort -rV | head -n 1) | |
| echo "version=$latest_bugfix" >> $GITHUB_ENV | |
| - name: Fetch the actual latest bugfix version | |
| id: fetch_latest_bugfix_actual | |
| run: | | |
| latest=$(curl --silent "https://api.github.com/repos/TuringLang/Turing.jl/releases/latest" | jq -r .tag_name) | |
| echo "LATEST=$latest" >> $GITHUB_ENV | |
| - name: Run Changelog and Versions Scripts | |
| if: env.version == env.LATEST | |
| run: | | |
| sh assets/scripts/changelog.sh | |
| sh assets/scripts/versions.sh | |
| - name: Render Quarto site | |
| run: quarto render | |
| - name: Rename original search index | |
| run: mv _site/search.json _site/search_original.json | |
| - name: Save _freeze folder | |
| id: cache-save | |
| uses: actions/cache/save@v4 | |
| with: | |
| path: | | |
| ./_freeze/ | |
| key: ${{ runner.os }}-${{ hashFiles('**/Manifest.toml') }}-${{ hashFiles('**/index.qmd') }} | |
| - name: Fetch search_original.json from main site | |
| run: curl -O https://raw.githubusercontent.com/TuringLang/turinglang.github.io/gh-pages/search_original.json | |
| - name: Convert main site search index URLs to relative URLs | |
| run: | | |
| jq 'map( | |
| if .href then .href = "../" + .href else . end | | |
| if .objectID then .objectID = "../" + .objectID else . end)' search_original.json > fixed_main_search.json | |
| - name: Merge both search index | |
| run: | | |
| jq -s '.[0] + .[1]' _site/search_original.json fixed_main_search.json > _site/search.json | |
| - name: Deploy versioned docs | |
| uses: JamesIves/github-pages-deploy-action@v4 | |
| with: | |
| branch: gh-pages | |
| folder: _site | |
| target-folder: versions/${{ env.version }} | |
| clean: false | |
| - name: Deploy latest docs to root | |
| if: env.version == env.LATEST | |
| uses: JamesIves/github-pages-deploy-action@v4 | |
| with: | |
| branch: gh-pages | |
| folder: _site | |
| clean: false |