Merge pull request #2413 from dotnet/feature/website-3.0

[3.0] A new website for both Silk.NET 3.0 and 2.X

Author: curin

.github/workflows/publish-site.yml

@@ -0,0 +1,41 @@
+name: Website Build
+on:
+  push:
+    branches:
+      - 'develop/3.0'
+  pull_request:
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  Build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Build Website
+        run: |
+          git submodule update --init eng/submodules/silk.net-2.x
+          cd eng/submodules/silk.net-2.x
+          git fetch --all
+          cd ../../..
+          ./build.sh website
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Upload artifact
+        if: ${{ github.repository == 'dotnet/Silk.NET' && github.ref == 'refs/heads/develop/3.0' }}
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "artifacts/docs/Silk.NET"
+  Deploy:
+    if: ${{ github.repository == 'dotnet/Silk.NET' && github.ref == 'refs/heads/develop/3.0' }}
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: Build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -479,6 +479,7 @@ excluded-platforms.txt
 #/docs/
 src/Website/Silk.NET.Statiq/temp
 src/Website/Silk.NET.Statiq/cache
+.nuke/temp
 
 # SilkTouch configs
 !eng/silktouch/**/*.rsp

.gitmodules

@@ -10,3 +10,6 @@
 [submodule "eng/submodules/sdl"]
 	path = eng/submodules/sdl
 	url = https://github.com/libsdl-org/SDL
+[submodule "eng/submodules/silk.net-2.x"]
+	path = eng/submodules/silk.net-2.x
+	url = https://github.com/dotnet/Silk.NET

.nuke/build.schema.json

@@ -34,7 +34,8 @@
         "PushToNuGet",
         "RegenerateBindings",
         "ShipApi",
-        "SignPackages"
+        "SignPackages",
+        "Website"
       ]
     },
     "Verbosity": {
@@ -181,6 +182,10 @@
             "type": "string"
           }
         },
+        "SkipContributorsScrape": {
+          "type": "boolean",
+          "description": "If enabled, skips scraping the contributors for the authors.yml file of the blog"
+        },
         "Solution": {
           "type": "string",
           "description": "Path to a solution file that is automatically loaded"

docs/for-contributors/README.md renamed to docs/for-contributors/README.mdx

@@ -1,3 +1,10 @@
+---
+title: "Overview"
+---
+
+import DocCardList from '@theme/DocCardList';
+import { useCurrentSidebarCategory } from '@docusaurus/theme-common';
+
 # The Silk.NET Contributors Guide
 
 Welcome to the Silk.NET project! We're so glad you want to help us create the best native interoperation experience that
@@ -9,9 +16,9 @@ the codebase and hit the ground running.
 ## Table of Contents
 
 - [Getting Started (you are here!)](#getting-started)
+- [Contribution Process](../CONTRIBUTING.md)
 - [Build System](build-system.md)
 
-
 ## Getting Started
 
 ### Prerequisites
@@ -55,3 +62,4 @@ where the values for the `-s` arguments are replaced with the job names (the key
 For more information on SilkTocuh arguments, consult the [SilkTouch User Guide](../silktouch) or use
 `dotnet run --project sources/SilkTouch/SilkTouch/Silk.NET.SilkTouch.csproj -- --help`.
 
+<DocCardList items={useCurrentSidebarCategory().items.filter((e) => e.label != "Overview")} />