diff --git a/.github/workflows/docs-pages.yml b/.github/workflows/docs-pages.yml new file mode 100644 index 0000000..c40b989 --- /dev/null +++ b/.github/workflows/docs-pages.yml @@ -0,0 +1,74 @@ +name: Publish documentation + +# Builds the DocC documentation for static hosting and deploys it to GitHub Pages: +# https://tuner88.github.io/iOSSystemSoundsLibrary/documentation/systemsoundslibrary/ + +on: + push: + branches: [master] + workflow_dispatch: + +permissions: + contents: read + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + build: + name: Build DocC site + runs-on: macos-latest + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + + - name: Emit symbol graph + run: | + mkdir -p .build/symbol-graphs + swift build --target SystemSoundsLibrary \ + -Xswiftc -emit-symbol-graph \ + -Xswiftc -emit-symbol-graph-dir -Xswiftc .build/symbol-graphs + + - name: Convert documentation for static hosting + run: | + xcrun docc convert Sources/SystemSoundsLibrary/SystemSoundsLibrary.docc \ + --fallback-display-name SystemSoundsLibrary \ + --fallback-bundle-identifier com.github.tuner88.SystemSoundsLibrary \ + --additional-symbol-graph-dir .build/symbol-graphs \ + --transform-for-static-hosting \ + --hosting-base-path iOSSystemSoundsLibrary \ + --output-path .build/site + # The site root redirects to the package documentation. + cat > .build/site/index.html <<'HTML' + + +
+ +