Merge branch 'refs/heads/main' into feature/navigation

# Conflicts:
#	src/Elastic.Markdown/Assets/fonts.css
#	src/Elastic.Markdown/Assets/main.ts
#	src/Elastic.Markdown/Assets/styles.css
#	src/Elastic.Markdown/Slices/_Layout.cshtml
#	src/Elastic.Markdown/package-lock.json
#	src/Elastic.Markdown/package.json

Author: reakaleek

.github/workflows/comment-on-asciidoc-changes.yml

@@ -36,7 +36,7 @@ jobs:
               owner: context.repo.owner,
               repo: context.repo.repo,
               issue_number: context.payload.pull_request.number,
-              body: 'It looks like this PR modifies one or more `.asciidoc` files. These files are being migrated to Markdown, and any changes merged now will be lost. See the [migration guide](https://elastic.github.io/docs-builder/migration/freeze/index.html) for details.'
+              body: '> [!WARNING]\n> It looks like this PR modifies one or more `.asciidoc` files. These files are being migrated to Markdown, and any changes merged now will be lost. See the [migration guide](https://elastic.github.io/docs-builder/migration/freeze/index.html) for details.'
             })
 
       - name: Error if .asciidoc files changed

docs/syntax/applies.md

@@ -52,9 +52,7 @@ Are equivalent, note `all` just means we won't be rendering the version portion
 ## This section has its own applies annotations [#sections]
 
 :::{applies}
-:stack: unavailable
-:serverless: tech-preview
-:cloud: ga
+:serverless: unavailable
 :::
 
 :::{note}

src/Elastic.Markdown/Assets/fonts.css

@@ -1,16 +1,3 @@
-@font-face {
-	font-family: "Inter";
-	src: url("./fonts/InterVariable.woff2") format("woff2");
-	font-display: swap;
-}
-
-@font-face {
-	font-family: "Mier B";
-	src: url("./fonts/MierB-Regular.woff2") format("woff2");
-	font-weight: normal;
-	font-display: swap;
-}
-
 @font-face {
 	font-family: "Mier B";
 	src: url("./fonts/MierB-Bold.woff2") format("woff2");

src/Elastic.Markdown/DocumentationGenerator.cs

@@ -72,7 +72,6 @@ public async Task GenerateAll(Cancel ctx)
 
 		await ExtractEmbeddedStaticResources(ctx);
 
-
 		_logger.LogInformation($"Completing diagnostics channel");
 		Context.Collector.Channel.TryComplete();
 
@@ -92,6 +91,7 @@ private async Task ProcessDocumentationFiles(HashSet<string> offendingFiles, Dat
 	{
 		var processedFileCount = 0;
 		var exceptionCount = 0;
+		var totalFileCount = DocumentationSet.Files.Count;
 		_ = Context.Collector.StartAsync(ctx);
 		await Parallel.ForEachAsync(DocumentationSet.Files, ctx, async (file, token) =>
 		{
@@ -112,8 +112,9 @@ await Parallel.ForEachAsync(DocumentationSet.Files, ctx, async (file, token) =>
 			}
 
 			if (processedFiles % 100 == 0)
-				_logger.LogInformation($"-> Handled {processedFiles} files");
+				_logger.LogInformation($"-> Processed {processedFiles}/{totalFileCount} files");
 		});
+		_logger.LogInformation($"-> Processed {processedFileCount}/{totalFileCount} files");
 	}
 
 	private async Task ExtractEmbeddedStaticResources(Cancel ctx)
@@ -149,7 +150,7 @@ private async Task ProcessFile(HashSet<string> offendingFiles, DocumentationFile
 				return;
 		}
 
-		_logger.LogTrace($"{file.SourceFile.FullName}");
+		_logger.LogTrace($"--> {file.SourceFile.FullName}");
 		var outputFile = OutputFile(file.RelativePath);
 		if (file is MarkdownFile markdown)
 			await HtmlWriter.WriteAsync(outputFile, markdown, token);

src/Elastic.Markdown/Myst/CodeBlocks/CallOutParser.cs

@@ -8,9 +8,9 @@ namespace Elastic.Markdown.Myst.CodeBlocks;
 
 public static partial class CallOutParser
 {
-	[GeneratedRegex(@"^.+\S+.*?\s<\d+>$", RegexOptions.IgnoreCase, "en-US")]
+	[GeneratedRegex(@"^.+\S+.*?\s<\d+>$", RegexOptions.IgnoreCase, 2000, "en-US")]
 	public static partial Regex CallOutNumber();
 
-	[GeneratedRegex(@"^.+\S+.*?\s(?:\/\/|#)\s[^""\/#]+$", RegexOptions.IgnoreCase, "en-US")]
+	[GeneratedRegex(@"^.+\S+.*?\s(?:\/\/|#)\s[^""\/#]+$", RegexOptions.IgnoreCase, 2000, "en-US")]
 	public static partial Regex MathInlineAnnotation();
 }

src/Elastic.Markdown/Myst/CodeBlocks/EnhancedCodeBlockParser.cs

@@ -119,7 +119,7 @@ public override bool Close(BlockProcessor processor, Block block)
 				continue;
 
 			List<CallOut> callOuts = [];
-			var hasClassicCallout = span.IndexOf("<") > 0;
+			var hasClassicCallout = span.IndexOf("<") > 0 && span.LastIndexOf(">") == span.Length - 1;
 			if (hasClassicCallout)
 			{
 				var matchClassicCallout = CallOutParser.CallOutNumber().EnumerateMatches(span);

src/Elastic.Markdown/Myst/Comments/CommentBlockParser.cs

@@ -155,7 +155,7 @@ public override bool Close(BlockProcessor processor, Block block)
 	{
 		if (!processor.TrackTrivia)
 		{
-			var heading = (HeadingBlock)block;
+			var heading = (CommentBlock)block;
 			heading.Lines.Trim();
 		}
 

src/Elastic.Markdown/Myst/InlineParsers/DiagnosticLinkInlineParser.cs

@@ -168,10 +168,10 @@ private static void ProcessInternalLink(InlineProcessor processor, LinkInline li
 	{
 		var (url, anchor) = SplitUrlAndAnchor(link.Url ?? string.Empty);
 		var includeFrom = GetIncludeFromPath(url, context);
-
+		var file = ResolveFile(context, url);
 		ValidateInternalUrl(processor, url, includeFrom, line, column, length, context);
-		ProcessLinkText(processor, link, context, url, anchor, line, column, length);
-		UpdateLinkUrl(link, url, anchor, context.Build.UrlPathPrefix ?? string.Empty);
+		ProcessLinkText(processor, link, context, url, anchor, line, column, length, file);
+		UpdateLinkUrl(link, url, context, anchor, file);
 	}
 
 	private static (string url, string? anchor) SplitUrlAndAnchor(string fullUrl)
@@ -195,12 +195,11 @@ private static void ValidateInternalUrl(InlineProcessor processor, string url, s
 			processor.EmitError(line, column, length, $"`{url}` does not exist. resolved to `{pathOnDisk}");
 	}
 
-	private static void ProcessLinkText(InlineProcessor processor, LinkInline link, ParserContext context, string url, string? anchor, int line, int column, int length)
+	private static void ProcessLinkText(InlineProcessor processor, LinkInline link, ParserContext context, string url, string? anchor, int line, int column, int length, IFileInfo file)
 	{
 		if (link.FirstChild != null && string.IsNullOrEmpty(anchor))
 			return;
 
-		var file = ResolveFile(context, url);
 		var markdown = context.GetDocumentationFile?.Invoke(file) as MarkdownFile;
 
 		if (markdown == null)
@@ -236,15 +235,26 @@ private static void ValidateAnchor(InlineProcessor processor, MarkdownFile markd
 			processor.EmitError(line, column, length, $"`{anchor}` does not exist in {markdown.FileName}.");
 	}
 
-	private static void UpdateLinkUrl(LinkInline link, string url, string? anchor, string urlPathPrefix)
+	private static void UpdateLinkUrl(LinkInline link, string url, ParserContext context, string? anchor, IFileInfo file)
 	{
+		var urlPathPrefix = context.Build.UrlPathPrefix ?? string.Empty;
+
+		if (!url.StartsWith('/') && !string.IsNullOrEmpty(url))
+			url = GetRootRelativePath(context, file);
+
 		if (url.EndsWith(".md"))
 			url = Path.ChangeExtension(url, ".html");
 
-		if (url.StartsWith("/") && !string.IsNullOrWhiteSpace(urlPathPrefix))
+		if (!string.IsNullOrWhiteSpace(url) && !string.IsNullOrWhiteSpace(urlPathPrefix))
 			url = $"{urlPathPrefix.TrimEnd('/')}{url}";
 
-		link.Url = !string.IsNullOrEmpty(anchor) ? $"{url}#{anchor}" : url;
+		link.Url = string.IsNullOrEmpty(anchor) ? url : $"{url}#{anchor}";
+	}
+
+	private static string GetRootRelativePath(ParserContext context, IFileInfo file)
+	{
+		var docsetDirectory = context.Configuration.SourceFile.Directory;
+		return file.FullName.Replace(docsetDirectory!.FullName, string.Empty);
 	}
 
 	private static bool IsCrossLink(Uri? uri) =>

src/Elastic.Markdown/Myst/MarkdownParser.cs

@@ -60,7 +60,6 @@ public static MarkdownPipeline Pipeline
 				return _pipeline;
 
 			var builder = new MarkdownPipelineBuilder()
-				.EnableTrackTrivia()
 				.UseInlineAnchors()
 				.UsePreciseSourceLocation()
 				.UseDiagnosticLinks()

src/Elastic.Markdown/Slices/HtmlWriter.cs

@@ -28,6 +28,9 @@ public HtmlWriter(DocumentationSet documentationSet, IFileSystem writeFileSystem
 	public ILoggerFactory LoggerFactory { get; }
 	public ServiceProvider ServiceProvider { get; }
 
+	private Task<string> RenderEmptyString(MarkdownFile markdown, Cancel ctx = default) =>
+		Task.FromResult(string.Empty);
+
 	private async Task<string> RenderNavigation(MarkdownFile markdown, Cancel ctx = default)
 	{
 		var slice = Layout._TocTree.Create(new NavigationViewModel