deploy github pages with scaladoc on release

Author: arturopala

.github/workflows/buildAndPublishPackage.yaml

@@ -78,6 +78,21 @@ jobs:
         with:
           tag_name: ${{ env.TAG_PREFIX }}${{ steps.version.outputs.new_version }}
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}      
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} 
+      - name: Upload static files as artifact
+        id: deployment
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site/ 
 
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: buildAndPublishPackage
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
 

.gitignore

@@ -3,3 +3,4 @@
 .metals/
 .vscode/
 bundle.zip
+_site/

scripts/createReleaseBundle.sc

@@ -100,6 +100,13 @@ call(s"ls -l $bundleArchivePath").foreach(println)
 call(s"mv bundle.zip $bundleFilePath", cwd = tempDir).foreach(println)
 println(s"${GREEN}Bundle archive ready at $bundleFilePath${RESET}")
 
+println(s"${GREEN}Uzipping scaladoc ...${RESET}")
+val siteFolderPath = os.pwd / "_site"
+val javadocFilePath = publishedFolder / "docs" / s"${artefactName}-javadoc.jar"
+os.makeDir.all(siteFolderPath)
+call(s"unzip $javadocFilePath -d $siteFolderPath")
+println(s"${GREEN}Scaladoc ready.${RESET}")
+
 // ---------- UTILS ----------
 
 def call(command: String, cwd: os.Path = os.pwd): Seq[String] =