[i18nIgnore] Add new subpage handling logic

src/components/LeftSidebar/SidebarContent.astro

@@ -1,5 +1,6 @@
 ---
-import { getLanguageFromURL, removeSubpageSegment } from '../../util';
+import { getLanguageFromURL } from '~/util';
+import { isSubPage } from '~/util/isSubPage';
 
 export interface Props {
 	type: TabType;
@@ -44,11 +45,7 @@ const lang = getLanguageFromURL(Astro.url.pathname);
 							<a
 								href={`${Astro.site?.pathname}${lang}/${slug}/`}
 								aria-current={`${currentPageMatch.endsWith(slug) ? 'page' : 'false'}`}
-								data-current-parent={`${
-									removeSubpageSegment(currentPageMatch).endsWith(removeSubpageSegment(slug))
-										? 'true'
-										: 'false'
-								}`}
+								data-current-parent={`${isSubPage(currentPageMatch, slug) ? 'true' : 'false'}`}
 							>
 								<Fragment set:html={text} /> {isFallback && <sup class="fallback">EN</sup>}
 							</a>

src/content/docs/es/core-concepts/sharing-state.mdx

@@ -1,6 +1,8 @@
 ---
 title: Compartiendo Estado
+description: Learn how to share state across components — and frameworks! — with Nano Stores.
 i18nReady: true
+type: recipe
 ---
 
 import UIFrameworkTabs from '~/components/tabs/UIFrameworkTabs.astro'

src/content/docs/es/guides/rss.mdx

@@ -2,6 +2,7 @@
 title: RSS
 description: Introducción a RSS en Astro
 i18nReady: true
+type: recipe
 ---
 
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';

src/content/docs/fr/core-concepts/sharing-state.mdx

@@ -1,6 +1,8 @@
 ---
 title: Partage d'État
+description: Learn how to share state across components — and frameworks! — with Nano Stores.
 i18nReady: true
+type: recipe
 ---
 import UIFrameworkTabs from '~/components/tabs/UIFrameworkTabs.astro'
 import LoopingVideo from '~/components/LoopingVideo.astro'

src/content/docs/fr/guides/rss.mdx

@@ -1,6 +1,7 @@
 ---
 title: Flux RSS
 description: Une introduction aux flux RSS avec Astro.
+type: recipe
 ---
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
 import Since from '~/components/Since.astro'

src/content/docs/ja/guides/rss.mdx

@@ -2,6 +2,7 @@
 title: RSS
 description: AstroのRSS入門
 i18nReady: true
+type: recipe
 ---
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
 

src/content/docs/pt-br/core-concepts/sharing-state.mdx

@@ -1,6 +1,8 @@
 ---
 title: Compartilhamento de Estado
+description: Aprenda como compartilhar estado entre componentes — e frameworks! — com Nano Stores.
 i18nReady: true
+type: recipe
 ---
 import UIFrameworkTabs from '~/components/tabs/UIFrameworkTabs.astro';
 import LoopingVideo from '~/components/LoopingVideo.astro';

src/content/docs/pt-br/guides/rss.mdx

@@ -2,6 +2,7 @@
 title: RSS
 description: Uma introdução a RSS em Astro
 i18nReady: true
+type: recipe
 ---
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
 import Since from '~/components/Since.astro';

src/content/docs/zh-cn/core-concepts/sharing-state.mdx

@@ -1,6 +1,8 @@
 ---
 title: 状态共享
+description: Learn how to share state across components — and frameworks! — with Nano Stores.
 i18nReady: false
+type: recipe
 ---
 import UIFrameworkTabs from '~/components/tabs/UIFrameworkTabs.astro'
 import LoopingVideo from '~/components/LoopingVideo.astro'

src/content/docs/zh-cn/guides/rss.mdx

@@ -1,6 +1,7 @@
 ---
 title: RSS
 description: Astro RSS 介绍
+type: recipe
 ---
 
 Astro 支持为博客和其他内容网站快速自动生成 RSS 摘要。更多关于 RSS 摘要的信息参见 [aboutfeeds.com](https://aboutfeeds.com/)。

src/util.ts

@@ -21,18 +21,3 @@ export const stripLangFromSlug = (slug: CollectionEntry<'docs'>['slug']) =>
 
 /** Get a page’s lang tag from its slug (e.g. `'en/migrate'` => `'en'`). */
 export const getLangFromSlug = (slug: CollectionEntry<'docs'>['slug']) => slug.split('/')[0];
-
-/** Remove the subpage segment of a URL string */
-export function removeSubpageSegment(path: string) {
-	// Include new pages with subpages as part of this regex.
-	const regex = /(?:install|deploy|integrations-guide|tutorial|migrate-to-astro|recipes|cms)\//;
-	const matches = regex.exec(path);
-
-	if (matches) {
-		const matchIndex = matches.index;
-		// Get the first slash index after the main page path segment.
-		const slashIndex = path.slice(matchIndex).indexOf('/') + matchIndex;
-		return path.slice(0, slashIndex);
-	}
-	return path;
-}

src/util/getPageCategory.ts

@@ -16,7 +16,7 @@ const categories = [
  * @param url URL for the current page.
  * @returns The category for the current page as used by Algolia DocSearch to group search results.
  */
-export function getPageCategory(url: URL) {
+export function getPageCategory(url: { pathname: string }) {
 	const langAgnosticPath = url.pathname.replace(/\/\w\w(-\w\w)?\//, '');
 	for (const [path, label] of categories) {
 		if (langAgnosticPath.startsWith(path)) return label;

src/util/isSubPage.ts

@@ -0,0 +1,49 @@
+import type { CollectionEntry } from 'astro:content';
+import { englishPages } from '~/content';
+import { getPageCategory } from './getPageCategory';
+
+/** Remove the sub-page segment of a URL string */
+export function removeSubPageSegment(path: string) {
+	// Include new pages with sub-pages as part of this regex.
+	const regex = /(?:install|deploy|integrations-guide|tutorial|migrate-to-astro|recipes|cms)\//;
+	const matches = regex.exec(path);
+
+	if (matches) {
+		const matchIndex = matches.index;
+		// Get the first slash index after the main page path segment.
+		const slashIndex = path.slice(matchIndex).indexOf('/') + matchIndex;
+		return path.slice(0, slashIndex);
+	}
+	return path;
+}
+
+const typeIndexes: Partial<Record<CollectionEntry<'docs'>['data']['type'], string>> = {
+	recipe: 'recipes',
+};
+
+const categoryIndex: Partial<Record<ReturnType<typeof getPageCategory>, string>> = {
+	'Error Reference': 'reference/error-reference',
+};
+
+/**
+ * Test if `currentPage` is considered a sub-page of `parentSlug`.
+ * @param currentPage The full slug for the current page, e.g. `'en/guides/rss'`
+ * @param parentSlug The language-less slug for the parent to test against e.g. `'guides/content-collections'`
+ */
+export function isSubPage(currentPage: string, parentSlug: string): boolean {
+	// Test 1: do the two pages share a base URL segment?
+	if (removeSubPageSegment(currentPage).endsWith(removeSubPageSegment(parentSlug))) {
+		return true;
+	}
+	// Test 2: is there a known parent page for this page category?
+	const category = getPageCategory({ pathname: '/' + currentPage + '/' });
+	if (categoryIndex[category] === parentSlug) {
+		return true;
+	}
+	// Test 3: is there a known parent page for this page type?
+	const type = englishPages.find(({ slug }) => slug === currentPage)?.data.type;
+	if (type && typeIndexes[type] === parentSlug) {
+		return true;
+	}
+	return false;
+}