Index.cshtml

@using System.Text.Json
@using Elastic.Documentation
@using Elastic.Documentation.Configuration
@using Elastic.Documentation.Extensions
@using Elastic.Documentation.Site
@using Elastic.Markdown
@using Elastic.Markdown.Myst.Components
@using Markdig
@using ViewModelSerializerContext = Elastic.Markdown.Page.ViewModelSerializerContext
@inherits RazorSliceHttpResult<Elastic.Markdown.Page.IndexViewModel>
@implements IUsesLayout<Elastic.Codex._MarkdownLayout, MarkdownLayoutViewModel>
@functions {
	static string GetRootPath(string? siteRootPath, string? urlPathPrefix)
	{
		if (!string.IsNullOrEmpty(siteRootPath))
			return siteRootPath;
		var prefix = urlPathPrefix?.Trim('/') ?? "";
		return string.IsNullOrEmpty(prefix) ? "/" : $"/{prefix}/";
	}

	static bool IsDocsetRootUrl(string? navUrl, string? docsetUrl, string? urlPathPrefix)
	{
		if (string.IsNullOrEmpty(docsetUrl))
			return false;
		var docsetNorm = docsetUrl.TrimEnd('/');
		var navNorm = navUrl?.TrimEnd('/') ?? "";
		if (string.IsNullOrEmpty(navNorm) || navNorm == "/")
			return string.Equals((urlPathPrefix ?? "").TrimEnd('/'), docsetNorm, StringComparison.OrdinalIgnoreCase);
		if (navNorm.StartsWith("/"))
			return string.Equals(navNorm, docsetNorm, StringComparison.OrdinalIgnoreCase);
		var navFull = $"{urlPathPrefix?.TrimEnd('/')}/{navNorm.TrimStart('/')}".TrimEnd('/');
		return string.Equals(navFull, docsetNorm, StringComparison.OrdinalIgnoreCase);
	}

	public MarkdownLayoutViewModel LayoutModel => new()
	{
		DocsBuilderVersion = ShortId.Create(BuildContext.Version),
		Layout = Model.CurrentDocument.YamlFrontMatter?.Layout,
		RenderHamburgerIcon = Model.CurrentDocument.YamlFrontMatter?.Layout != MarkdownPageLayout.LandingPage,
		DocSetName = Model.DocSetName,
		Title = $"{Model.Title} | {Model.SiteName}",
		Description = Model.Description,
		PageTocItems = Model.PageTocItems.Where(i => i is
			{
				Level: 2 or 3
			})
			.ToList(),
		CurrentNavigationItem = Model.CurrentNavigationItem,
		Previous = Model.PreviousDocument,
		Next = Model.NextDocument,
		NavigationHtml = Model.NavigationHtml,
		NavV2Sections = Model.NavV2Sections,
		ActiveSectionId = Model.ActiveSectionId,
		UrlPathPrefix = Model.UrlPathPrefix,
		GithubEditUrl = Model.GithubEditUrl,
		MarkdownUrl = Model.MarkdownUrl,
		BuildType = Model.BuildType,
		HideEditThisPage = Model.Features.DisableGitHubEditLink && Model.BuildType != BuildType.Isolated,
		AllowIndexing = Model.AllowIndexing,
		CanonicalBaseUrl = Model.CanonicalBaseUrl,
		GoogleTagManager = Model.GoogleTagManager,
		Optimizely = Model.Optimizely,
		Features = Model.Features,
		StaticFileContentHashProvider = Model.StaticFileContentHashProvider,
		ReportIssueUrl = Model.ReportIssueUrl,
		Breadcrumbs = Model.Breadcrumbs,
		Htmx = new DefaultHtmxAttributeProvider(GetRootPath(Model.SiteRootPath, Model.UrlPathPrefix)),
		CurrentVersion = Model.CurrentDocument.YamlFrontMatter?.Layout == MarkdownPageLayout.LandingPage ? Model.VersionsConfig.VersioningSystems[0].Current : Model.CurrentVersion,
		AllVersionsUrl = Model.AllVersionsUrl,
		VersioningSystem = Model.VersioningSystem,
		VersionDropdownSerializedModel = JsonSerializer.Serialize(Model.VersionDropdownItems,
			ViewModelSerializerContext.Default.VersionDropDownItemViewModelArray),
		CodexBreadcrumbs = Model.CodexBreadcrumbs is { } cb
			? [.. cb, .. Model.Breadcrumbs.Skip(1).Where(b => !IsDocsetRootUrl(b.Url, cb[^1].Url, Model.UrlPathPrefix)).Select(b => new CodexBreadcrumb(b.NavigationTitle ?? "", b.Url)), .. (Model.Breadcrumbs.Length > 1 && !IsDocsetRootUrl(Model.CurrentNavigationItem.Url, cb[^1].Url, Model.UrlPathPrefix) ? new[] { new CodexBreadcrumb(Model.CurrentNavigationItem.NavigationTitle ?? "", Model.CurrentNavigationItem.Url) } : Array.Empty<CodexBreadcrumb>())]
			: null,
		// Header properties for isolated mode
		HeaderTitle = Model.SiteHeaderTitle ?? Model.DocSetName,
		HeaderVersion = null,
		GitBranch = Model.GitBranch,
		GitCommitShort = Model.GitCommitShort,
		GitRepository = Model.GitRepository,
		GitHubDocsUrl = Model.GitHubDocsUrl,
		GitHubRef = Model.GitHubRef,
	};
	protected override Task ExecuteSectionAsync(string name)
	{
		if (name == GlobalSections.Head)
		{
			@if (Model.CurrentVersion is not null)
			{
				<meta class="elastic" name="product_version" content="@(new HtmlString(Model.CurrentVersion))"/>
				<meta name="DC.identifier" content="@(new HtmlString(Model.CurrentVersion))"/>
			}
			<link rel="alternate" type="text/markdown" href="@(Model.MarkdownUrl)" title="Markdown export"/>
			<script type="application/ld+json">
	    	@(new HtmlString(Model.StructuredBreadcrumbsJson))
	    	</script>
		}
		if (name == GlobalSections.Head && Model.Products is { Count: > 0 })
		{
			var products = string.Join(",", Model.Products.Select(p => p.DisplayName));
			<meta class="elastic" name="product_name" content="@(products)"/>
			<meta name="DC.subject" content="@(products)"/>
		}
		return Task.CompletedTask;
	}
}
<section id="elastic-docs-v3">
	@* This way it's correctly rendered as <h1>text</h1> instead of <h1><p>text</p></h1> *@
	@(new HtmlString(Markdown.ToHtml("# " + Model.TitleRaw)))
	@if (Model.AppliesTo is not null)
	{
		<p class="applies applies-block">
		@await RenderPartialAsync(ApplicableToComponent.Create(new ApplicableToViewModel
		{
			AppliesTo = Model.AppliesTo,
			Inline = false,
			VersionsConfig = Model.VersionsConfig
		}))
		</p>
	}
	@(new HtmlString(Model.MarkdownHtml))
</section>