More work for multi-versioning

Author: Perksey

.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

eng/build/Build.Website.cs

@@ -1,27 +1,117 @@
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text.Json;
+using System.Text.Json.Serialization;
 using Nuke.Common;
 using Nuke.Common.IO;
+using Nuke.Common.Tooling;
 using static Nuke.Common.Tools.Git.GitTasks;
 using static Nuke.Common.Tools.Npm.NpmTasks;
 
 partial class Build
 {
+    readonly record struct VersionDescription(
+        AbsolutePath Path,
+        AbsolutePath StaticPath,
+        string Name,
+        bool IsSilk2
+    );
+
+    // From oldest to newest. Last one is current.
+    VersionDescription[] Versions =>
+        [
+            new(
+                RootDirectory / "eng" / "submodules" / "silk.net-2.x" / "documentation",
+                RootDirectory / "eng" / "submodules" / "silk.net-2.x" / "documentation" / "images",
+                "v2",
+                true
+            ),
+            new(
+                RootDirectory / "docs",
+                RootDirectory / "sources" / "Website" / "static" / "img",
+                "v3",
+                false
+            ),
+        ];
+
+    readonly record struct JsonVersion(
+        string Label,
+        [property: JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] string? Path
+    );
+
     void FullBuildWebsite()
     {
-        if (!GitHasCleanWorkingCopy())
+        // Copy the current docs directory to a temporary directory, as we'll be making a lot of changes to this.
+        (TemporaryDirectory / "docs").CreateOrCleanDirectory();
+        (RootDirectory / "docs").Copy(
+            TemporaryDirectory / "docs",
+            ExistsPolicy.MergeAndOverwriteIfNewer
+        );
+        (TemporaryDirectory / "website").CreateOrCleanDirectory();
+        (RootDirectory / "sources" / "Website").Copy(
+            TemporaryDirectory / "website",
+            ExistsPolicy.MergeAndOverwriteIfNewer
+        );
+        try
         {
-            Assert.Fail("Working directory is not clean.");
+            var versions = Versions;
+            var jsonVersions = new Dictionary<string, JsonVersion>(versions.Length);
+            for (var i = 0; i < versions.Length; i++)
+            {
+                var version = versions[i];
+                (RootDirectory / "docs").CreateOrCleanDirectory();
+                (
+                    version.Path == RootDirectory / "docs"
+                        ? TemporaryDirectory / "docs"
+                        : version.Path
+                ).Copy(RootDirectory / "docs", ExistsPolicy.MergeAndOverwriteIfNewer);
+                if (i != versions.Length - 1)
+                {
+                    version.StaticPath.CopyToDirectory(
+                        RootDirectory / "sources" / "Website" / "static",
+                        ExistsPolicy.MergeAndOverwriteIfNewer
+                    );
+
+                    Npm(
+                        $"run docusaurus docs:version {version.Name}",
+                        RootDirectory / "sources" / "Website"
+                    );
+                }
+
+                jsonVersions[i == versions.Length - 1 ? "current" : version.Name] = new JsonVersion(
+                    Git($"describe --tags --abbrev=0", version.Path)
+                        .First(x => x.Type == OutputType.Std)
+                        .Text.Trim(),
+                    version.Name
+                );
+            }
+
+            (RootDirectory / "artifacts" / "docs").CreateOrCleanDirectory();
+            File.WriteAllText(
+                RootDirectory / "sources" / "Website" / "silkversions.json",
+                JsonSerializer.Serialize(jsonVersions)
+            );
+            Npm($"run build -- --out-dir {RootDirectory / "artifacts" / "docs"}");
+        }
+        finally
+        {
+            File.Delete(RootDirectory / "sources" / "Website" / "silkversions.json");
+            (RootDirectory / "docs").CreateOrCleanDirectory();
+            (TemporaryDirectory / "docs").Copy(
+                RootDirectory / "docs",
+                ExistsPolicy.MergeAndOverwriteIfNewer
+            );
+            (TemporaryDirectory / "docs").CreateOrCleanDirectory();
+            (RootDirectory / "sources" / "Website").CreateOrCleanDirectory();
+            (TemporaryDirectory / "website").Copy(
+                RootDirectory / "sources" / "Website",
+                ExistsPolicy.MergeAndOverwriteIfNewer
+            );
+            (TemporaryDirectory / "website").CreateOrCleanDirectory();
         }
-        (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"}");
     }
 }

sources/Website/docusaurus.config.ts

@@ -5,17 +5,7 @@ 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;
-}
+import { readFileSync, existsSync } from 'node:fs';
 
 // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
 
@@ -59,6 +49,18 @@ const rewriteSourceLinks = (options) => {
     return transformer;
 };
 
+// Used in the NUKE workflow
+function addSilkVersionsJson(dict: object): object {
+    if (existsSync("silkversions.json")) {
+        for (const [key, value] of Object.entries(JSON.parse(readFileSync("silkversions.json", "utf8")))) {
+            dict[key] = value;
+        }
+    }
+    return dict;
+}
+
+// @ts-ignore
+// @ts-ignore
 const config: Config = {
     title: 'Silk.NET',
     tagline: 'Your one-stop-shop for high performance .NET graphics & compute.',
@@ -108,15 +110,8 @@ const config: Config = {
                     ],
                     // TODO uncomment when v3 is released
                     // lastVersion: "current",
-                    versions: {
-                        current: {
-                            label: 'v3.0.0',
-                            path: "v3"
-                        },
-                        "v2": {
-                            label: getSilk2Version()
-                        }
-                    },
+                    // @ts-ignore
+                    versions: addSilkVersionsJson({}),
                 },
                 blog: {
                     showReadingTime: true,