Add deploy step to CI

Author: pfitzseb

.github/workflows/deploy.yml

@@ -0,0 +1,27 @@
+name: Aggregate
+on:
+  push:
+    branches:
+      - main
+jobs:
+  aggregate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: julia-actions/setup-julia@v1
+        with:
+          version: '1.8'
+      - uses: actions/cache@v1
+        env:
+          cache-name: cache-artifacts
+        with:
+          path: ~/.julia/artifacts
+          key: ${{ runner.os }}-test-${{ env.cache-name }}-${{ hashFiles('**/Project.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-test-${{ env.cache-name }}-
+            ${{ runner.os }}-test-
+            ${{ runner.os }}-
+      - name: Install dependencies
+        run: julia --project=. -e 'using Pkg; Pkg.instantiate()'
+      - name: Aggregate and deploy
+        run: julia --project=. docs/make.jl

docs/make.jl

@@ -0,0 +1,58 @@
+using MultiDocumenter
+
+clonedir = mktempdir()
+
+docs = [
+    MultiDocumenter.DropdownNav("Debugging", [
+        MultiDocumenter.MultiDocRef(
+            upstream = joinpath(clonedir, "Infiltrator"),
+            path = "inf",
+            name = "Infiltrator",
+            giturl = "https://github.com/JuliaDebug/Infiltrator.jl.git",
+        ),
+        MultiDocumenter.MultiDocRef(
+            upstream = joinpath(clonedir, "JuliaInterpreter"),
+            path = "debug",
+            name = "JuliaInterpreter",
+            giturl = "https://github.com/JuliaDebug/JuliaInterpreter.jl.git",
+        ),
+    ]),
+    MultiDocumenter.MultiDocRef(
+        upstream = joinpath(clonedir, "DataSets"),
+        path = "data",
+        name = "DataSets",
+        giturl = "https://github.com/JuliaComputing/DataSets.jl.git",
+        # or use ssh instead for private repos:
+        # giturl = "[email protected]:JuliaComputing/DataSets.jl.git",
+    ),
+]
+
+outpath = mktempdir()
+
+MultiDocumenter.make(
+    outpath,
+    docs;
+    search_engine = MultiDocumenter.SearchConfig(
+        index_versions = ["stable"],
+        engine = MultiDocumenter.FlexSearch
+    )
+)
+
+gitroot = normpath(joinpath(@__DIR__, ".."))
+try
+    run(`git checkout gh-pages`)
+catch err
+    # branch probably doesn't exist
+    run(`git checkout -b gh-pages`)
+end
+for file in readdir(gitroot; join = true)
+    endswith(file, ".git") && continue
+    rm(file; force = true, recursive = true)
+end
+for file in readdir(outpath)
+    cp(joinpath(outpath, file), joinpath(gitroot, file))
+end
+run(`git add .`)
+run(`git commit -m 'Aggregate documentation'`)
+run(`git push`)
+run(`git checkout main`)