update documentation action

Author: lkdvos

.github/workflows/Documentation.yml

@@ -21,6 +21,10 @@ on:
         default: "1"
         required: false
         type: string
+      localregistry:
+        description: 'Add local registries hosted on GitHub. Specified by providing the url (https/ssh) to the repositories as a newline (\n) seperated list.
+                      User is responsible for setting up the necessary SSH-Keys to access the repositories if necessary.'
+        default: ''
       self-hosted:
         description: "Run the job needs on a self hosted machine"
         default: false
@@ -58,25 +62,39 @@ jobs:
     runs-on: "${{ inputs.self-hosted && 'self-hosted' || inputs.os }}"
     steps:
       - uses: actions/checkout@v4
-
       - name: "Setup Julia ${{ inputs.julia-version }}"
         uses: julia-actions/setup-julia@v2
         with:
           version: "${{ inputs.julia-version }}"
 
-      - uses: julia-actions/cache@v1
+      - uses: julia-actions/cache@v2
         if: "${{ inputs.cache }}"
         with:
           token: "${{ secrets.GITHUB_TOKEN }}"
 
-      - name: "Install Dependencies"
-        run: julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()'
-
+      - name: Setup project
+        shell: julia --project=docs --color=yes {0}
+        run: |
+          import Pkg
+          Pkg.develop(PackageSpec(path=pwd()))
+          if VERSION >= v"1.8-"
+            Pkg.Registry.add()
+          else
+            Pkg.Registry.add("General")
+          end
+          if !isempty("$${{ inputs.localregistry }}")
+            local_repos = split("${{ inputs.localregistry }}", "\n") .|> string
+            for repo_url in local_repos
+              isempty(repo_url) && continue
+              Pkg.Registry.add(Pkg.RegistrySpec(; url=repo_url))
+            end
+          end
+          retry(Pkg.build)(verbose=true)
       - name: "Build and Deploy Documentation"
         env:
           GITHUB_TOKEN: ${{ inputs.github-token || secrets.GITHUB_TOKEN }}
           DOCUMENTER_KEY: ${{ inputs.documenter-key || secrets.DOCUMENTER_KEY }}
-        run: ${{ inputs.debug-documenter && 'JULIA_DEBUG="Documenter"' || '' }} julia --project=docs/ ${{ inputs.coverage && '--code-coverage=user' }} docs/makedocs.jl
+        run: ${{ inputs.debug-documenter && 'JULIA_DEBUG="Documenter"' || '' }} julia --project=docs/ ${{ inputs.coverage && '--code-coverage=user' }} docs/make.jl
 
       - uses: julia-actions/julia-processcoverage@v1
         if: "${{ inputs.coverage }}"