Introduced new MapTopicSitemap() extension method

Normally, the sitemap will be routed using the standard route—e.g., as supported by `MapDefaultControllerRoute()`. If that isn't being used, for some reason, the `MapTopicSitemap()` method provides a convenience method for establishing a specific route for the sitemap.

Currently, this hardcodes the route to `/Sitemap`. In the future, we may choose to extend that to provide a variable path, but that's not an immediate priority.

Author: JeremyCaney

OnTopic.AspNetCore.Mvc.Host/Startup.cs

@@ -112,11 +112,8 @@ public static void Configure(IApplicationBuilder app, IWebHostEnvironment env) {
       | Configure: MVC
       \-----------------------------------------------------------------------------------------------------------------------*/
       app.UseEndpoints(endpoints => {
-        endpoints.MapControllerRoute(
-          name: "default",
-          pattern: "{controller}/{action=Index}/"
-        );
         endpoints.MapTopicRoute("Web");
+        endpoints.MapTopicSitemap();
         endpoints.MapControllers();
       });
 

OnTopic.AspNetCore.Mvc/ServiceCollectionExtensions.cs

@@ -209,6 +209,25 @@ public static void MapImplicitAreaControllerRoute(this IEndpointRouteBuilder rou
     public static void MapImplicitAreaControllerRoute(this IEndpointRouteBuilder routes) =>
       routes.MapDynamicControllerRoute<TopicRouteValueTransformer>("{area:exists}/{action=Index}");
 
+    /*==========================================================================================================================
+    | EXTENSION: MAP TOPIC SITEMAP (IENDPOINTROUTEBUILDER)
+    \-------------------------------------------------------------------------------------------------------------------------*/
+    /// <summary>
+    ///   Adds the <c>Sitemap/{action=Index}</c> endpoint route for the OnTopic sitemap.
+    /// </summary>
+    /// <remarks>
+    ///   For most implementations, this will be covered by the default route, such as that implemented by the standard <see
+    ///   cref="ControllerEndpointRouteBuilderExtensions.MapDefaultControllerRoute(IEndpointRouteBuilder)"/> method that ships
+    ///   with ASP.NET. This extension method is provided as a convenience method for implementations that aren't using the
+    ///   standard route, for whatever reason, and want a specific route setup for the sitemap.
+    /// </remarks>
+    public static ControllerActionEndpointConventionBuilder MapTopicSitemap(this IEndpointRouteBuilder routes) =>
+      routes.MapControllerRoute(
+        name: "TopicSitemap",
+        pattern: "Sitemap/{action=Index}",
+        defaults: new { controller = "Sitemap" }
+      );
+
     /*==========================================================================================================================
     | EXTENSION: MAP TOPIC REDIRECT (IENDPOINTROUTEBUILDER)
     \-------------------------------------------------------------------------------------------------------------------------*/