ci: fix docs publishing workflow (#30)

Adds missing `luaVersion` workflow parameter to manual-build-docs. Also
ensures `ldoc` is install on the CI runner.

Author: cwaldren-ld

.github/actions/build-docs/action.yml

@@ -4,6 +4,9 @@ description: 'Build Documentation.'
 runs:
   using: composite
   steps:
+    - name: Install LDoc
+      shell: bash
+      run: sudo apt-get update -y && sudo apt-get install -y lua-ldoc
     - name: Build Documentation
       shell: bash
-      run: ./scripts/build-docs.sh docs
+      run: ./scripts/build-docs.sh docs-build docs-release

.github/actions/publish-docs/action.yml

@@ -11,5 +11,5 @@ runs:
     - uses: launchdarkly/gh-actions/actions/publish-pages@publish-pages-v1.0.1
       name: 'Publish to Github pages'
       with:
-        docs_path: docs
+        docs_path: docs-release
         github_token: ${{ inputs.token }}

.github/workflows/manual-publish-docs.yml

@@ -14,7 +14,7 @@ jobs:
       - name: Build and Test
         uses: ./.github/actions/ci
         with:
-          token: ${{ secrets.GITHUB_TOKEN }}
+          lua-version: "5.3"
 
       - name: Build documentation
         uses: ./.github/actions/build-docs

scripts/build-docs.sh

@@ -3,16 +3,19 @@
 set -e
 
 # The first argument is the directory where the docs should be built.
+# The second is where the docs should be copied to when built.
 
-if [ -z "$1" ]; then
-    echo "Usage: $0 <docs-build-dir>"
+if [ "$#" -ne 2 ]; then
+    echo "Usage: $0 <docs build dir> <docs release dir>"
     exit 1
 fi
 
 DOCS_BUILD_DIR=$1
+DOCS_RELEASE_DIR=$2
+
 mkdir "$DOCS_BUILD_DIR"
 
 cp launchdarkly-server-sdk.c "$DOCS_BUILD_DIR"
 cp launchdarkly-server-sdk-redis.c "$DOCS_BUILD_DIR"
 
-ldoc -d "$LD_RELEASE_DOCS_DIR" "$DOCS_BUILD_DIR"
+ldoc -d "$DOCS_RELEASE_DIR" "$DOCS_BUILD_DIR"