Merge branch 'main' into 5.14.0

Author: sarah11918

src/content/docs/es/reference/publish-to-npm.mdx

@@ -3,6 +3,7 @@ title: Publica en NPM
 description: Aprende a publicar componentes de Astro en NPM
 i18nReady: true
 ---
+import { Steps } from '@astrojs/starlight/components';
 import { FileTree } from '@astrojs/starlight/components';
 
 ¿Construyendo un nuevo componente Astro? **¡Publícalo en [npm](https://npmjs.com/)!**
@@ -234,17 +235,21 @@ Astro actualmente no incluye un test runner. Esto es algo que nos gustaría abor
 
 Mientras tanto, nuestra recomendación actual para las pruebas es:
 
+<Steps>
 1. Agrega un directorio `fixtures` de prueba a su directorio `demo/src/pages`.
+
 2. Agrega una nueva página para cada prueba que desee ejecutar.
+
 3. Cada página debe incluir un uso distinto de los componentes que te gustaría probar.
-4. Ejecuta `astro build` para construir tus fixtures, luego compara los resultados en el directorio `dist/__fixtures__/` con los resultados esperados.
 
-<FileTree>
-- my-project/demo/src/pages/\_\_fixtures\_\_/
-  - test-name-01.astro
-  - test-name-02.astro
-  - test-name-03.astro
-</FileTree>
+4. Ejecuta `astro build` para construir tus fixtures, luego compara los resultados en el directorio `dist/__fixtures__/` con los resultados esperados.
+   <FileTree>
+   - my-project/demo/src/pages/\_\_fixtures\_\_/
+     - test-name-01.astro
+     - test-name-02.astro
+     - test-name-03.astro
+   </FileTree>
+</Steps>
 
 ## Publicando tu componente
 
@@ -274,19 +279,24 @@ La biblioteca de integraciones lee los datos `name`, `description`, `repository`
 ¿Necesitas anular la información que nuestra biblioteca lee de NPM? ¡No hay problema! [Crea una issue](https://github.com/withastro/astro.build/issues/new/choose) con la información actualizada y nos aseguraremos de que el `nombre`, la `descripción` o la `página de inicio` personalizados sean utilizados en su lugar.
 :::
 
-### Colecciones
+### Categorías
 
-Además de la palabra clave requerida `astro-component` o `withastro`, también se utilizan otras palabras clave especiales para organizar automáticamente los paquetes. Incluir cualquiera de las palabras clave a continuación agregará tu integración a la colección en nuestra biblioteca de integraciones.
+Además de la palabra clave requerida `astro-component` o `withastro`, también se utilizan otras palabras clave especiales para organizar automáticamente los paquetes. Incluir cualquiera de las palabras clave a continuación agregará tu integración a la categoría en nuestra biblioteca de integraciones.
 
-| colección         | palabras clave                               |
-| ----------------- | -------------------------------------------- |
-| Accesibilidad     | `a11y`, `accessibility`                      |
-| Adaptadores       | `astro-adapter`                              |
-| Analíticas        | `analytics`                                  |
-| CSS + UI          | `css`, `ui`, `icon`, `icons`, `renderer`     |
-| Frameworks        | `renderer`                                   |
-| Performance + SEO | `performance`, `perf`, `seo`, `optimization` |
+| categoría                 | palabras clave                               |
+| ------------------------- | -------------------------------------------- |
+| Accesibilidad             | `a11y`, `accessibility`                      |
+| Adaptadores               | `astro-adapter`                              |
+| Analíticas                | `analytics`                                  |
+| CSS + UI                  | `css`, `ui`, `icon`, `icons`, `renderer`     |
+| Frameworks                | `renderer`                                   |
+| Cargadores de contenido   | `astro-loader`                               |
+| Imágenes + Medios         | `image`, `images`, `media`                   |
+| Rendimiento + SEO         | `performance`, `perf`, `seo`, `optimization` |
+| Barra de herramientas     | `devtools`, `dev-overlay`, `dev-toolbar`     |
+| Utilidades                | `tooling`, `utils`, `utility`                |
 
+Los paquetes que no incluyan ninguna palabra clave que coincida con una categoría se mostrarán como `Uncategorized`.
 
 ## Comparte
 

src/content/docs/es/upgrade-astro.mdx

@@ -12,6 +12,7 @@ import Version from '~/components/Version.astro';
 Esta guía cubre como actualizar tu versión de Astro y las dependencias relacionadas, cómo aprender qué ha cambiado de una versión a otra y cómo entender el sistema de versiones de Astro y sus correspondientes actualizaciones de documentación.
 
 ## ¿Qué ha cambiado?
+
 La última versión de Astro es <Version pkgName="astro"/>
 
 Puedes encontrar una lista detallada de todos los cambios en el [historial de cambios de Astro](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) e instrucciones importantes para actualizar a cada nueva [versión mayor](#cambios-mayores) en nuestras [guías de actualización](#guías-de-actualización).
@@ -48,20 +49,20 @@ Para actualizar Astro y sus dependencias a sus últimas versiones manualmente, u
 <PackageManagerTabs>
   <Fragment slot="npm">
   ```shell
-  # Ejemplo: actualiza Astro con las integraciones de React y Tailwind
-  npm install astro@latest @astrojs/react@latest @astrojs/tailwind@latest
+  # Ejemplo: actualiza Astro con las integraciones de React y Partytown
+  npm install astro@latest @astrojs/react@latest @astrojs/partytown@latest
   ```
   </Fragment>
   <Fragment slot="pnpm">
   ```shell
-  # Ejemplo: actualiza Astro con las integraciones de React y Tailwind
-  pnpm add astro@latest @astrojs/react@latest @astrojs/tailwind@latest
+  # Ejemplo: actualiza Astro con las integraciones de React y Partytown
+  pnpm add astro@latest @astrojs/react@latest @astrojs/partytown@latest
   ```
   </Fragment>
   <Fragment slot="yarn">
   ```shell
-  # Ejemplo: actualiza Astro con las integraciones de React y Tailwind
-  yarn add astro@latest @astrojs/react@latest @astrojs/tailwind@latest
+  # Ejemplo: actualiza Astro con las integraciones de React y Partytown
+  yarn add astro@latest @astrojs/react@latest @astrojs/partytown@latest
   ```
   </Fragment>
 </PackageManagerTabs>
@@ -118,7 +119,6 @@ La documentación para las versiones antiguas de Astro no es mantenida, pero est
 - [versión v3.6.3 no mantenida](https://docs-git-v3-docs-unmaintained-astrodotbuild.vercel.app/)
 - [versión v2.10.15 no mantenida](https://deploy-preview-4405--astro-docs-2.netlify.app/en/getting-started/)
 
-
 ## Versionado semántico
 
 Astro intenta seguir tanto como pueda un [versionado semántico](https://semver.org/), el cuál es un grupo de reglas de desarrollo usados para determinar cómo asignar una versión numérica a un lanzamiento. El versionado semántico sigue un patrón predecible para informar a los usuarios el tipo de cambios que pueden esperar de una versión a la otra. 
@@ -143,7 +143,6 @@ Los parches pueden ser lanzados por razones como:
 
 Los parches incluyen también la **mayoría de correciones de errores**, incluso en casos donde los usuarios abusaban de un comportamiento no deseado.
 
-
 ### Cambios menores
 
 Los cambios menores principalmente introducen nuevas características y mejoras que podrías probar, pero sin cambios en tu código. Algunas características existentes podrían ser **obsoletas** (marcadas para eliminación en una versión futura mientras aún están disponibles en la versión actual) en una versión menor, dándote la oportunidad de prepararlas para una eliminación eventual.

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

@@ -318,6 +318,8 @@ if (!isLoggedIn(cookie)) {
 ---
 ```
 
+Étant donné qu'Astro utilise le [streaming HTML](/fr/guides/on-demand-rendering/#streaming-html) dans le rendu à la demande, les redirections doivent être effectuées au niveau de la page, et non à l'intérieur des composants enfants.
+
 ## Réécritures
 
 <p><Since v="4.13.0" /></p>

src/content/docs/ko/guides/integrations-guide/alpinejs.mdx

@@ -8,7 +8,8 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int
 category: renderer
 i18nReady: true
 ---
-import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
+import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
+import Since from '~/components/Since.astro';
 
 이 **[Astro 통합][astro-integration]은** 프로젝트에 [Alpine.js](https://alpinejs.dev/)를 추가하므로 페이지 어디에서나 Alpine.js를 사용할 수 있습니다.
 
@@ -96,6 +97,12 @@ export default defineConfig({
 
 ### `entrypoint`
 
+<p>
+
+**타입:** `string`<br />
+<Since v="0.4.0" pkg="@astrojs/alpinejs" />
+</p>
+
 `entrypoint` 옵션을 루트 상대 가져오기 지정자 (예: `entrypoint: "/src/entrypoint"`)로 설정하여 Alpine을 확장할 수 있습니다.
 
 이 파일의 기본 내보내기는 시작하기 전에 Alpine 인스턴스를 허용하는 함수여야 합니다. 이를 통해 고급 사용 사례에 맞게 사용자 정의 지시어, 플러그인, 기타 맞춤 설정을 사용할 수 있습니다.

src/content/docs/ko/guides/integrations-guide/db.mdx

@@ -129,6 +129,11 @@ export default defineConfig({
 
 ### `columns`
 
+<p>
+
+**타입:** `ColumnsConfig`
+</p>
+
 테이블 열은 `columns` 객체를 사용하여 구성됩니다.
 
 ```ts
@@ -184,6 +189,11 @@ type UserTableInferInsert = {
 
 ### `indexes`
 
+<p>
+
+**타입:** `{ on: string | string[]; unique?: boolean | undefined; name?: string | undefined; }[]`
+</p>
+
 테이블 인덱스는 특정 열 또는 열 조합에 대한 조회 속도를 향상시키는 데 사용됩니다. `indexes` 속성은 인덱스를 생성할 열을 지정하는 구성 객체의 배열을 값으로 전달받습니다.
 
 ```ts title="db/config.ts" {9-11}
@@ -205,12 +215,17 @@ const Comment = defineTable({
 
 각 인덱스에 대해 다음 구성 옵션을 사용할 수 있습니다.
 
-- `on`: `string | string[]` - 인덱싱할 단일 열 또는 열 이름 배열입니다.
-- `unique`: `boolean` - 인덱스가 생성된 열 전체에 고유한 값을 적용하려면 `true`로 설정합니다.
-- `name`: `string` (선택 사항) - 고유 인덱스의 사용자 정의 이름입니다. 이는 색인화되는 테이블 및 열 이름을 기반으로 Astro에서 생성된 이름을 재정의합니다 (예: `Comment_authorId_published_idx`). 사용자 정의 이름은 전역적이므로 인덱스 이름이 테이블 간에 충돌하지 않는지 확인하세요.
+- `on` - 인덱싱할 단일 열 또는 열 이름 배열입니다.
+- `unique` (선택 사항) - 인덱스가 생성된 열 전체에 고유한 값을 적용하려면 `true`로 설정합니다.
+- `name` (선택 사항) - 고유 인덱스의 사용자 정의 이름입니다. 이는 색인화되는 테이블 및 열 이름을 기반으로 Astro에서 생성된 이름을 재정의합니다 (예: `Comment_authorId_published_idx`). 사용자 정의 이름은 전역적이므로 인덱스 이름이 테이블 간에 충돌하지 않는지 확인하세요.
 
 ### `foreignKeys`
 
+<p>
+
+**타입:** `{ columns: string | string[]; references: () => Column | Column[]; }[]`
+</p>
+
 :::tip
 
 `foreignKeys`는 여러 테이블 열을 연결하기 위한 고급 API입니다. 단일 열만 참조해야 하는 경우 [열 `references` 속성](#columns)을 사용하세요.
@@ -246,8 +261,8 @@ const Comment = defineTable({
 
 각 외래 키 구성 객체는 다음 속성을 허용합니다.
 
-- `columns`: `string[]` - 참조된 테이블과 관련된 열 이름의 배열입니다.
-- `references`: `() => Column[]` - 참조된 테이블에서 열 배열을 반환하는 함수입니다.
+- `columns` - 참조된 테이블과 관련된 단일 열 또는 열 이름의 배열입니다.
+- `references` - 참조된 테이블에서 단일 열 또는 열 배열을 반환하는 함수입니다.
 
 ## Astro DB CLI 참조
 
@@ -288,6 +303,12 @@ Astro DB에는 로컬 및 libSQL 호환 데이터베이스와 상호 작용하
 
 ### `isDbError()`
 
+<p>
+
+**타입:** `(err: unknown) => boolean`<br />
+<Since v="0.9.1" pkg="@astrojs/db" />
+</p>
+
 `isDbError()` 함수는 오류가 libSQL 데이터베이스 예외인지 확인합니다. 여기에는 참조 사용 시 외래 키 제약 조건 오류가 포함되거나 데이터 삽입 시 필드 누락이 포함될 수 있습니다. `isDbError()`를 try / catch 블록과 결합하여 애플리케이션의 데이터베이스 오류를 처리할 수 있습니다.
 
 ```ts title="src/pages/api/comment/[id].ts" "idDbError"

src/content/docs/ko/guides/integrations-guide/markdoc.mdx

@@ -8,10 +8,10 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int
 category: other
 i18nReady: true
 ---
-import { FileTree } from '@astrojs/starlight/components';
+import { FileTree, Steps } from '@astrojs/starlight/components';
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
-import { Steps } from '@astrojs/starlight/components';
 import ReadMore from '~/components/ReadMore.astro';
+import Since from '~/components/Since.astro';
 
 이 **[Astro 통합][astro-integration]을** 통해 [Markdoc](https://markdoc.dev/)을 사용하여 컴포넌트, 페이지 및 콘텐츠 컬렉션 항목을 생성할 수 있습니다.
 
@@ -589,6 +589,13 @@ Astro Markdoc 통합은 `markdoc.config.js` 파일을 통해 사용할 수 없
 
 ### `allowHTML`
 
+<p>
+
+**타입:** `boolean`<br />
+**기본값:** `false`<br />
+<Since v="0.4.4" pkg="@astrojs/markdoc" />
+</p>
+
 Markdoc 태그 및 노드와 함께 HTML 마크업 작성을 활성화합니다.
 
 기본적으로 Markdoc은 HTML 마크업을 의미 있는 콘텐츠로 인식하지 않습니다.
@@ -611,6 +618,13 @@ Markdoc 태그 및 노드와 함께 HTML 마크업 작성을 활성화합니다.
 
 ### `ignoreIndentation`
 
+<p>
+
+**타입:** `boolean`<br />
+**기본값:** `false`<br />
+<Since v="0.7.0" pkg="@astrojs/markdoc" />
+</p>
+
 기본적으로 공백 4개로 들여쓰기된 모든 콘텐츠는 코드 블록으로 처리됩니다. 불행하게도 이 동작은 복잡한 구조를 가진 문서의 가독성을 향상시키기 위해 임의 수준의 들여쓰기를 사용하기 어렵게 만듭니다.
 
 Markdoc에서 중첩 태그를 사용할 때 깊이 수준이 명확하도록 태그 내부의 내용을 들여쓰는 것이 도움이 될 수 있습니다. 임의 들여쓰기를 지원하려면 들여쓰기 기반 코드 블록을 비활성화하고 들여쓰기 기반 코드 블록을 설명하는 몇 가지 다른 markdown-it 구문 분석 규칙을 수정해야 합니다. 이러한 변경 사항은 ignoreIndentation 옵션을 활성화하여 적용할 수 있습니다.

src/content/docs/ko/guides/integrations-guide/mdx.mdx

@@ -273,8 +273,12 @@ MDX는 remark 및 rehype 플러그인을 문자열로 전달하는 것을 지원
 
 ### `extendMarkdownConfig`
 
-* **타입:** `boolean`
-* **기본값:** `true`
+<p>
+
+**타입:** `boolean`<br />
+**기본값:** `true`<br />
+<Since v="0.15.0" pkg="@astrojs/mdx" />
+</p>
 
 MDX는 기본적으로 [프로젝트의 기존 Markdown 구성](/ko/reference/configuration-reference/#markdown-옵션)을 확장합니다. 개별 옵션을 재정의하려면 MDX 구성에서 해당 옵션을 지정하면 됩니다.
 
@@ -328,13 +332,25 @@ export default defineConfig({
 
 ### `recmaPlugins`
 
+<p>
+
+**타입:** `PluggableList`<br />
+**기본값:** `[]`<br />
+<Since v="0.11.5" pkg="@astrojs/mdx" />
+</p>
+
 출력되는 [estree](https://github.com/estree/estree)를 직접 수정하는 플러그인입니다. 이는 MDX 파일에서 JavaScript 변수를 수정하거나 삽입하는 데 유용합니다.
 
 [AST Explorer를 사용](https://astexplorer.net/)하여 estree 출력을 수행하고 [`estree-util-visit`](https://unifiedjs.com/explore/package/estree-util-visit/)를 사용하여 JavaScript 노드를 검색하는 것이 좋습니다.
 
 ### `optimize`
 
-* **타입:** `boolean | { ignoreElementNames?: string[] }`
+<p>
+
+**타입:** `boolean | { ignoreElementNames?: string[] }`<br />
+**기본값:** `false`<br />
+<Since v="0.19.5" pkg="@astrojs/mdx" />
+</p>
 
 이는 내부 rehype 플러그인을 통해 더 빠른 빌드 및 렌더링을 위해 MDX 출력을 최적화하기 위한 선택적 구성 설정입니다. MDX 파일이 많고 빌드 속도가 느린 경우에 유용할 수 있습니다. 그러나 이 옵션은 일부 이스케이프 처리되지 않은 HTML을 생성할 수 있으므로 활성화한 후에도 사이트의 대화형 부분이 여전히 올바르게 작동하는지 확인하세요.
 
@@ -356,9 +372,12 @@ export default defineConfig({
 
 #### `ignoreElementNames`
 
-* **타입:** `string[]`
+<p>
+
+**타입:** `string[]`<br />
+<Since v="3.0.0" pkg="@astrojs/mdx" />
+</p>
 
-<p><Since pkg="@astrojs/mdx" v="3.0.0" /></p>
 이전에는 `customComponentNames`로 알려졌습니다.
 
 MDX 최적화 프로그램이 [컴포넌트 prop을 통해 가져온 MDX 콘텐츠에 전달된 사용자 정의 컴포넌트](/ko/guides/integrations-guide/mdx/#가져온-mdx를-사용하는-사용자-정의-컴포넌트)와 같은 특정 요소 이름을 처리하지 못하도록 방지하는 `optimize`의 선택적 속성입니다.