📝Documentation as static website (#144)

* 👷Update CI

Update CI to generate Documentation on main branch

* 👷Update docbuild.yml

Update docbuild.yml

* 👷Update docbuild.yml

* 💚Fix docbuild.yml

* 💚Fix docbuild.yml

* 💚Fix docbuild.yml

* 👷Update docbuild.yml

* 🚀Update docbuild.yml for deployment into main

Update docbuild.yml for deployment into main

* 🎨Review resolved

Review resolved

.github/workflows/docbuild.yml

@@ -0,0 +1,47 @@
+# Name your workflow.
+name: Deploy DocC
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      # Must be set to this for deploying to GitHub Pages
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: macos-13
+    steps:
+      - name: Checkout 🛎️
+        uses: actions/checkout@v4
+      - name: Check Xcode version ✅
+        uses: AckeeCZ/[email protected]
+      - name: Build DocC
+        run: |
+          xcodebuild docbuild -scheme ACKategories \
+            -derivedDataPath /tmp/docbuild \
+            -destination 'generic/platform=iOS';
+          $(xcrun --find docc) process-archive \
+            transform-for-static-hosting /tmp/docbuild/Build/Products/Debug-iphoneos/ACKategories.doccarchive \
+            --hosting-base-path ACKategories \
+            --output-path docs;
+          echo "<script>window.location.href += \"/documentation/ackategories\"</script>" > docs/index.html;
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          # Upload only docs directory
+          path: 'docs'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1