ci: change project to github actions based workflow

Author: chrisnewtn

.github/workflows/deploy.yml

@@ -0,0 +1,63 @@
+name: Publish
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Use Node.js 20.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 20.x
+          cache: 'npm'
+          cache-dependency-path: '**/package-lock.json'
+
+      - name: Install Node.js app dependencies
+        run: npm ci
+        working-directory: ./scripts/doc-processor
+
+      - name: Process documentations & assets
+        run: node scripts/doc-processor/cli.js
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Upload the "public" directory
+          path: 'public'
+  deploy:
+    needs: build
+
+    permissions:
+      pages: write      # to deploy to Pages
+      id-token: write   # to verify the deployment originates from an appropriate source
+
+    # Deploy to the github-pages environment
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

.gitignore

@@ -1 +1,3 @@
 node_modules
+public/*.html
+public/*.css

docs/index.html

@@ -2,13 +2,12 @@
 
 _Why add content to your website, when you can spend an afternoon doing this instead!_
 
-For now, this applies basic formatting to a given HTML file, and also cache-busts its css. Later though, if the site
-expands to multiple pages, it'll likely do more.
+This primarily exists to ensure that assets are permanently cachable in a way that's revokable.
 
 ### Usage
 
-To format a given file in-situ, run the following:
+To process all the HTML files in a directory and output them to a different one, run:
 
 ```sh
-node cli.js path/to/file.html
+node cli.js -i path/to/input/dir -o path/to/output/dir
 ```

docs/style-8123f0b.css

@@ -18,12 +18,12 @@ const {
     'input-dir': {
       type: 'string',
       short: 'i',
-      default: path.resolve(__dirname, '..', '..', 'docs-raw')
+      default: path.resolve(__dirname, '..', '..', 'pages')
     },
     'output-dir': {
       type: 'string',
       short: 'o',
-      default: path.resolve(__dirname, '..', '..', 'docs')
+      default: path.resolve(__dirname, '..', '..', 'public')
     }
   }
 });