Skip to content

Commit 292619f

Browse files
authored
Merge branch 'main' into chris/docsearch
2 parents 83e74af + bc61c63 commit 292619f

35 files changed

Lines changed: 1722 additions & 1807 deletions

File tree

.changeset/plenty-houses-heal.md

Lines changed: 0 additions & 5 deletions
This file was deleted.

.github/workflows/size-limit.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ jobs:
3333
- uses: actions/checkout@v4
3434
- uses: pnpm/action-setup@v3
3535
- name: Run size-limit
36-
uses: andresz1/size-limit-action@dd31dce7dcc72a041fd3e49abf0502b13fc4ce05
36+
uses: andresz1/size-limit-action@v1.8.0
3737
with:
3838
github_token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}
3939
build_script: 'build:examples'

docs/astro.config.mjs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -208,7 +208,7 @@ export default defineConfig({
208208
errorOnFallbackPages: false,
209209
errorOnInconsistentLocale: true,
210210
}),
211-
]
211+
]
212212
: [],
213213
}),
214214
],

docs/package.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,17 @@
1414
"lunaria:build": "lunaria build"
1515
},
1616
"dependencies": {
17-
"@astro-community/astro-embed-youtube": "^0.4.4",
17+
"@astro-community/astro-embed-youtube": "^0.5.2",
1818
"@astrojs/starlight": "workspace:*",
1919
"@lunariajs/core": "^0.1.0",
2020
"@types/culori": "^2.0.0",
21-
"astro": "^4.8.6",
21+
"astro": "^4.10.2",
2222
"culori": "^3.2.0",
2323
"sharp": "^0.32.5"
2424
},
2525
"devDependencies": {
2626
"pa11y-ci": "^3.0.1",
27-
"starlight-links-validator": "^0.7.1",
28-
"start-server-and-test": "^2.0.0"
27+
"starlight-links-validator": "^0.9.0",
28+
"start-server-and-test": "^2.0.4"
2929
}
3030
}

docs/src/content/docs/es/guides/authoring-content.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -360,6 +360,31 @@ Un título opcional del bloque de código se puede establecer con un atributo `t
360360
```
361361
````
362362

363+
## Details
364+
365+
Los details (también conocidos como "revelaciones" o "acordeones") son útiles para ocultar contenido que no es inmediatamente relevante.
366+
Los usuarios pueden hacer clic en un breve resumen para expandir y ver el contenido completo.
367+
368+
Usa el elemento HTML estándar [`<details>`](https://developer.mozilla.org/es/docs/Web/HTML/Element/details) y [`<summary>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary) en tu contenido Markdown para crear un widget de revelación.
369+
370+
Puedes anidar cualquier otra sintaxis de Markdown dentro de un elemento `<details>`.
371+
372+
<details>
373+
<summary>¿Dónde y cuándo es más visible la constelación de Andrómeda?</summary>
374+
375+
La [constelación de Andrómeda](<https://es.wikipedia.org/wiki/Andr%C3%B3meda_(constelaci%C3%B3n)>) es más visible en el cielo nocturno durante el mes de noviembre en latitudes entre `+90°` y `−40°`.
376+
377+
</details>
378+
379+
```md
380+
<details>
381+
<summary>¿Dónde y cuándo es más visible la constelación de Andrómeda?</summary>
382+
383+
La [constelación de Andrómeda](<https://es.wikipedia.org/wiki/Andr%C3%B3meda_(constelaci%C3%B3n)>) es más visible en el cielo nocturno durante el mes de noviembre en latitudes entre `+90°` y `−40°`.
384+
385+
</details>
386+
```
387+
363388
## Otras características comunes de Markdown
364389

365390
Starlight admite todas las demás sintaxis de autoría de Markdown, como listas y tablas. Puedes consultar la [Guía de referencia de Markdown](https://www.markdownguide.org/cheat-sheet/) para obtener una descripción general rápida de todos los elementos de sintaxis de Markdown.

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

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,8 @@ Starlight proporciona soporte incorporado para sitios multilingües, incluidas l
6767

6868
</Steps>
6969

70+
Para escenarios de i18n más avanzados, Starlight también admite la configuración de internacionalizaciónutlizando la [opción `i18n` de Astro](https://docs.astro.build/es/guides/internationalization/#configuración-de-rutas-i18n).
71+
7072
### Usa una raíz de configuración regional
7173

7274
Puedes usar una raíz de configuración regional para servir un idioma sin ningún prefijo i18n en tu ruta. Por ejemplo, si el inglés es tu configuración regional, una ruta de página en inglés se vería como `/about` en lugar de `/en/about`.
@@ -178,7 +180,8 @@ import UIStringsList from '~/components/ui-strings-list.astro';
178180
Además de alojar archivos de contenido traducidos, Starlight te permite traducir las etiquetas de UI predeterminadas (p. ej. el encabezado "En esta página" en la tabla de contenidos) para que tus lectores puedan experimentar tu sitio completamente en el idioma seleccionado.
179181

180182
<LanguagesList startsSentence /> los strings de UI traducidos se proporcionan de
181-
forma predeterminada, y damos la bienvenida a [contribuciones para agregar más idiomas
183+
forma predeterminada, y damos la bienvenida a [contribuciones para agregar más
184+
idiomas
182185
predeterminados](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
183186

184187
Puedes proprocionar traducciones para idiomas adicionales, o editar nuestras etiquetas predeterminadas, a través de la colección de datos `i18n`.
@@ -273,3 +276,17 @@ export const collections = {
273276
```
274277

275278
Aprende más sobre los esquemas de colección de contenido en [“Definir un esquema de colección”](https://docs.astro.build/es/guides/content-collections/#definiendo-un-esquema-de-colección) en la documentación de Astro.
279+
280+
## Acceder al idioma actual
281+
282+
Puedes usar [`Astro.currentLocale`](https://docs.astro.build/es/reference/api-reference/#astrocurrentlocale) para leer el idioma actual en componentes `.astro`.
283+
284+
El siguiente ejemplo lee el idioma actual y lo utiliza para generar un enlace a una página Acerca de en el idioma actual:
285+
286+
```astro
287+
---
288+
// src/components/AboutLink.astro
289+
---
290+
291+
<a href={`/${Astro.currentLocale}/about`}>Acerca</a>
292+
```

docs/src/content/docs/es/reference/configuration.mdx

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,8 @@ type SidebarItem = {
215215
```ts
216216
interface BadgeConfig {
217217
text: string;
218-
variant: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
218+
variant?: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
219+
class?: string;
219220
}
220221
```
221222

@@ -568,3 +569,13 @@ starlight({
568569
```
569570

570571
Consulta la [Referencia de Plugins](/es/reference/plugins/) para obtener detalles sobre cómo crear tus propios plugins.
572+
573+
### `credits`
574+
575+
Habilita la visualización de un enlace “Hecho con Starlight” en el pie de página de tu sitio.
576+
577+
```js
578+
starlight({
579+
credits: true,
580+
});
581+
```

docs/src/content/docs/guides/i18n.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -180,8 +180,9 @@ import UIStringsList from '~/components/ui-strings-list.astro';
180180

181181
In addition to hosting translated content files, Starlight allows you to translate the default UI strings (e.g. the "On this page" heading in the table of contents) so that your readers can experience your site entirely in the selected language.
182182

183-
<LanguagesList startsSentence /> translated UI strings are provided out of the box,
184-
and we welcome [contributions to add more default languages](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
183+
<LanguagesList startsSentence /> translated UI strings are provided out of the
184+
box, and we welcome [contributions to add more default
185+
languages](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
185186

186187
You can provide translations for additional languages you support — or override our default labels — via the `i18n` data collection.
187188

docs/src/content/docs/hi/guides/i18n.mdx

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -178,9 +178,10 @@ import UIStringsList from '~/components/ui-strings-list.astro';
178178

179179
अनुवादित कंटेंट फ़ाइलों को होस्ट करने के अलावा, Starlight आपको डिफ़ॉल्ट UI स्ट्रिंग्स (उदाहरण के लिए कंटेंट तालिका में "इस पेज पर" शीर्षक) का अनुवाद करने की अनुमति देता है ताकि आपके पाठक आपकी साइट को पूरी तरह से चयनित भाषा में अनुभव कर सकें।
180180

181-
<LanguagesList startsSentence /> अनुवादित UI स्ट्रिंग्स सामने से मिलती हैं , और हम
182-
[अधिक डिफ़ॉल्ट भाषाएँ जोड़ने के लिए योगदान](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md)
183-
का स्वागत करते हैं।
181+
<LanguagesList startsSentence /> अनुवादित UI स्ट्रिंग्स सामने से मिलती हैं , और
182+
हम [अधिक डिफ़ॉल्ट भाषाएँ जोड़ने के लिए
183+
योगदान](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md) का
184+
स्वागत करते हैं।
184185

185186
आप `i18n` डेटा संग्रह के माध्यम से उन अतिरिक्त भाषाओं के लिए अनुवाद प्रदान कर सकते हैं जिनका आप समर्थन करते हैं - या हमारे डिफ़ॉल्ट लेबल को ओवरराइड कर सकते हैं।
186187

docs/src/content/docs/ru/guides/i18n.mdx

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -178,9 +178,10 @@ import UIStringsList from '~/components/ui-strings-list.astro';
178178

179179
Кроме размещения переведённых файлов с контентом, Starlight позволяет вам переводить текст интерфейсе (например, заголовок «На этой странице» в оглавлении), чтобы ваши читатели могли полностью погрузиться в ваш сайт на выбранном языке.
180180

181-
<LanguagesList startsSentence /> — все переведённые строки пользовательского интерфейса
182-
на указанных языках предоставляются «из коробки», и мы приветствуем [вклад в добавление
183-
дополнительных языков по умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
181+
<LanguagesList startsSentence /> — все переведённые строки пользовательского
182+
интерфейса на указанных языках предоставляются «из коробки», и мы приветствуем
183+
[вклад в добавление дополнительных языков по
184+
умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
184185

185186
Вы можете добавить переводы для дополнительных языков, которые вы поддерживаете — или переопределить наши стандартные тексты — через коллекцию данных `i18n`.
186187

0 commit comments

Comments
 (0)