Add blog

Author: Perksey

.nuke/build.schema.json

@@ -182,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"

eng/build/Build.Website.cs

@@ -7,9 +7,14 @@
 using System.Linq;
 using System.Text.Json;
 using System.Text.Json.Serialization;
+using System.Threading.Tasks;
 using Nuke.Common;
+using Nuke.Common.CI.GitHubActions;
 using Nuke.Common.IO;
 using Nuke.Common.Tooling;
+using Octokit;
+using Serilog;
+using static Nuke.Common.Tooling.ProcessTasks;
 using static Nuke.Common.Tools.Git.GitTasks;
 using static Nuke.Common.Tools.Npm.NpmTasks;
 
@@ -24,6 +29,10 @@ readonly record struct VersionDescription(
 
     // From oldest to newest. Last one is current.
     const bool IsCurrentVersionPreview = true;
+
+    [Parameter("If enabled, skips scraping the contributors for the authors.yml file of the blog.")]
+    readonly bool SkipContributorsScrape;
+
     VersionDescription[] Versions =>
         [
             new(
@@ -45,11 +54,20 @@ readonly record struct JsonVersion(
             JsonPropertyName("path"),
             JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)
         ]
-            string? Path
+            string? Path,
+        [property: JsonPropertyName("badge")] bool Badge = true
     );
 
-    void FullBuildWebsite()
+    async Task FullBuildWebsiteAsync()
     {
+        if (!SkipContributorsScrape)
+        {
+            await File.WriteAllLinesAsync(
+                RootDirectory / "sources" / "Website" / "blog" / "authors.yml",
+                await GetAuthorsContents().ToListAsync()
+            );
+        }
+
         (RootDirectory / "sources" / "Website" / "node_modules").CreateOrCleanDirectory();
         Npm("i", RootDirectory / "sources" / "Website");
         (TemporaryDirectory / "docs").CreateOrCleanDirectory();
@@ -107,6 +125,9 @@ version.Changelog is { } changelog
                 $"run build -- --out-dir {RootDirectory / "artifacts" / "docs" / "Silk.NET"}",
                 RootDirectory / "sources" / "Website"
             );
+            CreateRedirectsFromOldWebsiteUrlsToNewWebsiteUrls(
+                RootDirectory / "artifacts" / "docs" / "Silk.NET"
+            );
         }
         finally
         {
@@ -131,4 +152,107 @@ string GetVersionFromChangelog(AbsolutePath path)
         GetVersionInfo(File.ReadAllText(path), out var ver, out var suffix, out _);
         return string.IsNullOrWhiteSpace(suffix) ? $"v{ver}" : $"v{ver}-{suffix}";
     }
+
+    class SocialAccount(string? provider, string? url)
+    {
+        public SocialAccount()
+            : this(null, null) { }
+
+        public string? Provider { get; private set; } = provider;
+        public string? Url { get; private set; } = url;
+    }
+
+    async IAsyncEnumerable<string> GetAuthorsContents()
+    {
+        var github = new GitHubClient(
+            new ProductHeaderValue("Silk.NET-CI"),
+            new Octokit.Internal.InMemoryCredentialStore(
+                new Credentials(
+                    string.IsNullOrWhiteSpace(GitHubActions.Instance?.Token)
+                        ? StartProcess("gh", "auth token")
+                            .AssertZeroExitCode()
+                            .Output.First(x => x.Type == OutputType.Std)
+                            .Text.Trim()
+                        : GitHubActions.Instance.Token
+                )
+            )
+        );
+        var contributors = await github.Repository.GetAllContributors("dotnet", "Silk.NET");
+        foreach (var contributor in contributors ?? [])
+        {
+            if (contributor.Login.AsSpan().ContainsAny('[', ']'))
+            {
+                continue;
+            }
+
+            Log.Information("Fetching user info for {Login}", contributor.Login);
+            var user = await github.User.Get(contributor.Login);
+            if (user is null)
+            {
+                continue;
+            }
+
+            yield return $"{user.Login}:";
+            yield return $"  name: {user.Name ?? user.Login}";
+            yield return $"  url: https://github.com/{user.Login}";
+            yield return $"  image_url: https://github.com/{user.Login}.png";
+            yield return "  page: true";
+            Log.Information("Fetching user socials for {Login}", contributor.Login);
+            var socials = (
+                await github.Connection.Get<IReadOnlyList<SocialAccount>>(
+                    new Uri($"https://api.github.com/users/{user.Login}/social_accounts"),
+                    new Dictionary<string, string>(),
+                    "application/vnd.github+json"
+                )
+            ).Body;
+            if (socials is not { Count: > 0 })
+            {
+                continue;
+            }
+
+            yield return "  socials:";
+            foreach (var social in socials.DistinctBy(x => x.Provider))
+            {
+                yield return $"    {social.Provider}: \"{social.Url}\"";
+            }
+        }
+    }
+
+    const string BaseUrl = "https://dotnet.github.io/Silk.NET/";
+
+    string GetRedirect(string url) =>
+        $"""
+            <!DOCTYPE HTML>
+            <html>
+            <head>
+            <meta charset="UTF-8">
+            <meta http-equiv="refresh" content="1; url="{BaseUrl}{url}">
+            <script>
+              window.location.href = "{BaseUrl}{url}"
+            </script>
+            <title>Redirecting...</title>
+            </head>
+            <body>
+            <p>If you are not redirected automatically, <a href="{BaseUrl}{url}">click here</a>.</p>
+            </body>
+            </html>
+            """;
+
+    void CreateRedirectsFromOldWebsiteUrlsToNewWebsiteUrls(AbsolutePath basePath)
+    {
+        foreach (var dirStr in Directory.GetDirectories(basePath, "*", SearchOption.AllDirectories))
+        {
+            var dir = (AbsolutePath)dirStr;
+            var index = dir / "index.html";
+            if (!index.FileExists())
+            {
+                continue;
+            }
+
+            File.WriteAllText(
+                dir.Parent / $"{dir.Name}.html",
+                GetRedirect(dir.GetRelativePathTo(basePath).ToString().Replace('\\', '/'))
+            );
+        }
+    }
 }

eng/build/Build.cs

@@ -132,5 +132,5 @@ out var releaseNotes
             )
         );
 
-    Target Website => CommonTarget(x => x.Executes(FullBuildWebsite));
+    Target Website => CommonTarget(x => x.Executes(FullBuildWebsiteAsync));
 }

eng/build/Silk.NET.NUKE.csproj

@@ -16,5 +16,6 @@
     <PackageReference Include="Markdig" Version="0.39.0" />
     <PackageReference Include="Nuke.Common" Version="9.0.3" />
     <PackageReference Include="Octokit" Version="13.0.1" />
+    <PackageReference Include="System.Linq.Async" Version="6.0.1" />
   </ItemGroup>
 </Project>