Add Rust for Windows book and create unified docs/web area (#3733)

Author: riverar

.gitattributes

@@ -6,3 +6,7 @@
 *.lib   -text
 *.a     -text
 *.exe   -text
+*.eot   binary
+*.ttf   binary
+*.woff  binary
+*.woff2 binary

.github/workflows/web.yml

@@ -1,81 +1,60 @@
 name: web
 
 permissions:
-  contents: write
+  contents: read
+  pages: write
+  id-token: write
 
 on:
-  pull_request:
-    paths: [web/**]
-    types: [opened, synchronize, reopened, closed]
   push:
-    paths: [web/**]
     branches: [master]
-  workflow_dispatch:
+    paths: ["web/**"]
+  pull_request:
+    paths: ["web/**"]
 
 jobs:
   web:
-    if: github.repository == 'microsoft/windows-rs'
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
-        with:
-          path: current
+      - name: Get sources
+        uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v4
+      - name: Setup node
+        uses: actions/setup-node@v4
         with:
-          node-version: 'latest'
+          node-version: "latest"
 
-      - name: Build sites
-        shell: pwsh
+      - name: Setup mdBook
         run: |
-          cd current/web
-          $sites = Get-ChildItem -Directory
-          foreach ($site in $sites) {
-            Write-Host "Building $($site.Name)"
-            ./build.ps1 $site.Name
-          }
-
-      - uses: actions/checkout@v5
-        with:
-          ref: gh-pages
-          path: gh-pages
+          cargo install mdbook
 
-      - name: Update gh-pages
-        shell: pwsh
+      - name: Build
+        working-directory: web
         run: |
-          cd gh-pages
-
-          $sites = Get-ChildItem ../current/web -Directory
-          foreach ($site in $sites) {
-              Write-Host "Deploying $($site.Name)"
-
-              if ("${{ github.event_name }}" -eq "pull_request") {
-                  if ("${{ github.event.action }}" -eq "closed") {
-                      Remove-Item -Recurse -Force -ErrorAction Ignore "$($site.Name)/preview/pr-${{ github.event.number }}"
-                  } else {
-                      if (Test-Path "$($site.FullName)/build") {
-                          $previewPath = "$($site.Name)/preview/pr-${{ github.event.number }}"
-                          New-Item -ItemType Directory -Force $previewPath | Out-Null
-                          Remove-Item -Recurse -Force -ErrorAction Ignore "$previewPath/*"
-                          Copy-Item "$($site.FullName)/build/*" $previewPath -Recurse -Force
-                      }
-                  }
-              } elseif ("${{ github.ref }}" -eq "refs/heads/master") {
-                  if (Test-Path "$($site.FullName)/build") {
-                      New-Item -ItemType Directory -Force $site.Name | Out-Null
-                      Get-ChildItem "$($site.Name)/*" -Exclude "preview" | Remove-Item -Recurse -Force -ErrorAction Ignore
-                      Copy-Item "$($site.FullName)/build/*" $site.Name -Recurse -Force
-                  }
-              }
-          }
-
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git remote set-url origin https://github.com/${{ github.repository }}
+          mkdir -p .build/features .build/book
+
+          # Copy static files
+          cp -r static/* .build/
+
+          # Build book
+          pushd book
+          mdbook build --dest-dir ../.build/book
+          popd
+
+          # Build feature tool
+          pushd features
+          npm ci
+          npm run build
+          cp -r build/* ../.build/features/
+          popd
+
+      - name: Upload Pages artifact
+        if: github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: ./web/.build
 
-          $status = git status --porcelain
-          if ($status) {
-              git add .
-              git commit -m "Update from ${{ github.sha }}"
-              git push
-          }
+      - name: Deploy to GitHub Pages
+        if: github.event_name != 'pull_request'
+        id: deployment
+        uses: actions/deploy-pages@v4

web/book/book.toml

@@ -0,0 +1,10 @@
+[book]
+title = "Kenny Kerr"
+
+[build]
+build-dir = "docs"
+
+[output.html]
+cname = "kennykerr.ca"
+git-repository-url = "https://github.com/kennykerr/blog"
+input-404 = "404.html"

web/book/docs/.nojekyll

@@ -0,0 +1 @@
+This file makes sure that Github Pages doesn't process mdBook's output.

web/book/docs/404.html

@@ -0,0 +1,3 @@
+<script>
+    window.location.hostname = "kennykerrca.wordpress.com";
+</script>

web/book/docs/CNAME

@@ -0,0 +1 @@
+kennykerr.ca