feat(api): add RemoveHtmlExtensionApiRefSitemap project (#249)

* feat(api): add RemoveHtmlExtensionApiRefSitemap project

* fix(api): Add RemoveHtmlExtensionFromApiRefSitemap project to .contentignore

Author: pepinho24

.contentignore

@@ -11,6 +11,7 @@
 /fonts/
 /_build/
 /_buildApi/
+/_tools/RemoveHtmlExtensionFromApiRefSitemap/
 
 .dockerignore
 .editorconfig

_tools/RemoveHtmlExtensionFromApiRefSitemap/Program.cs

@@ -0,0 +1,25 @@
+using System;
+using System.IO;
+using System.Xml;
+
+namespace RemoveHtmlExtensionFromApiRefSitemap
+{
+    class Program
+    {
+        static void Main(string[] args)
+        {
+            if(args.Length < 2)
+            {
+                throw new ArgumentNullException("You must provide a path to the drop folder of the API reference so we can alter the sitemap.xml file in it.");
+            }
+            string pathToApiRefSitemap = Path.Combine(args[0], "sitemap.xml");
+            if (!File.Exists(pathToApiRefSitemap))
+            {
+                throw new FileNotFoundException("API Ref sitemap file not found in the target folder");
+            }
+            string sitemapText = File.ReadAllText(pathToApiRefSitemap);
+            sitemapText = sitemapText.Replace(".html</loc>", "</loc>");
+            File.WriteAllText(pathToApiRefSitemap, sitemapText);
+        }
+    }
+}

_tools/RemoveHtmlExtensionFromApiRefSitemap/RemoveHtmlExtensionFromApiRefSitemap.csproj

@@ -0,0 +1,8 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net6.0</TargetFramework>
+  </PropertyGroup>
+
+</Project>

_tools/RemoveHtmlExtensionFromApiRefSitemap/RemoveHtmlExtensionFromApiRefSitemap.sln

@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.30413.136
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RemoveHtmlExtensionFromApiRefSitemap", "RemoveHtmlExtensionFromApiRefSitemap.csproj", "{E8F2C9B0-13FA-49FB-A62E-C8824FA8D41A}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{E8F2C9B0-13FA-49FB-A62E-C8824FA8D41A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E8F2C9B0-13FA-49FB-A62E-C8824FA8D41A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E8F2C9B0-13FA-49FB-A62E-C8824FA8D41A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E8F2C9B0-13FA-49FB-A62E-C8824FA8D41A}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {24453D53-AFFF-450A-96DA-90C729B72F1C}
+	EndGlobalSection
+EndGlobal

_tools/RemoveHtmlExtensionFromApiRefSitemap/readme.txt

@@ -0,0 +1,12 @@
+To execute from the console:
+1. navigate your console to the folder with the .csproj file
+2. execute from "dotnet run"
+
+dotnet run SitemapGenerator.csproj -- "C:\\TheCurrentWorkspace\\_site\\api\\"
+
+The first argument is the project file name, the second is the path to the API reference folder so we can get to the sitemap.xml file inside and transform it. So, this must run after the api ref build - either before, or after combining it with the conceptual docs, but before uploading to staging/test/live.
+
+
+The "--" delimits bult-in dotnet run args from custom args.
+Note the double slashes, as they are required as an escaping sequence.
+