From 5b549cb634f51d28bf9a7f92ad0d82c1671e788a Mon Sep 17 00:00:00 2001
From: liruifengv <liruifeng1024@gmail.com>
Date: Fri, 17 Nov 2023 19:20:34 +0800
Subject: [PATCH] Support translating default aside titles (#517)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 .changeset/thick-boxes-fail.md                |  5 ++
 .../__tests__/remark-rehype/asides.test.ts    | 61 ++++++++++++++++++-
 packages/starlight/index.ts                   |  2 +-
 packages/starlight/integrations/asides.ts     | 57 ++++++++++++-----
 packages/starlight/schemas/i18n.ts            |  4 ++
 packages/starlight/translations/ar.json       |  6 +-
 packages/starlight/translations/cs.json       |  6 +-
 packages/starlight/translations/da.json       |  6 +-
 packages/starlight/translations/de.json       |  6 +-
 packages/starlight/translations/en.json       |  6 +-
 packages/starlight/translations/es.json       |  6 +-
 packages/starlight/translations/fa.json       |  6 +-
 packages/starlight/translations/fr.json       |  6 +-
 packages/starlight/translations/gl.json       |  6 +-
 packages/starlight/translations/he.json       |  6 +-
 packages/starlight/translations/id.json       |  6 +-
 packages/starlight/translations/it.json       |  6 +-
 packages/starlight/translations/ja.json       |  6 +-
 packages/starlight/translations/ko.json       |  6 +-
 packages/starlight/translations/nb.json       |  6 +-
 packages/starlight/translations/nl.json       |  6 +-
 packages/starlight/translations/pt.json       |  6 +-
 packages/starlight/translations/ru.json       |  6 +-
 packages/starlight/translations/sv.json       |  6 +-
 packages/starlight/translations/tr.json       |  6 +-
 packages/starlight/translations/uk.json       |  6 +-
 packages/starlight/translations/vi.json       |  6 +-
 packages/starlight/translations/zh-CN.json    |  6 +-
 28 files changed, 227 insertions(+), 40 deletions(-)
 create mode 100644 .changeset/thick-boxes-fail.md

diff --git a/.changeset/thick-boxes-fail.md b/.changeset/thick-boxes-fail.md
new file mode 100644
index 00000000000..18b7aa870b6
--- /dev/null
+++ b/.changeset/thick-boxes-fail.md
@@ -0,0 +1,5 @@
+---
+"@astrojs/starlight": minor
+---
+
+Add i18n support for default aside labels
diff --git a/packages/starlight/__tests__/remark-rehype/asides.test.ts b/packages/starlight/__tests__/remark-rehype/asides.test.ts
index 7d1da5a6781..b3f792166ba 100644
--- a/packages/starlight/__tests__/remark-rehype/asides.test.ts
+++ b/packages/starlight/__tests__/remark-rehype/asides.test.ts
@@ -1,9 +1,29 @@
 import { createMarkdownProcessor } from '@astrojs/markdown-remark';
 import { describe, expect, test } from 'vitest';
 import { starlightAsides } from '../../integrations/asides';
+import { createTranslationSystemFromFs } from '../../utils/translations-fs';
+import { StarlightConfigSchema, type StarlightUserConfig } from '../../utils/user-config';
+
+const starlightConfig = StarlightConfigSchema.parse({
+	title: 'Asides Tests',
+	locales: { en: { label: 'English' }, fr: { label: 'French' } },
+	defaultLocale: 'en',
+} satisfies StarlightUserConfig);
+
+const useTranslations = createTranslationSystemFromFs(
+	starlightConfig,
+	// Using non-existent `_src/` to ignore custom files in this test fixture.
+	{ srcDir: new URL('./_src/', import.meta.url) }
+);
 
 const processor = await createMarkdownProcessor({
-	remarkPlugins: [...starlightAsides()],
+	remarkPlugins: [
+		...starlightAsides({
+			starlightConfig,
+			astroConfig: { root: new URL(import.meta.url), srcDir: new URL('./_src/', import.meta.url) },
+			useTranslations,
+		}),
+	],
 });
 
 test('generates <aside>', async () => {
@@ -23,7 +43,7 @@ describe('default labels', () => {
 		['danger', 'Danger'],
 	])('%s has label %s', async (type, label) => {
 		const res = await processor.render(`
-:::${type}[${label}]
+:::${type}
 Some text
 :::
 `);
@@ -85,3 +105,40 @@ Nested tip.
 `);
 	expect(res.code).toMatchFileSnapshot('./snapshots/nested-asides.html');
 });
+
+describe('translated labels in French', () => {
+	test.each([
+		['note', 'Note'],
+		['tip', 'Astuce'],
+		['caution', 'Attention'],
+		['danger', 'Danger'],
+	])('%s has label %s', async (type, label) => {
+		const res = await processor.render(
+			`
+:::${type}
+Some text
+:::
+`,
+			{ fileURL: new URL('./_src/content/docs/fr/index.md', import.meta.url) }
+		);
+		expect(res.code).includes(`aria-label="${label}"`);
+		expect(res.code).includes(`</svg>${label}</p>`);
+	});
+});
+
+test('runs without locales config', async () => {
+	const processor = await createMarkdownProcessor({
+		remarkPlugins: [
+			...starlightAsides({
+				starlightConfig: { locales: undefined },
+				astroConfig: {
+					root: new URL(import.meta.url),
+					srcDir: new URL('./_src/', import.meta.url),
+				},
+				useTranslations,
+			}),
+		],
+	});
+	const res = await processor.render(':::note\nTest\n::');
+	expect(res.code.includes('aria-label=Note"'));
+});
diff --git a/packages/starlight/index.ts b/packages/starlight/index.ts
index 53ffb2e20cc..93a1e9c743f 100644
--- a/packages/starlight/index.ts
+++ b/packages/starlight/index.ts
@@ -49,7 +49,7 @@ export default function StarlightIntegration(opts: StarlightUserConfig): AstroIn
 						plugins: [vitePluginStarlightUserConfig(userConfig, config)],
 					},
 					markdown: {
-						remarkPlugins: [...starlightAsides()],
+						remarkPlugins: [...starlightAsides({ starlightConfig: userConfig, astroConfig: config, useTranslations })],
 						rehypePlugins: [rehypeRtlCodeSupport()],
 						shikiConfig:
 							// Configure Shiki theme if the user is using the default github-dark theme.
diff --git a/packages/starlight/integrations/asides.ts b/packages/starlight/integrations/asides.ts
index 5d2107ad79e..a97a610ae0a 100644
--- a/packages/starlight/integrations/asides.ts
+++ b/packages/starlight/integrations/asides.ts
@@ -1,10 +1,45 @@
-import type { AstroUserConfig } from 'astro';
+import type { AstroConfig, AstroUserConfig } from 'astro';
 import { h as _h, s as _s, type Properties } from 'hastscript';
 import type { Paragraph as P, Root } from 'mdast';
 import remarkDirective from 'remark-directive';
 import type { Plugin, Transformer } from 'unified';
 import { remove } from 'unist-util-remove';
 import { visit } from 'unist-util-visit';
+import type { StarlightConfig } from '../types';
+import type { createTranslationSystemFromFs } from '../utils/translations-fs';
+
+interface AsidesOptions {
+	starlightConfig: { locales: StarlightConfig['locales'] };
+	astroConfig: { root: AstroConfig['root']; srcDir: AstroConfig['srcDir'] };
+	useTranslations: ReturnType<typeof createTranslationSystemFromFs>;
+}
+
+function pathToLocale(
+	slug: string | undefined,
+	config: AsidesOptions['starlightConfig']
+): string | undefined {
+	const locales = Object.keys(config.locales || {});
+	const baseSegment = slug?.split('/')[0];
+	if (baseSegment && locales.includes(baseSegment)) return baseSegment;
+	return undefined;
+}
+
+/** get current lang from file full path */
+function getLocaleFromPath(
+	unformattedPath: string | undefined,
+	{ starlightConfig, astroConfig }: AsidesOptions
+): string | undefined {
+	const srcDir = new URL(astroConfig.srcDir, astroConfig.root);
+	const docsDir = new URL('content/docs/', srcDir);
+	const path = unformattedPath
+		// Format path to unix style path.
+		?.replace(/\\/g, '/')
+		// Strip docs path leaving only content collection file ID.
+		// Example: /Users/houston/repo/src/content/docs/en/guide.md => en/guide.md
+		.replace(docsDir.pathname, '');
+	const locale = pathToLocale(path, starlightConfig);
+	return locale;
+}
 
 /** Hacky function that generates an mdast HTML tree ready for conversion to HTML by rehype. */
 function h(el: string, attrs: Properties = {}, children: any[] = []): P {
@@ -50,19 +85,11 @@ function s(el: string, attrs: Properties = {}, children: any[] = []): P {
  * </Aside>
  * ```
  */
-function remarkAsides(): Plugin<[], Root> {
+function remarkAsides(options: AsidesOptions): Plugin<[], Root> {
 	type Variant = 'note' | 'tip' | 'caution' | 'danger';
 	const variants = new Set(['note', 'tip', 'caution', 'danger']);
 	const isAsideVariant = (s: string): s is Variant => variants.has(s);
 
-	// TODO: hook these up for i18n once the design for translating strings is ready
-	const defaultTitles = {
-		note: 'Note',
-		tip: 'Tip',
-		caution: 'Caution',
-		danger: 'Danger',
-	};
-
 	const iconPaths = {
 		// Information icon
 		note: [
@@ -95,7 +122,9 @@ function remarkAsides(): Plugin<[], Root> {
 		],
 	};
 
-	const transformer: Transformer<Root> = (tree) => {
+	const transformer: Transformer<Root> = (tree, file) => {
+		const locale = getLocaleFromPath(file.history[0], options);
+		const t = options.useTranslations(locale);
 		visit(tree, (node, index, parent) => {
 			if (!parent || index === null || node.type !== 'containerDirective') {
 				return;
@@ -107,7 +136,7 @@ function remarkAsides(): Plugin<[], Root> {
 			// its children, but we want to pass it as the title prop to <Aside>, so
 			// we iterate over the children, find a directive label, store it for the
 			// title prop, and remove the paragraph from children.
-			let title = defaultTitles[variant];
+			let title = t(`aside.${variant}`);
 			remove(node, (child): boolean | void => {
 				if (child.data?.directiveLabel) {
 					if (
@@ -157,6 +186,6 @@ function remarkAsides(): Plugin<[], Root> {
 
 type RemarkPlugins = NonNullable<NonNullable<AstroUserConfig['markdown']>['remarkPlugins']>;
 
-export function starlightAsides(): RemarkPlugins {
-	return [remarkDirective, remarkAsides()];
+export function starlightAsides(options: AsidesOptions): RemarkPlugins {
+	return [remarkDirective, remarkAsides(options)];
 }
diff --git a/packages/starlight/schemas/i18n.ts b/packages/starlight/schemas/i18n.ts
index eb26304d055..d1cd39750b8 100644
--- a/packages/starlight/schemas/i18n.ts
+++ b/packages/starlight/schemas/i18n.ts
@@ -89,6 +89,10 @@ function starlightI18nSchema() {
 				.describe('Label shown on the “next page” pagination arrow in the page footer.'),
 
 			'404.text': z.string().describe('Text shown on Starlight’s default 404 page'),
+			'aside.tip': z.string().describe('Text shown on the tip aside variant'),
+			'aside.note': z.string().describe('Text shown on the note aside variant'),
+			'aside.caution': z.string().describe('Text shown on the warning aside variant'),
+			'aside.danger': z.string().describe('Text shown on the danger aside variant'),
 		})
 		.partial();
 }
diff --git a/packages/starlight/translations/ar.json b/packages/starlight/translations/ar.json
index 15600f0dfdd..64b03ff7bce 100644
--- a/packages/starlight/translations/ar.json
+++ b/packages/starlight/translations/ar.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "اخر تحديث:",
   "page.previousLink": "السابق",
   "page.nextLink": "التالي",
-  "404.text": "الصفحة غير موجودة. تأكد من الرابط أو ابحث بإستعمال شريط البحث."
+  "404.text": "الصفحة غير موجودة. تأكد من الرابط أو ابحث بإستعمال شريط البحث.",
+  "aside.note": "ملحوظة",
+  "aside.tip": "نصيحة",
+  "aside.caution": "تنبيه",
+  "aside.danger": "تحذير"
 }
diff --git a/packages/starlight/translations/cs.json b/packages/starlight/translations/cs.json
index d90eeda5fc1..aaca70a7790 100644
--- a/packages/starlight/translations/cs.json
+++ b/packages/starlight/translations/cs.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Poslední aktualizace:",
   "page.previousLink": "Předchozí",
   "page.nextLink": "Další",
-  "404.text": "Stránka nenalezena. Zkontrolujte adresu URL nebo zkuste použít vyhledávací pole."
+  "404.text": "Stránka nenalezena. Zkontrolujte adresu URL nebo zkuste použít vyhledávací pole.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/da.json b/packages/starlight/translations/da.json
index 14903f0a746..b562c0fd19d 100644
--- a/packages/starlight/translations/da.json
+++ b/packages/starlight/translations/da.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Sidst opdateret:",
   "page.previousLink": "Forrige",
   "page.nextLink": "Næste",
-  "404.text": "Siden er ikke fundet. Tjek din URL eller prøv søgelinjen."
+  "404.text": "Siden er ikke fundet. Tjek din URL eller prøv søgelinjen.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/de.json b/packages/starlight/translations/de.json
index da82f791541..9a13711ce53 100644
--- a/packages/starlight/translations/de.json
+++ b/packages/starlight/translations/de.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Zuletzt bearbeitet:",
   "page.previousLink": "Vorherige Seite",
   "page.nextLink": "Nächste Seite",
-  "404.text": "Seite nicht gefunden. Überprüfe die URL oder nutze die Suchleiste."
+  "404.text": "Seite nicht gefunden. Überprüfe die URL oder nutze die Suchleiste.",
+  "aside.note": "Hinweis",
+  "aside.tip": "Tipp",
+  "aside.caution": "Achtung",
+  "aside.danger": "Gefahr"
 }
diff --git a/packages/starlight/translations/en.json b/packages/starlight/translations/en.json
index 5bc396b2c87..5c170f8c0bd 100644
--- a/packages/starlight/translations/en.json
+++ b/packages/starlight/translations/en.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Last updated:",
   "page.previousLink": "Previous",
   "page.nextLink": "Next",
-  "404.text": "Page not found. Check the URL or try using the search bar."
+  "404.text": "Page not found. Check the URL or try using the search bar.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/es.json b/packages/starlight/translations/es.json
index 5cf3200abf7..fd59428b762 100644
--- a/packages/starlight/translations/es.json
+++ b/packages/starlight/translations/es.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Última actualización:",
   "page.previousLink": "Página anterior",
   "page.nextLink": "Siguiente página",
-  "404.text": "Página no encontrada. Verifica la URL o intenta usar la barra de búsqueda."
+  "404.text": "Página no encontrada. Verifica la URL o intenta usar la barra de búsqueda.",
+  "aside.note": "Nota",
+  "aside.tip": "Consejo",
+  "aside.caution": "Precaución",
+  "aside.danger": "Peligro"
 }
diff --git a/packages/starlight/translations/fa.json b/packages/starlight/translations/fa.json
index 1e83fed9833..30026dbf4df 100644
--- a/packages/starlight/translations/fa.json
+++ b/packages/starlight/translations/fa.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "آخرین به روز رسانی:",
   "page.previousLink": "قبلی",
   "page.nextLink": "بعدی",
-  "404.text": "صفحه یافت نشد. لطفاً URL را بررسی کنید یا از جستجو استفاده نمایید."
+  "404.text": "صفحه یافت نشد. لطفاً URL را بررسی کنید یا از جستجو استفاده نمایید.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/fr.json b/packages/starlight/translations/fr.json
index bc947080e02..f7acf60c92c 100644
--- a/packages/starlight/translations/fr.json
+++ b/packages/starlight/translations/fr.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Dernière mise à jour :",
   "page.previousLink": "Précédent",
   "page.nextLink": "Suivant",
-  "404.text": "Page non trouvée. Vérifiez l’URL ou essayez d’utiliser la barre de recherche."
+  "404.text": "Page non trouvée. Vérifiez l’URL ou essayez d’utiliser la barre de recherche.",
+  "aside.note": "Note",
+  "aside.tip": "Astuce",
+  "aside.caution": "Attention",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/gl.json b/packages/starlight/translations/gl.json
index c184338d027..808b18f28e3 100644
--- a/packages/starlight/translations/gl.json
+++ b/packages/starlight/translations/gl.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Última actualización:",
   "page.previousLink": "Anterior",
   "page.nextLink": "Seguinte",
-  "404.text": "Paxina non atopada. Comproba a URL ou intenta usar a barra de busca."
+  "404.text": "Paxina non atopada. Comproba a URL ou intenta usar a barra de busca.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/he.json b/packages/starlight/translations/he.json
index e09ccec2ec6..e7152b262c7 100644
--- a/packages/starlight/translations/he.json
+++ b/packages/starlight/translations/he.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "עדכון אחרון:",
   "page.previousLink": "הקודם",
   "page.nextLink": "הבא",
-  "404.text": "הדף לא נמצא. אנא בדקו את כתובת האתר או נסו להשתמש בסרגל החיפוש."
+  "404.text": "הדף לא נמצא. אנא בדקו את כתובת האתר או נסו להשתמש בסרגל החיפוש.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/id.json b/packages/starlight/translations/id.json
index ebd0cf36363..4c57efbf768 100644
--- a/packages/starlight/translations/id.json
+++ b/packages/starlight/translations/id.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Terakhir diperbaharui:",
   "page.previousLink": "Sebelumnya",
   "page.nextLink": "Selanjutnya",
-  "404.text": "Halaman tidak ditemukan. Cek kembali kolom URL atau gunakan fitur pencarian."
+  "404.text": "Halaman tidak ditemukan. Cek kembali kolom URL atau gunakan fitur pencarian.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/it.json b/packages/starlight/translations/it.json
index f0657e89de1..4b41c78b472 100644
--- a/packages/starlight/translations/it.json
+++ b/packages/starlight/translations/it.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Ultimo aggiornamento:",
   "page.previousLink": "Indietro",
   "page.nextLink": "Avanti",
-  "404.text": "Pagina non trovata. Verifica l'URL o prova a utilizzare la barra di ricerca."
+  "404.text": "Pagina non trovata. Verifica l'URL o prova a utilizzare la barra di ricerca.",
+  "aside.note": "Nota",
+  "aside.tip": "Consiglio",
+  "aside.caution": "Attenzione",
+  "aside.danger": "Pericolo"
 }
diff --git a/packages/starlight/translations/ja.json b/packages/starlight/translations/ja.json
index 1f199b482cf..f39e219efb6 100644
--- a/packages/starlight/translations/ja.json
+++ b/packages/starlight/translations/ja.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "最終更新日:",
   "page.previousLink": "前へ",
   "page.nextLink": "次へ",
-  "404.text": "ページが見つかりません。 URL を確認するか、検索バーを使用してみてください。"
+  "404.text": "ページが見つかりません。 URL を確認するか、検索バーを使用してみてください。",
+  "aside.note": "ノート",
+  "aside.tip": "ヒント",
+  "aside.caution": "注意",
+  "aside.danger": "危険"
 }
diff --git a/packages/starlight/translations/ko.json b/packages/starlight/translations/ko.json
index 5d4c2b27712..a1baf5dfa08 100644
--- a/packages/starlight/translations/ko.json
+++ b/packages/starlight/translations/ko.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "최종 수정:",
   "page.previousLink": "이전 페이지",
   "page.nextLink": "다음 페이지",
-  "404.text": "페이지를 찾을 수 없습니다. URL을 확인하거나 검색창을 사용해보세요."
+  "404.text": "페이지를 찾을 수 없습니다. URL을 확인하거나 검색창을 사용해보세요.",
+  "aside.note": "노트",
+  "aside.tip": "팁",
+  "aside.caution": "주의",
+  "aside.danger": "위험"
 }
diff --git a/packages/starlight/translations/nb.json b/packages/starlight/translations/nb.json
index e6abae70ceb..458062f4fd8 100644
--- a/packages/starlight/translations/nb.json
+++ b/packages/starlight/translations/nb.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Sist oppdatert:",
   "page.previousLink": "Forrige",
   "page.nextLink": "Neste",
-  "404.text": "Siden ble ikke funnet. Sjekk URL-en eller prøv å bruke søkefeltet."
+  "404.text": "Siden ble ikke funnet. Sjekk URL-en eller prøv å bruke søkefeltet.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/nl.json b/packages/starlight/translations/nl.json
index 6e485fb6e0d..d5b296aeea4 100644
--- a/packages/starlight/translations/nl.json
+++ b/packages/starlight/translations/nl.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Laatst bewerkt:",
   "page.previousLink": "Vorige",
   "page.nextLink": "Volgende",
-  "404.text": "Pagina niet gevonden. Controleer de URL of probeer de zoekbalk."
+  "404.text": "Pagina niet gevonden. Controleer de URL of probeer de zoekbalk.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/pt.json b/packages/starlight/translations/pt.json
index 2b3790351e9..04e05af49bd 100644
--- a/packages/starlight/translations/pt.json
+++ b/packages/starlight/translations/pt.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Última atualização:",
   "page.previousLink": "Anterior",
   "page.nextLink": "Próximo",
-  "404.text": "Página não encontrada. Verifique o URL ou tente usar a barra de pesquisa."
+  "404.text": "Página não encontrada. Verifique o URL ou tente usar a barra de pesquisa.",
+  "aside.note": "Nota",
+  "aside.tip": "Dica",
+  "aside.caution": "Cuidado",
+  "aside.danger": "Perigo"
 }
diff --git a/packages/starlight/translations/ru.json b/packages/starlight/translations/ru.json
index 5d99e44e234..cd39af1fcde 100644
--- a/packages/starlight/translations/ru.json
+++ b/packages/starlight/translations/ru.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Последнее обновление:",
   "page.previousLink": "Предыдущая",
   "page.nextLink": "Следующая",
-  "404.text": "Страница не найдена. Проверьтье  URL или используйте поиск по сайту"
+  "404.text": "Страница не найдена. Проверьтье  URL или используйте поиск по сайту",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/sv.json b/packages/starlight/translations/sv.json
index ef7c2d35b34..6508667464d 100644
--- a/packages/starlight/translations/sv.json
+++ b/packages/starlight/translations/sv.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Senast uppdaterad:",
   "page.previousLink": "Föregående",
   "page.nextLink": "Nästa",
-  "404.text": "Sidan hittades inte. Kontrollera URL:n eller testa att använda sökfältet."
+  "404.text": "Sidan hittades inte. Kontrollera URL:n eller testa att använda sökfältet.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/tr.json b/packages/starlight/translations/tr.json
index d288a163a24..bd40166977c 100644
--- a/packages/starlight/translations/tr.json
+++ b/packages/starlight/translations/tr.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Son güncelleme:",
   "page.previousLink": "Önceki",
   "page.nextLink": "Sonraki",
-  "404.text": "Sayfa bulunamadı. URL'i kontrol edin ya da arama çubuğunu kullanmayı deneyin."
+  "404.text": "Sayfa bulunamadı. URL'i kontrol edin ya da arama çubuğunu kullanmayı deneyin.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/uk.json b/packages/starlight/translations/uk.json
index 8d21a834788..7a601b81381 100644
--- a/packages/starlight/translations/uk.json
+++ b/packages/starlight/translations/uk.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Останнє оновлення:",
   "page.previousLink": "Попередня",
   "page.nextLink": "Наступна",
-  "404.text": "Сторінку не знайдено. Перевірте URL-адресу або спробуйте скористатися рядком пошуку."
+  "404.text": "Сторінку не знайдено. Перевірте URL-адресу або спробуйте скористатися рядком пошуку.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/vi.json b/packages/starlight/translations/vi.json
index 972a660a242..c1c2ae37179 100644
--- a/packages/starlight/translations/vi.json
+++ b/packages/starlight/translations/vi.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "Cập nhật lần cuối:",
   "page.previousLink": "Tiếp",
   "page.nextLink": "Trước",
-  "404.text": "Không tìm thấy trang. Kiểm tra URL hoặc thử sử dụng thanh tìm kiếm."
+  "404.text": "Không tìm thấy trang. Kiểm tra URL hoặc thử sử dụng thanh tìm kiếm.",
+  "aside.note": "Note",
+  "aside.tip": "Tip",
+  "aside.caution": "Caution",
+  "aside.danger": "Danger"
 }
diff --git a/packages/starlight/translations/zh-CN.json b/packages/starlight/translations/zh-CN.json
index 367f63fc6b9..9776faea261 100644
--- a/packages/starlight/translations/zh-CN.json
+++ b/packages/starlight/translations/zh-CN.json
@@ -18,5 +18,9 @@
   "page.lastUpdated": "最近更新：",
   "page.previousLink": "上一页",
   "page.nextLink": "下一页",
-  "404.text": "页面未找到。检查 URL 或尝试使用搜索栏。"
+  "404.text": "页面未找到。检查 URL 或尝试使用搜索栏。",
+  "aside.note": "注意",
+  "aside.tip": "提示",
+  "aside.caution": "警告",
+  "aside.danger": "危险"
 }