deploy DocC docs to gh-pages root on pushing to master.

maxxfrazer · maxxfrazer · commit ccd5af892e8c · 2022-08-29T10:48:02.000+01:00
diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml
@@ -0,0 +1,32 @@
+name: Deploy DocC
+
+on:
+  push:
+    branches:
+      - "main"
+permissions:
+  contents: write
+jobs:
+  build_docs:
+    runs-on: macos-12
+    steps:
+      - name: Checkout 🛎️
+        uses: actions/checkout@v3
+
+      - name: Build DocC
+        run: |
+          swift package resolve
+          xcodebuild docbuild -scheme MessageKit -derivedDataPath 'docc' -destination 'generic/platform=iOS';
+          $(xcrun --find docc) process-archive \
+            transform-for-static-hosting docc/Build/Products/Debug-iphoneos/MessageKit.doccarchive \
+            --hosting-base-path '' \
+            --output-path docs
+          $(xcrun --find docc) process-archive \
+            transform-for-static-hosting docc/Build/Products/Debug-iphoneos/InputBarAccessoryView.doccarchive \
+            --hosting-base-path InputBarAccessoryView \
+            --output-path docs/InputBarAccessoryView
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs
diff --git a/.gitignore b/.gitignore
@@ -7,6 +7,8 @@
 build/
 DerivedData
 .build/
+docs/
+docc/
 
 ## Various settings
 *.pbxuser
