@astrojs/starlight 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @astrojs/starlight
 
+## 0.3.1
+
+### Patch Changes
+
+- [#257](https://github.com/withastro/starlight/pull/257) [`0502327`](https://github.com/withastro/starlight/commit/050232770c8a2d22f317def8e734e4abb36387c6) Thanks [@JosefJezek](https://github.com/JosefJezek)! - Add Czech language support
+
+- [#261](https://github.com/withastro/starlight/pull/261) [`2062b9e`](https://github.com/withastro/starlight/commit/2062b9e21695b5dc3f116731dbfdf609e495018c) Thanks [@delucis](https://github.com/delucis)! - Fix autogenerated navigation for pages using fallback content
+
 ## 0.3.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrojs/starlight",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Build beautiful, high-performance documentation websites with Astro",
   "keywords": [
     "docs",

package/translations/cs.json

@@ -0,0 +1,22 @@
+{
+  "skipLink.label": "Přeskočit na obsah",
+  "search.label": "Hledat",
+  "search.shortcutLabel": "(Vyhledejte stisknutím /)",
+  "search.cancelLabel": "Zrušit",
+  "search.devWarning": "Vyhledávání je dostupné pouze v produkčních sestaveních. \nZkuste sestavit a zobrazit náhled webu a otestovat jej lokálně.",
+  "themeSelect.accessibleLabel": "Vyberte motiv",
+  "themeSelect.dark": "Tmavý",
+  "themeSelect.light": "Světlý",
+  "themeSelect.auto": "Auto",
+  "languageSelect.accessibleLabel": "Vyberte jazyk",
+  "menuButton.accessibleLabel": "Nabídka",
+  "sidebarNav.accessibleLabel": "Hlavní",
+  "tableOfContents.onThisPage": "Na této stránce",
+  "tableOfContents.overview": "Přehled",
+  "i18n.untranslatedContent": "Tento obsah zatím není dostupný ve vašem jazyce.",
+  "page.editLink": "Upravit stránku",
+  "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."
+}

package/translations/index.ts

@@ -1,4 +1,5 @@
 import { builtinI18nSchema } from '../schemas/i18n';
+import cs from './cs.json';
 import en from './en.json';
 import es from './es.json';
 import de from './de.json';
@@ -10,5 +11,5 @@ import it from './it.json';
 const { parse } = builtinI18nSchema();
 
 export default Object.fromEntries(
-  Object.entries({ en, es, de, ja, pt, fr, it }).map(([key, dict]) => [key, parse(dict)])
+  Object.entries({ cs, en, es, de, ja, pt, fr, it }).map(([key, dict]) => [key, parse(dict)])
 );

package/utils/navigation.ts

@@ -69,9 +69,9 @@ function groupFromAutogenerateConfig(
   const dirDocs = routes.filter(
     (doc) =>
       // Match against `foo.md` or `foo/index.md`.
-      stripExtension(doc.entry.id) === localeDir ||
+      stripExtension(doc.id) === localeDir ||
       // Match against `foo/anything/else.md`.
-      doc.entry.id.startsWith(localeDir + '/')
+      doc.id.startsWith(localeDir + '/')
   );
   const tree = treeify(dirDocs, localeDir);
   return {
@@ -136,7 +136,7 @@ function getBreadcrumbs(path: string, baseDir: string): string[] {
 function treeify(routes: Route[], baseDir: string): Dir {
   const treeRoot: Dir = {};
   routes.forEach((doc) => {
-    const breadcrumbs = getBreadcrumbs(doc.entry.id, baseDir);
+    const breadcrumbs = getBreadcrumbs(doc.id, baseDir);
 
     // Walk down the route’s path to generate the tree.
     let currentDir = treeRoot;

package/utils/routing.ts

@@ -3,6 +3,7 @@ import { CollectionEntry, getCollection } from 'astro:content';
 import config from 'virtual:starlight/user-config';
 import {
   LocaleData,
+  localizedId,
   localizedSlug,
   slugToLocaleData,
   slugToParam,
@@ -16,6 +17,7 @@ export interface Route extends LocaleData {
   entry: StarlightDocsEntry;
   entryMeta: LocaleData;
   slug: string;
+  id: string;
   isFallback?: true;
   [key: string]: unknown;
 }
@@ -41,6 +43,7 @@ function getRoutes(): Route[] {
   const routes: Route[] = docs.map((entry) => ({
     entry,
     slug: entry.slug,
+    id: entry.id,
     entryMeta: slugToLocaleData(entry.slug),
     ...slugToLocaleData(entry.slug),
   }));
@@ -61,11 +64,13 @@ function getRoutes(): Route[] {
       const localeDocs = getLocaleDocs(locale);
       for (const fallback of defaultLocaleDocs) {
         const slug = localizedSlug(fallback.slug, locale);
+        const id = localizedId(fallback.id, locale);
         const doesNotNeedFallback = localeDocs.some((doc) => doc.slug === slug);
         if (doesNotNeedFallback) continue;
         routes.push({
           entry: fallback,
           slug,
+          id,
           isFallback: true,
           lang: localeConfig.lang || 'en',
           locale,

package/utils/slugs.ts

@@ -90,3 +90,24 @@ export function localizedSlug(
   }
   return slug ? locale + '/' + slug : locale;
 }
+
+/**
+ * Convert a collection entry ID to a different locale.
+ * For example, passing an ID of `en/home.md` and a locale of `fr` results in `fr/home.md`.
+ * An undefined locale is treated as the root locale, resulting in `home.md`.
+ * @param id A collection entry ID
+ * @param locale The target locale
+ * @example
+ * localizedSlug('en/home.md', 'fr')       // => 'fr/home.md'
+ * localizedSlug('en/home.md', undefined)  // => 'home.md'
+ */
+export function localizedId(id: string, locale: string | undefined): string {
+  const idLocale = slugToLocale(id);
+  if (idLocale) {
+    return id.replace(idLocale + '/', locale ? locale + '/' : '');
+  } else if (locale) {
+    return locale + '/' + id;
+  } else {
+    return id;
+  }
+}