Add GitHub Actions workflow for publishing to GitHub Pages

Author: phil-scott-78

.github/workflows/publish-to-gh-pages.yml

@@ -0,0 +1,85 @@
+name: Build and publish to GitHub Pages
+
+on:
+  push:
+    branches: [ "*" ]
+  pull_request:
+    branches: [ "main" ]
+
+env:
+  ASPNETCORE_ENVIRONMENT: Production
+  WEBAPP_PATH: ./Spectre.Docs/
+  WEBAPP_CSPROJ: Spectre.Docs.csproj
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+
+      - name: Build the Project
+        run: |
+          dotnet build
+
+      - name: Run webapp and generate static files
+        run: |
+          dotnet run --project ${{ env.WEBAPP_PATH }}${{env.WEBAPP_CSPROJ}} --configuration Release -- build "/SpectreDocsPoc/"
+
+      - name: Install minify
+        run: |
+          curl -sfL https://github.com/tdewolff/minify/releases/latest/download/minify_linux_amd64.tar.gz | tar -xzf - -C /tmp
+          sudo mv /tmp/minify /usr/local/bin/
+
+      - name: Minify CSS and JavaScript files
+        run: |
+          # Find and minify all CSS files
+          find "${{ env.WEBAPP_PATH }}output" -type f -name "*.css" | while read cssfile; do
+            /usr/local/bin/minify -o "$cssfile" "$cssfile"
+            echo "Minified $cssfile"
+          done
+
+          # Find and minify all JavaScript files
+          find "${{ env.WEBAPP_PATH }}output" -type f -name "*.js" | while read jsfile; do
+            /usr/local/bin/minify -o "$jsfile" "$jsfile"
+            echo "Minified $jsfile"
+          done
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Add .nojekyll file
+        run: touch ${{ env.WEBAPP_PATH }}output/.nojekyll
+        
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ${{ env.WEBAPP_PATH }}output
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    if: (github.event_name == 'push' && github.ref == 'refs/heads/main') || (github.event_name == 'pull_request' && github.event.action == 'closed' && github.event.pull_request.merged == true)
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

Spectre.Docs.Examples/Spectre.Docs.Examples.csproj

@@ -2,7 +2,7 @@
 
     <PropertyGroup>
         <OutputType>Exe</OutputType>
-        <TargetFramework>net10.0</TargetFramework>
+        <TargetFramework>net9.0</TargetFramework>
         <ImplicitUsings>enable</ImplicitUsings>
         <Nullable>enable</Nullable>
     </PropertyGroup>

Spectre.Docs.sln

@@ -7,6 +7,15 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Spectre.Docs", "Spectre.Doc
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Spectre.Docs.Examples", "Spectre.Docs.Examples\Spectre.Docs.Examples.csproj", "{8BC53462-4821-40F3-BC23-B44A34328C42}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "External Solution Items", "External Solution Items", "{572E276C-2B31-4281-A599-C32258327DEB}"
+	ProjectSection(SolutionItems) = preProject
+		.editorconfig = .editorconfig
+		.gitignore = .gitignore
+		README.md = README.md
+		Remove-TagsFromMarkdown.ps1 = Remove-TagsFromMarkdown.ps1
+		.github\workflows\publish-to-gh-pages.yml = .github\workflows\publish-to-gh-pages.yml
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

global.json

@@ -0,0 +1,8 @@
+{
+  "projects": [ "src", "tests" ],
+  "sdk": {
+    "version": "9.0.100",
+    "allowPrerelease": true,
+    "rollForward": "latestFeature"
+  }
+}