Implement breadcrumbs fixes #138

Author: Mpdreamz

src/Elastic.Markdown/IO/DocumentationFolder.cs

@@ -6,62 +6,96 @@ namespace Elastic.Markdown.IO;
 
 public class DocumentationFolder
 {
-	public MarkdownFile? Index { get; }
+	public MarkdownFile? Index { get; set; }
 
-	public List<MarkdownFile> FilesInOrder { get; } = new();
-	public List<DocumentationFolder> GroupsInOrder { get; } = new();
+	public List<MarkdownFile> FilesInOrder { get; }
+	public List<DocumentationFolder> GroupsInOrder { get; }
+
+	public required DocumentationFolder? Parent { get; init; }
 
 	private HashSet<MarkdownFile> OwnFiles { get; }
 
 	public int Level { get; }
 
-	public DocumentationFolder(IReadOnlyCollection<ITocItem> toc,
+	public DocumentationFolder(
+		IReadOnlyCollection<ITocItem> toc,
 		IDictionary<string, DocumentationFile> lookup,
 		IDictionary<string, DocumentationFile[]> folderLookup,
 		int level = 0,
-		MarkdownFile? index = null)
+		MarkdownFile? index = null
+	)
 	{
 		Level = level;
-		Index = index;
+		var foundIndex = ProcessTocItems(toc, lookup, folderLookup, level, out var groupsInOrder, out var filesInOrder);
+
+		GroupsInOrder = groupsInOrder;
+		FilesInOrder = filesInOrder;
+		Index = index ?? foundIndex;
+
+		if (Index is not null)
+		{
+			FilesInOrder = FilesInOrder.Except([Index]).ToList();
+			Index.Parent ??= this;
+		}
+
+		OwnFiles = [.. FilesInOrder];
+	}
 
+	private MarkdownFile? ProcessTocItems(
+		IReadOnlyCollection<ITocItem> toc,
+		IDictionary<string, DocumentationFile> lookup,
+		IDictionary<string, DocumentationFile[]> folderLookup,
+		int level,
+		out List<DocumentationFolder> groupsInOrder,
+		out List<MarkdownFile> filesInOrder
+	)
+	{
+		groupsInOrder = [];
+		filesInOrder = [];
+		MarkdownFile? index = null;
 		foreach (var tocItem in toc)
 		{
 			if (tocItem is TocFile file)
 			{
 				if (!lookup.TryGetValue(file.Path, out var d) || d is not MarkdownFile md)
 					continue;
 
+				md.Parent = this;
+
 				if (file.Children.Count > 0 && d is MarkdownFile virtualIndex)
 				{
-					var group = new DocumentationFolder(file.Children, lookup, folderLookup, level + 1, virtualIndex);
-					GroupsInOrder.Add(group);
+					var group = new DocumentationFolder(file.Children, lookup, folderLookup, level + 1, virtualIndex)
+					{
+						Parent = this
+					};
+					groupsInOrder.Add(group);
 					continue;
 				}
 
-				FilesInOrder.Add(md);
+				filesInOrder.Add(md);
 				if (file.Path.EndsWith("index.md") && d is MarkdownFile i)
-					Index ??= i;
+					index ??= i;
 			}
 			else if (tocItem is TocFolder folder)
 			{
 				var children = folder.Children;
 				if (children.Count == 0
-					&& folderLookup.TryGetValue(folder.Path, out var documentationFiles))
+				    && folderLookup.TryGetValue(folder.Path, out var documentationFiles))
 				{
 					children = documentationFiles
 						.Select(d => new TocFile(d.RelativePath, true, []))
 						.ToArray();
 				}
 
-				var group = new DocumentationFolder(children, lookup, folderLookup, level + 1);
-				GroupsInOrder.Add(group);
+				var group = new DocumentationFolder(children, lookup, folderLookup, level + 1)
+				{
+					Parent = this
+				};
+				groupsInOrder.Add(group);
 			}
 		}
 
-		Index ??= FilesInOrder.FirstOrDefault();
-		if (Index != null)
-			FilesInOrder = FilesInOrder.Except(new[] { Index }).ToList();
-		OwnFiles = [.. FilesInOrder];
+		return index ?? filesInOrder.FirstOrDefault();
 	}
 
 	public bool HoldsCurrent(MarkdownFile current) =>

src/Elastic.Markdown/IO/DocumentationSet.cs

@@ -56,7 +56,10 @@ public DocumentationSet(BuildContext context)
 			.GroupBy(file => file.RelativeFolder)
 			.ToDictionary(g => g.Key, g => g.ToArray());
 
-		Tree = new DocumentationFolder(Configuration.TableOfContents, FlatMappedFiles, folderFiles);
+		Tree = new DocumentationFolder(Configuration.TableOfContents, FlatMappedFiles, folderFiles)
+		{
+			Parent = null
+		};
 	}
 
 	public MarkdownFile? GetMarkdownFile(IFileInfo sourceFile)

src/Elastic.Markdown/IO/MarkdownFile.cs

@@ -28,7 +28,9 @@ public MarkdownFile(IFileInfo sourceFile, IDirectoryInfo rootPath, MarkdownParse
 		Collector = context.Collector;
 	}
 
-	public DiagnosticsCollector Collector { get; }
+	private DiagnosticsCollector Collector { get; }
+
+	public DocumentationFolder? Parent { get; set; }
 
 	public string? UrlPathPrefix { get; }
 	private MarkdownParser MarkdownParser { get; }

src/Elastic.Markdown/Slices/HtmlWriter.cs

@@ -44,6 +44,9 @@ public async Task<string> RenderLayout(MarkdownFile markdown, Cancel ctx = defau
 		var html = markdown.CreateHtml(document);
 		await DocumentationSet.Tree.Resolve(ctx);
 		var navigationHtml = await RenderNavigation(markdown, ctx);
+
+		var previous = DocumentationSet;
+
 		var slice = Index.Create(new IndexViewModel
 		{
 			Title = markdown.Title ?? "[TITLE NOT SET]",

src/Elastic.Markdown/Slices/_Layout.cshtml

@@ -17,7 +17,6 @@
 </div>
 <div class="sy-page sy-container flex mx-auto">
 	@(new HtmlString(Model.NavigationHtml))
-	@*@(await RenderPartialAsync(Elastic.Markdown.Slices.Layout._TocTree.Create(Model)))*@
 	@(await RenderPartialAsync(_TableOfContents.Create(Model)))
 	<main class="sy-main w-full max-sm:max-w-full print:pt-6">
 		<div class="sy-breadcrumbs" role="navigation">
@@ -35,9 +34,19 @@
 						<span>/</span>
 						<meta itemprop="position" content="1">
 					</li>
+					@foreach (var item in Model.Parents.Reverse())
+					{
+						<li itemprop="itemListElement" itemscope="" itemtype="https://schema.org/ListItem">
+							<a itemprop="item" href="@item.Url">
+								<span itemprop="name">@item.Title</span>
+							</a>
+							<span>/</span>
+							<meta itemprop="position" content="2">
+						</li>
+					}
 					<li itemprop="itemListElement" itemscope="" itemtype="https://schema.org/ListItem">
-						<strong itemprop="name">Elastic Docs v3</strong>
-						<meta itemprop="position" content="2">
+						<strong itemprop="name">@Model.CurrentDocument.Title</strong>
+						<meta itemprop="position" content="3">
 					</li>
 				</ol>
 				<div class="xl:hidden ml-1">

src/Elastic.Markdown/Slices/_ViewModels.cs

@@ -27,6 +27,27 @@ public class LayoutViewModel
 	public required string NavigationHtml { get; set; }
 	public required string? UrlPathPrefix { get; set; }
 
+	private MarkdownFile[]? _parents;
+	public MarkdownFile[] Parents
+	{
+		get
+		{
+			if (_parents is not null)
+				return _parents;
+
+			var parents = new List<MarkdownFile>();
+			var current = CurrentDocument.Parent;
+			do
+			{
+				if (current is { Index: not null } && current.Index != CurrentDocument)
+					parents.Add(current.Index);
+				current = current?.Parent;
+			} while (current != null);
+
+			_parents = [.. parents];
+			return _parents;
+		}
+	}
 
 	public string Static(string path)
 	{