Adding UriAugmenterService in order to augment Url generation.

[jeff-fischer-optimizely]

Some of the pages are not as simple as standard pages that need to be added to the sitemap. The Url needs to be augmented in order to be correctly indexed by google as the page requires Url parameters in order to correctly display data.

The UriAugmenterService takes an IContent, CurrentLanguageContent and Uri and turns it into an IEnumerable in order to take a single Uri and convert it into many possible Uris that are required to be indexed.

Additionally, this PR includes several files that were on disk (.gitignore, .md and nuget.config) into the solution for easy modification and fixes an uncompiled Regular Expression which will cause unnecessary excessive JIT compilation.

[marisks]

It would be good to add examples of a custom AugmentService in the documentation.

[jeff-fischer-optimizely]

I tried to do the deployment for the Foundation project, but couldn't get it to deploy for some reason.

[marisks]

@jeff-fischer-optimizely This is a standard Foundation project, if you follow Optimizely's instructions, it should work.
What exactly failed?

[jeff-fischer-optimizely]

It turned out to be a whole series of issues. Here are the ones that I can remember:

1. Running setup.cmd has a missing column within AspNetUsers table. Resolved by running this script after setup.cmd:
   ALTER TABLE dbo.AspNetUsers
   ADD NewsLetter bit NOT NULL DEFAULT(0)

2. When starting up Geta after the deployment, the Url for the site was null which caused exceptions in the job execution. I had to figure out the source of the issues and go and click Save within the Sitemap admin section of the UI to resolve the error.

3. I got an additional exception generating a sitemap because one of the ContentReferences handed into GenerateXmlElements was null. I consequently added this check in that method:
   if (ContentReference.IsNullOrEmpty(contentReference))
   {
   continue;
   }

4. From what I can tell, the IServiceCollection AddSitemaps configuration extension method's Action setupAction does not appear to get called at any point. I initially added my uriAugmenterServiceFactory onto the SitemapOptions, but at no point was the action called so my service was not getting added to the container. So, I abandoned that in favor of having it be a method overload within of AddSitemaps. Now updated in my PR.

5. I tried to utilize PersonListPage as an example of the UriAugmenter, but it turns out that page isn't actually rendered on the site and isn't being included in the sitemap. I'm out of time, otherwise I'd try and rewrite it to another page. So, ultimately, the example that I wrote up is never hit because the an instance of this page type isn't in the root. But, it illustrates the usage anyway.

I have successfully tested it now, but it just doesn't hit the section for PersonListpage within the custom UriAugmenterService.

Thanks,
Jeff

[marisks]

@jeff-fischer-optimizely I do not see any changes from the previous review.

[jeff-fischer-optimizely]

Hey @marisks, let me know if there are any other updates and I'll put them together. Hoping to wrap this up ASAP.