ci(.github): add build.yml; defer linting for now

Signed-off-by: Vaughn Dice <[email protected]>

Author: vdice

.github/workflows/build.yaml

@@ -0,0 +1,53 @@
+name: Build
+on:
+  pull_request:
+    branches: [main]
+
+env:
+  BART_VERSION: v0.10.0
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup Spin
+        uses: fermyon/actions/spin/setup@v1
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install bart
+        run: |
+          curl -LOs https://github.com/fermyon/bartholomew/releases/download/${{ env.BART_VERSION }}/bart-${{ env.BART_VERSION }}-linux-amd64.tar.gz
+          tar zxvf bart-${{ env.BART_VERSION }}-linux-amd64.tar.gz
+          mv bart /usr/local/bin
+      - name: Check Docs
+        run: |
+          bart check --shortcodes shortcodes content/* && bart check --shortcodes shortcodes content/**/*
+      
+      - name: Install npm packages
+        run: |
+          npm ci
+          npm ci --prefix ./spin-up-hub
+
+      - name: Build app
+        run: |
+          spin build
+
+      # TODO: re-enable after figuring out how to confgure the current linting tool; or choose another.
+      # By default, the current tool appears very aggressive, presenting errors for eg
+      # multiple consecutive new-lines, non-conforming title capitalization, etc
+      #
+      # - name: Lint markdown
+      #   run: |
+      #     npm run lint-markdown
+
+      - name: Run npm tests
+        run: |
+          npm test

package.json

@@ -40,7 +40,8 @@
     "spin": "nodemon --watch content --watch static --watch templates --watch spin-up-hub --ext html,md,rhai,hbs,css,js --verbose --legacy-watch --signal SIGINT --exec 'npm run build-index && npm run build-hub-index && spin up --file spin.toml --quiet --env PREVIEW_MODE=$PREVIEW_MODE'",
     "bundle-scripts": "parcel watch static/js/src/main.js --dist-dir static/js --no-source-maps",
     "styles": "parcel watch static/sass/styles.scss --dist-dir static/css",
-    "test": "npx markdownlint-cli2 content/**/*.md \"#node_modules\" && npm run check-broken-links",
+    "lint-markdown": "npx markdownlint-cli2 content/**/*.md \"#node_modules\"",
+    "test": "npm run check-broken-links",
     "build-index": "node md_parser.mjs --dir=./content/ --out=./static/data.json --ignore=./content/api/**/*",
     "check-broken-links": ".build/check-broken-links.sh",
     "build-hub-index": "node hub_index_generator.mjs --dir=./content/api/hub/ --out=./static/hub-index-data.json --ignore=./content/api/hub/get_list.md,"