Merge branch 'main' into dependabot/github_actions/julia-actions/setu…

…p-julia-2

.github/workflows/doc-preview-cleanup.yml

@@ -0,0 +1,33 @@
+name: Doc Preview Cleanup
+
+on:
+  pull_request:
+    types: [closed]
+
+# Ensure that only one "Doc Preview Cleanup" workflow is force pushing at a time
+concurrency:
+  group: doc-preview-cleanup
+  cancel-in-progress: false
+
+jobs:
+  doc-preview-cleanup:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout gh-pages branch
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+      - name: Delete preview and history + push changes
+        run: |
+          if [ -d "${preview_dir}" ]; then
+              git config user.name "Documenter.jl"
+              git config user.email "[email protected]"
+              git rm -rf "${preview_dir}"
+              git commit -m "delete preview"
+              git branch gh-pages-new $(echo "delete history" | git commit-tree HEAD^{tree})
+              git push --force origin gh-pages-new:gh-pages
+          fi
+        env:
+          preview_dir: previews/PR${{ github.event.number }}

docs/make.jl

@@ -13,6 +13,7 @@ makedocs(;
     modules=[CriticalTransitions],
     doctest=false,
     format = Documenter.HTML(
+        canonical="https://juliadynamics.github.io/CriticalTransitions.jl/",
         prettyurls = get(ENV, "CI", nothing) == "true",
         mathengine = Documenter.MathJax2()
         ),
@@ -34,9 +35,10 @@ makedocs(;
         "Predefined systems" => "man/systems.md",
         "Development stage" => "man/dev.md"
     ],
-    plugins=[bib],
+    plugins=[bib]
 )
 
 deploydocs(
     repo = "github.com/juliadynamics/CriticalTransitions.jl.git",
+    push_preview = false
 )