docs: Set up pkgdown website with automated GitHub Pages deployment

Co-authored-by: aider (gemini/gemini-2.5-pro) <aider@aider.chat>

Author: osorensen

.github/workflows/pkgdown.yml

@@ -0,0 +1,31 @@
+on:
+  push:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+name: pkgdown
+
+jobs:
+  pkgdown:
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: r-lib/actions/setup-r@v2
+        with:
+          use-public-rspm: true
+
+      - uses: r-lib/actions/setup-r-dependencies@v2
+        with:
+          extra-packages: any::pkgdown, local::.
+          needs: pkgdown
+
+      - name: Build and deploy site
+        run: pkgdown::build_site_github_pages()
+        shell: Rscript {0}

DESCRIPTION

@@ -22,6 +22,7 @@ Imports:
 Depends: 
     R (>= 4.1.0)
 Suggests: 
+    pkgdown (>= 2.0.0),
     testthat (>= 3.0.0),
     label.switching (>= 1.8)
 Config/testthat/edition: 3

_pkgdown.yml

@@ -0,0 +1,22 @@
+url: https://oystein-sorensen.github.io/BayesMallowsSMC2
+template:
+  bootstrap: 5
+
+navbar:
+  components:
+    reference:
+      text: Reference
+      href: reference/index.html
+    news:
+      text: Changelog
+      href: news/index.html
+
+reference:
+  - title: "Main function"
+    contents:
+      - compute_sequentially
+  - title: "Helper functions"
+    contents:
+      - set_hyperparameters
+      - set_smc_options
+      - precompute_topological_sorts