Start of adding 2.X to new website

Author: Perksey

.nuke/build.schema.json

@@ -34,7 +34,8 @@
         "PushToNuGet",
         "RegenerateBindings",
         "ShipApi",
-        "SignPackages"
+        "SignPackages",
+        "Website"
       ]
     },
     "Verbosity": {

eng/build/Build.Website.cs

@@ -0,0 +1,27 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Nuke.Common;
+using Nuke.Common.IO;
+using static Nuke.Common.Tools.Git.GitTasks;
+using static Nuke.Common.Tools.Npm.NpmTasks;
+
+partial class Build
+{
+    void FullBuildWebsite()
+    {
+        if (!GitHasCleanWorkingCopy())
+        {
+            Assert.Fail("Working directory is not clean.");
+        }
+        (RootDirectory / "docs").CreateOrCleanDirectory();
+        (RootDirectory / "eng" / "submodules" / "silk.net-2.x" / "documentation").Copy(
+            RootDirectory / "docs",
+            ExistsPolicy.DirectoryMerge
+        );
+        (RootDirectory / "docs" / "images").CreateOrCleanDirectory();
+        Npm($"npm run docusaurus docs:version v2", RootDirectory / "sources" / "Website");
+        (RootDirectory / "docs").CreateOrCleanDirectory();
+        Git($"checkout HEAD {RootDirectory / "docs"}");
+    }
+}

eng/build/Build.cs

@@ -131,4 +131,6 @@ out var releaseNotes
                     )
             )
         );
+
+    Target Website => CommonTarget(x => x.Executes(FullBuildWebsite));
 }

eng/submodules/silk.net-2.x

@@ -5,6 +5,17 @@ import remarkGithubAdmonitionsToDirectives from "remark-github-admonitions-to-di
 import { visit } from 'unist-util-visit';
 import { pathToFileURL } from 'node:url';
 import path from 'node:path';
+import { exec } from 'node:child_process';
+
+function getSilk2Version(): string {
+    let ver = "";
+    exec(
+        "git describe --tags HEAD --abbrev=0",
+        { cwd: "../../eng/submodules/silk.net-2.x" },
+        (_a, stdout, _b)=> ver = stdout
+    );
+    return ver;
+}
 
 // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
 
@@ -32,15 +43,15 @@ const rewriteSourceLinks = (options) => {
             if (!path.relative(docsRoot, resolvedUrlPath).startsWith("..")) {
                 return;
             }
-            console.log(resolvedUrlPath + " - " + node.url + " - " + fileDirPath + " - " + path.relative(docsRoot, resolvedUrlPath));
+            // console.log(resolvedUrlPath + " - " + node.url + " - " + fileDirPath + " - " + path.relative(docsRoot, resolvedUrlPath));
             let silk2Rel = path.relative(silk2Src, resolvedUrlPath);
             if (!silk2Rel.startsWith("..")) {
-                console.log(`replaced ${silk2Rel}`);
+                // console.log(`replaced ${silk2Rel}`);
                 node.url = `https://github.com/dotnet/Silk.NET/blob/main/src/${silk2Rel}`
             }
             let silk3Rel = path.relative(repoRoot, resolvedUrlPath);
             if (!silk3Rel.startsWith("..")) {
-                console.log(`replaced ${silk3Rel}`);
+                // console.log(`replaced ${silk3Rel}`);
                 node.url = `https://github.com/dotnet/Silk.NET/blob/develop/3.0/${silk3Rel}`
             }
         });
@@ -76,6 +87,8 @@ const config: Config = {
         locales: ['en'],
     },
 
+    staticDirectories: ["static", "../../eng/submodules/silk.net-2.x/documentation/images"],
+
     presets: [
         [
             'classic',
@@ -93,6 +106,17 @@ const config: Config = {
                         remarkGithubAdmonitionsToDirectives,
                         rewriteSourceLinks
                     ],
+                    // TODO uncomment when v3 is released
+                    // lastVersion: "current",
+                    versions: {
+                        current: {
+                            label: 'v3.0.0',
+                            path: "v3"
+                        },
+                        "v2": {
+                            label: getSilk2Version()
+                        }
+                    },
                 },
                 blog: {
                     showReadingTime: true,
@@ -128,6 +152,12 @@ const config: Config = {
                     label: 'Documentation',
                 },
                 {to: '/blog', label: 'Blog', position: 'left'},
+                {
+                    type: 'docsVersionDropdown',
+                    position: 'right',
+                    dropdownItemsAfter: [],
+                    dropdownActiveClassDisabled: true,
+                },
                 {
                     href: 'https://github.com/facebook/docusaurus',
                     label: 'GitHub',

sources/Website/docusaurus.config.ts

@@ -0,0 +1,50 @@
+{
+    "version": "3.0.0",
+    "resources": [
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/query",
+            "@type": "SearchQueryService",
+            "comment": "Filter and search for packages by keyword."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/query",
+            "@type": "SearchQueryService/3.0.0-beta",
+            "comment": "Filter and search for packages by keyword."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/query",
+            "@type": "SearchQueryService/3.0.0-rc",
+            "comment": "Filter and search for packages by keyword."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/metadata",
+            "@type": "RegistrationsBaseUrl",
+            "comment": "Get package metadata."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/metadata",
+            "@type": "RegistrationsBaseUrl/3.0.0-beta",
+            "comment": "Get package metadata."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/metadata",
+            "@type": "RegistrationsBaseUrl/3.0.0-rc",
+            "comment": "Get package metadata."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/download",
+            "@type": "PackageBaseAddress/3.0.0",
+            "comment": "Get package content (.nupkg)."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget",
+            "@type": "PackagePublish/2.0.0",
+            "comment": "Push and delete (or unlist) packages."
+        },
+        {
+            "@id": "https://gitlab.com/api/v4/projects/51457475/packages/nuget/symbolpackage",
+            "@type": "SymbolPackagePublish/4.9.0",
+            "comment": "Push symbol packages."
+        }
+    ]
+}