From 9e2b10ae0d218240fd0e3f2eecde5ac49b09e0e0 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 21:32:16 +0900
Subject: [PATCH 01/43] i18n(ko-KR): create `astro-middleware.mdx` (#9817)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../ko/reference/modules/astro-middleware.mdx | 122 ++++++++++++++++++
 1 file changed, 122 insertions(+)
 create mode 100644 src/content/docs/ko/reference/modules/astro-middleware.mdx

diff --git a/src/content/docs/ko/reference/modules/astro-middleware.mdx b/src/content/docs/ko/reference/modules/astro-middleware.mdx
new file mode 100644
index 0000000000000..f56145541a414
--- /dev/null
+++ b/src/content/docs/ko/reference/modules/astro-middleware.mdx
@@ -0,0 +1,122 @@
+---
+title: 미들웨어 API 참조
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="2.6.0" /></p>
+
+미들웨어를 사용하면 페이지나 엔드포인트가 렌더링될 때마다 요청과 응답을 가로채고 동작을 동적으로 주입할 수 있습니다. 기능 및 사용 예시는 [미들웨어 가이드](/ko/guides/middleware/)를 확인하세요.
+
+## `astro:middleware`에서 가져오기
+
+```js
+import {
+  sequence,
+  createContext,
+  trySerializeLocals,
+  defineMiddleware,
+ } from 'astro:middleware';
+```
+
+### `defineMiddleware()`
+
+타입 안전성을 활용하기 위해 유틸리티 함수 `defineMiddleware()`를 가져와 사용할 수 있습니다:
+
+```ts
+// src/middleware.ts
+import { defineMiddleware } from "astro:middleware";
+
+// `context` 및 `next`의 타입이 자동으로 설정됩니다.
+export const onRequest = defineMiddleware((context, next) => {
+
+});
+```
+
+### `sequence()`
+
+<p>
+
+**타입:** `(...handlers: MiddlewareHandler[]) => MiddlewareHandler`
+</p>
+
+미들웨어 함수를 인수로 받아 전달된 순서대로 실행하는 함수입니다.
+
+```js title="src/middleware.js"
+import { sequence } from "astro:middleware";
+
+async function validation(_, next) {...}
+async function auth(_, next) {...}
+async function greeting(_, next) {...}
+
+export const onRequest = sequence(validation, auth, greeting);
+```
+
+### `createContext()`
+
+<p>
+
+**타입:** `(context: CreateContext) => APIContext`<br />
+<Since v="2.8.0" />
+</p>
+
+Astro 미들웨어 `onRequest()` 함수에 전달될 [`APIContext`](/ko/reference/api-reference/#엔드포인트-context)를 생성하는 저수준 API입니다.
+
+이 함수는 Astro 미들웨어를 프로그래밍 방식으로 실행하기 위해 통합/어댑터에서 사용할 수 있습니다.
+
+### `trySerializeLocals()`
+
+<p>
+
+**타입:** `(value: unknown) => string`<br />
+<Since v="2.8.0" />
+</p>
+
+모든 값을 받아들여 해당 값의 직렬화된 버전 (문자열)을 반환하려고 시도하는  저수준 API입니다. 값을 직렬화할 수 없으면 함수에서 런타임 오류가 발생합니다.
+
+## 미들웨어 내보내기
+
+프로젝트의 미들웨어를 `src/middleware.js`에서 정의할 때, 다음 사용자 정의 함수를 내보내세요:
+
+### `onRequest()`
+
+**타입:** `(context: APIContext, next: MiddlewareNext) => Promise<Response> | Response | Promise<void> | void`
+
+모든 페이지 또는 API 경로를 렌더링하기 전에 호출되는 `src/middleware.js`에서 내보낸 필수 함수입니다. 두 개의 인수 [context](#context) 및 [next()](#next)를 전달받습니다. `onRequest()`는 `Response`를 직접 반환하거나 `next()`를 호출하여 반환해야 합니다.
+
+```js title="src/middleware.js"
+export function onRequest (context, next) {
+    // 요청의 응답 데이터를 가로챕니다.
+    // 선택적으로 응답을 변환합니다.
+    // Response를 직접 반환하거나 `next()` 호출 결과를 반환합니다.
+    return next();
+};
+```
+
+`onRequest()` 함수는 다음 인자를 전달받아 호출됩니다.
+
+#### `context`
+
+<p>
+
+**타입:** `APIContext`
+</p>
+
+`onRequest()`의 첫 번째 인수는 컨텍스트 객체입니다. 이는 많은 `Astro` 전역 프로퍼티를 반영합니다.
+
+<ReadMore>컨텍스트 객체에 대해 더 자세히 알아보기 위해 [엔드포인트 컨텍스트](/ko/reference/api-reference/#엔드포인트-context)를 방문하세요.</ReadMore>
+
+#### `next()`
+
+<p>
+
+**타입:** `(rewritePayload?: string | URL | Request) => Promise<Response>`<br />
+</p>
+
+`onRequest()`의 두 번째 인수는 체인의 모든 후속 미들웨어를 호출하고 `Response`를 반환하는 함수입니다. 예를 들어, 다른 미들웨어가 응답의 HTML 본문을 수정할 수 있으며 `next()`의 결과를 기다리면 미들웨어가 이러한 변경 사항에 응답할 수 있습니다.
+
+Astro v4.13.0부터 `next()`는 새 렌더링 단계를 다시 트리거하지 않고 현재 요청을 [리라이트](/ko/guides/routing/#리라이트)하기 위해 문자열 형식의 선택적 URL 경로 매개 변수인 `URL` 또는 `Request`를 허용합니다.

From 87dbd4d457875542c209a31fb5faa86ccafb0cbf Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 21:40:02 +0900
Subject: [PATCH 02/43] i18n(ko-KR): create `astro-transitions.mdx` (#9818)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../reference/modules/astro-transitions.mdx   | 458 ++++++++++++++++++
 1 file changed, 458 insertions(+)
 create mode 100644 src/content/docs/ko/reference/modules/astro-transitions.mdx

diff --git a/src/content/docs/ko/reference/modules/astro-transitions.mdx b/src/content/docs/ko/reference/modules/astro-transitions.mdx
new file mode 100644
index 0000000000000..e7c6927fa04bb
--- /dev/null
+++ b/src/content/docs/ko/reference/modules/astro-transitions.mdx
@@ -0,0 +1,458 @@
+---
+title: View Transitions API 참조
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="3.0.0" /></p>
+
+이 모듈은 View Transitions API 및 클라이언트 측 라우터를 제어하고 상호 작용하는 함수를 제공합니다.
+
+기능 및 사용 예시는 [View Transitions 가이드](/ko/guides/view-transitions/)를 참조하세요.
+
+## `astro:transitions`에서 가져오기
+
+```ts
+import { ViewTransitions, fade, slide } from 'astro:transitions';
+```
+
+### `<ViewTransitions />`
+
+<p><Since v="3.0.0" /></p>
+
+원하는 모든 페이지의 `<head>`에 `<ViewTransitions />` 라우팅 컴포넌트를 가져오고 추가하여 개별 페이지에서 트랜지션을 사용하도록 선택합니다.
+
+```astro title="src/pages/index.astro" ins={2,7}
+---
+import { ViewTransitions } from 'astro:transitions';
+---
+<html lang="en">
+  <head>
+    <title>My Homepage</title>
+    <ViewTransitions />
+  </head>
+  <body>
+    <h1>Welcome to my website!</h1>
+  </body>
+</html>
+```
+
+페이지 요소와 컴포넌트에 [라우터 제어](/ko/guides/view-transitions/#라우터-제어) 및 [전환 지시어를 추가](/ko/guides/view-transitions/#전환-지시어)하는 방법에 대해 자세히 알아보세요.
+
+### `fade`
+
+<p>
+
+**타입:** `(opts: { duration?: string | number }) => TransitionDirectionalAnimations`
+<Since v="3.0.0" />
+</p>
+
+기본적으로 제공되는 `fade` 애니메이션의 지속 시간을 설정할 수 있는 유틸리티 함수입니다.
+
+```astro {2} /fade\\(.+\\)/
+---
+import { fade } from 'astro:transitions';
+---
+
+<!-- 기본 지속 시간을 사용한 페이드 트랜지션 -->
+<div transition:animate="fade" />
+
+<!-- 400 밀리초 동안 지속되는 페이드 트랜지션 -->
+<div transition:animate={fade({ duration: '0.4s' })} />
+```
+
+### `slide`
+
+<p>
+
+**타입:** `(opts: { duration?: string | number }) => TransitionDirectionalAnimations`
+<Since v="3.0.0" />
+</p>
+
+기본적으로 제공되는 `slide` 애니메이션의 지속 시간을 설정할 수 있는 유틸리티 함수입니다.
+
+```astro {2} /slide\\(.+\\)/
+---
+import { slide } from 'astro:transitions';
+---
+
+<!-- 기본 지속 시간을 사용한 슬라이드 트랜지션 -->
+<div transition:animate="slide" />
+
+<!-- 400 밀리초 동안 지속되는 슬라이드 트랜지션 -->
+<div transition:animate={slide({ duration: '0.4s' })} />
+```
+
+## `astro:transitions/client`에서 가져오기
+
+```astro
+<script>
+  import {
+    navigate,
+    supportsViewTransitions,
+    transitionEnabledOnThisPage,
+    getFallback,
+    swapFunctions,
+  } from 'astro:transitions/client';
+</script>
+```
+
+### `navigate()`
+
+<p>
+
+**타입:** `(href: string, options?: Options) => void`<br />
+<Since v="3.2.0" />
+</p>
+
+View Transitions API를 사용하여 지정된 `href`로 탐색을 실행하는 함수입니다.
+
+이 함수 시그니처는 [브라우저 Navigation API의 `navigate` 함수](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate)를 기반으로 합니다. 이 함수는 Navigation API를 기반으로 하지만, 페이지를 다시 로드하지 않고 탐색할 수 있도록 [History API](https://developer.mozilla.org/ko/docs/Web/API/History_API) 위에 구현되어 있습니다.
+
+#### `history` 옵션
+
+<p>
+
+**타입:** `'auto' | 'push' | 'replace'`<br />
+**기본값:** `'auto'`<br />
+<Since v="3.2.0" />
+</p>
+
+이 탐색을 브라우저 기록에 추가하는 방법을 정의합니다.
+
+- `'push'`: 라우터는 `history.pushState`를 사용하여 브라우저 기록에 새 항목을 생성합니다.
+- `'replace'`: 라우터는 `history.replaceState`를 사용하여 탐색에 새 항목을 추가하지 않고 URL을 업데이트합니다.
+- `'auto'` (기본값): 라우터는 `history.pushState`를 시도하지만, URL을 전환할 수 없는 경우 현재 URL은 브라우저 기록을 변경하지 않고 그대로 유지됩니다.
+
+이 옵션은 브라우저 Navigation API의 [`history` 옵션](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#history)을 따르지만, Astro 프로젝트에서 발생할 수 있는 경우를 위해 단순화되었습니다.
+
+#### `formData` 옵션
+
+<p>
+
+**타입:** `FormData`<br />
+<Since v="3.5.0" />
+</p>
+
+`POST` 요청을 위한 `FormData` 객체입니다.
+
+이 옵션을 제공하면 탐색 대상 페이지에 대한 요청이 양식 데이터 객체를 콘텐츠로 하는 `POST` 요청으로 전송됩니다.
+
+트랜지션이 활성화된 HTML 양식을 제출하면 페이지 새로 고침이 있는 기본 탐색 대신 이 메서드가 사용됩니다. 이 메서드를 호출하면 프로그래밍 방식으로 동일한 동작을 트리거할 수 있습니다.
+
+#### `info` 옵션
+
+<p>
+
+**타입:** `any`<br />
+<Since v="3.6.0" />
+</p>
+
+이 탐색으로 인해 발생하는 `astro:before-preparation` 및 `astro:before-swap` 이벤트에 포함될 임의의 데이터입니다.
+
+이 옵션은 브라우저 Navigation API의 [`info` 옵션](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#info)을 모방합니다.
+
+#### `state` 옵션
+
+<p>
+
+**타입:** `any`<br />
+<Since v="3.6.0" />
+</p>
+
+이 탐색에서 생성된 `NavitationHistoryEntry` 객체에 연결할 임의의 데이터입니다. 이 데이터는 History API의 [`history.getState` 함수](https://developer.mozilla.org/en-US/docs/Web/API/NavigationHistoryEntry/getState)를 사용하여 검색할 수 있습니다.
+
+이 옵션은 브라우저 Navigation API의 [`state` 옵션](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#state)을 모방합니다.
+
+#### `sourceElement` 옵션
+
+<p>
+
+**타입:** `Element`<br />
+<Since v="3.6.0" />
+</p>
+
+존재하는 경우, 이 탐색을 트리거한 요소입니다. 이 요소는 다음 이벤트에서 사용할 수 있습니다:
+- `astro:before-preparation`
+- `astro:before-swap`
+
+### `supportsViewTransitions`
+
+<p>
+
+**타입:** `boolean`<br />
+<Since v="3.2.0" />
+</p>
+
+현재 브라우저에서 트랜지션이 지원되고 활성화되어 있는지 여부입니다.
+
+### `transitionEnabledOnThisPage`
+
+<p>
+
+**타입:** `boolean`<br />
+<Since v="3.2.0" />
+</p>
+
+현재 페이지에 클라이언트 측 탐색을 위한 트랜지션이 활성화되어 있는지 여부입니다. 트랜지션이 있는 페이지에서 다르게 동작하는 컴포넌트를 만드는 데 사용할 수 있습니다.
+
+### `getFallback()`
+
+<p>
+
+**타입:** `() => 'none' | 'animate' | 'swap'`<br />
+<Since v="3.6.0" />
+</p>
+
+트랜지션을 지원하지 않는 브라우저에서 사용할 대체 전략을 반환합니다.
+
+대체 동작을 선택하고 구성하는 방법은 [대체 제어](/ko/guides/view-transitions/#대체-제어) 가이드를 참조하세요.
+
+### `swapFunctions`
+
+<p>
+
+<Since v="4.15.0" />
+</p>
+
+Astro의 기본 스왑 함수를 빌드하는 데 사용되는 유틸리티 함수가 포함된 객체입니다.
+[사용자 정의 스왑 함수를 만들때](/ko/guides/view-transitions/#사용자-정의-스왑-함수-구현) 유용할 수 있습니다.
+
+`swapFunctions`는 다음과 같은 메서드를 제공합니다:
+
+#### `deselectScripts()`
+
+<p>
+
+**타입:** `(newDocument: Document) => void`
+</p>
+
+새 문서에서 실행해서는 안 되는 스크립트를 표시합니다. 이러한 스크립트는 이미 현재 문서에 있으며 [`data-astro-rerun`](/ko/guides/view-transitions/#data-astro-rerun)을 사용하여 다시 실행하도록 플래그가 지정되지 않습니다.
+
+#### `swapRootAttributes()`
+
+<p>
+
+**타입:** `(newDocument: Document) => void`
+</p>
+
+`lang` 속성과 같은 문서 루트 간 속성을 스왑합니다. 여기에는 `data-astro-transition`과 같은 Astro에서 삽입한 내부 속성도 포함되어 있어, 트랜지션 방향을 Astro에서 생성된 CSS 규칙에 사용할 수 있습니다.
+
+사용자 지정 스왑 함수를 만들 때, 트랜지션의 애니메이션이 깨지지 않도록 이 함수를 호출하는 것이 중요합니다.
+
+#### `swapHeadElements()`
+
+<p>
+
+**타입:** `(newDocument: Document) => void`
+</p>
+
+현재 문서의 `<head>`에서 새 문서에 유지되지 않는 모든 요소를 제거합니다. 그런 다음 새 문서의 `<head>`에 있는 모든 새 요소를 현재 문서의 `<head>`에 추가합니다.
+
+#### `saveFocus()`
+
+<p>
+
+**타입:** `() => () => void`
+</p>
+
+현재 페이지에서 포커스된 요소를 저장하고, 포커스된 요소가 유지되는 경우, 호출 시 해당 요소에 포커스를 제공하는 함수를 반환합니다.
+
+
+#### `swapBodyElement()`
+
+<p>
+
+**타입:** `(newBody: Element, oldBody: Element) => void`
+</p>
+
+이전 body를 새 body로 교체합니다. 그런 다음 이전 body에서 유지되어야 하는 모든 요소를 검토하고 새 body에서 일치하는 요소를 찾아 이전 요소를 다시 제자리로 바꿉니다.
+
+## 라이프사이클 이벤트
+
+### `astro:before-preparation` 이벤트
+
+View Transitions를 사용하여 탐색을 시작할 때 전송되는 이벤트입니다. 이 이벤트는 요청이 이루어지고 브라우저 상태가 변경되기 전에 발생합니다.
+
+이 이벤트에는 속성이 있습니다:
+- [`info`](#info)
+- [`sourceElement`](#sourceelement)
+- [`navigationType`](#navigationtype)
+- [`direction`](#direction)
+- [`from`](#from)
+- [`to`](#to)
+- [`formData`](#formdata)
+- [`loader()`](#loader)
+
+이 이벤트의 사용 방법에 대한 자세한 내용은 [View Transitions 가이드](/ko/guides/view-transitions/#astrobefore-preparation)에서 확인하세요.
+
+### `astro:after-preparation` 이벤트
+
+View Transitions를 사용하는 탐색에서 다음 페이지가 로드된 후 전송되는 이벤트입니다.
+
+이 이벤트에는 속성이 없습니다.
+
+이 이벤트의 사용 방법에 대한 자세한 내용은 [View Transitions 가이드](/ko/guides/view-transitions/#astroafter-preparation)에서 확인하세요.
+
+### `astro:before-swap` 이벤트
+
+다음 페이지가 구문 분석되고, 준비되고, 트랜지션을 준비하면서 문서에 링크된 후, 문서 간 콘텐츠가 교환되기 전에 전송되는 이벤트입니다.
+
+이 이벤트는 취소할 수 없습니다. `preventDefault()`를 호출하는 것은 아무 작업도 하지 않습니다.
+
+이 이벤트에는 속성이 있습니다:
+- [`info`](#info)
+- [`sourceElement`](#sourceelement)
+- [`navigationType`](#navigationtype)
+- [`direction`](#direction)
+- [`from`](#from)
+- [`to`](#to)
+- [`viewTransition`](#viewtransition)
+- [`swap()`](#swap)
+
+이 이벤트의 사용 방법에 대한 자세한 내용은 [View Transitions 가이드](/ko/guides/view-transitions/#astrobefore-swap)에서 확인하세요.
+
+### `astro:after-swap` 이벤트
+
+페이지의 콘텐츠가 교체된 후, 트랜지션이 끝나기 전에 전달되는 이벤트입니다.
+
+기록 항목과 스크롤 위치가 업데이트된 후, 이 이벤트가 트리거됩니다.
+
+### `astro:page-load` 이벤트
+
+트랜지션을 사용하는 탐색이나 브라우저의 기본 기능으로 페이지 로드가 완료된 후 전달되는 이벤트입니다.
+
+페이지에서 트랜지션이 활성화되면 일반적으로 `DOMContentLoaded`에서 실행되는 코드가 이 이벤트에서 실행되도록 변경되어야 합니다.
+
+### 라이프사이클 이벤트 속성
+
+<p><Since v="3.6.0" /></p>
+
+#### `info`
+
+<p>
+
+**타입:** `URL`
+</p>
+
+탐색 중에 정의된 임의의 데이터입니다.
+
+이는 [`navigate()` 함수](#navigate)의 [`info` 옵션](#info-옵션)에 전달된 리터럴 값입니다.
+
+#### `sourceElement`
+
+<p>
+
+**타입:** `Element | undefined`
+</p>
+
+탐색을 트리거한 요소입니다. 예를 들어 클릭된 `<a>` 요소가 될 수 있습니다.
+
+[`navigate()` 함수](#navigate)를 사용할 때는 호출에서 지정된 요소가 됩니다.
+
+#### `newDocument`
+
+<p>
+
+**타입:** `Document`
+</p>
+
+탐색의 다음 페이지에 대한 문서입니다. 이 문서의 내용은 현재 문서의 내용 대신 교체됩니다.
+
+#### `navigationType`
+
+<p>
+
+**타입:** `'push' | 'replace' | 'traverse'`
+</p>
+
+어떤 종류의 기록 탐색이 일어나고 있나요.
+- `push`: 새 페이지에 대한 새 `NavigationHistoryEntry`가 만들어지고 있습니다.
+- `replace`: 현재 `NavigationHistoryEntry`가 새 페이지의 항목으로 대체되고 있습니다.
+- `traverse`: `NavigationHistoryEntry`이 생성되지 않습니다. 히스토리 내 위치가 변경되고 있습니다.
+  순회 방향은 [`direction` 속성](#direction)에서 지정됩니다.
+
+#### `direction`
+
+<p>
+
+**타입:** `Direction`
+</p>
+
+트랜지션 방향입니다.
+- `forward`: 기록의 다음 페이지 또는 새 페이지로 이동합니다.
+- `back`: 기록의 이전 페이지로 이동합니다.
+- 다른 리스너가 설정했을 수 있는 기타 모든 항목.
+
+#### `from`
+
+<p>
+
+**타입:** `URL`
+</p>
+
+The URL of the page initiating the navigation.
+탐색을 시작하는 페이지의 URL입니다.
+
+#### `to`
+
+<p>
+
+**타입:** `URL`
+</p>
+
+탐색 중인 페이지의 URL입니다. 이 속성을 수정할 수 있으며, 라이프사이클이 끝날 때의 값이 다음 페이지의 `NavigationHistoryEntry`에 사용됩니다.
+
+#### `formData`
+
+<p>
+
+**타입:** `FormData | undefined`
+</p>
+
+`POST` 요청을 위한 `FormData` 객체입니다.
+
+이 속성을 설정하면 일반적인 `GET` 요청 대신 지정된 양식 데이터 객체를 콘텐츠로 하는 `POST` 요청이 [`to` URL](#to)로 전송됩니다.
+
+트랜지션이 활성화된 HTML 양식을 제출할 때 이 필드는 양식의 데이터로 자동 설정됩니다. [`navigate()` 함수](#navigate)를 사용하는 경우 이 값은 옵션에 지정된 것과 동일합니다.
+
+#### `loader()`
+
+<p>
+
+**타입:** `() => Promise<void>`
+</p>
+
+탐색에서 다음 단계 (다음 페이지 로딩)를 구현합니다. 이 구현을 재정의하여 동작을 추가할 수 있습니다.
+
+#### `viewTransition`
+
+<p>
+
+**타입:** [`ViewTransition`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransition)
+</p>
+
+이 탐색에 사용된 트랜지션 객체입니다. [View Transitions API](https://developer.mozilla.org/ko/docs/Web/API/View_Transitions_API)를 지원하지 않는 브라우저에서는 편의를 위해 동일한 API를 구현하지만 DOM 통합이 없는 객체입니다.
+
+#### `swap()`
+
+<p>
+
+**타입:** `() => void`
+</p>
+
+문서 스왑 로직을 구현합니다.
+
+[사용자 지정 스왑 함수를 구현](/ko/guides/view-transitions/#사용자-정의-스왑-함수-구현)하는 방법에 대한 자세한 내용은 View Transitions 가이드를 참조하세요.
+
+기본적으로 이 구현은 다음 함수를 순서대로 호출합니다:
+
+1. [`deselectScripts()`](#deselectscripts)
+2. [`swapRootAttributes()`](#swaprootattributes)
+3. [`swapHeadElements()`](#swapheadelements)
+4. [`saveFocus()`](#savefocus)
+5. [`swapBodyElement()`](#swapbodyelement)

From 42c872aeb4e63897600108ba2d3ec974b5e520a4 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 21:47:32 +0900
Subject: [PATCH 03/43] i18n(ko-KR): create `astro-actions.mdx` (#9813)

* i18n(ko-KR): create `astro-actions.mdx`

* fix typo

---------

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../ko/reference/modules/astro-actions.mdx    | 176 ++++++++++++++++++
 1 file changed, 176 insertions(+)
 create mode 100644 src/content/docs/ko/reference/modules/astro-actions.mdx

diff --git a/src/content/docs/ko/reference/modules/astro-actions.mdx b/src/content/docs/ko/reference/modules/astro-actions.mdx
new file mode 100644
index 0000000000000..560316b6d8da7
--- /dev/null
+++ b/src/content/docs/ko/reference/modules/astro-actions.mdx
@@ -0,0 +1,176 @@
+---
+title: 액션 API 참조
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+액션을 사용하면 클라이언트 코드 및 HTML 양식에서 호출할 수 있는 타입 안정성을 갖춘 백엔드를 구축할 수 있습니다. 액션을 정의하고 호출하는 모든 유틸리티는 `astro:actions` 모듈에 의해 노출됩니다. 예시 및 사용 지침은 [액션 가이드](/ko/guides/actions/)를 참조하세요.
+
+## `astro:actions`에서 가져오기
+
+```js
+import {
+  actions,
+  defineAction,
+  isInputError,
+  ActionError,
+ } from 'astro:actions';
+```
+
+### `defineAction()`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+`defineAction()` 유틸리티는 `src/actions/index.ts` 파일에서 새 액션을 정의하는 데 사용됩니다. 이 함수는 실행할 서버 로직이 포함된 [`handler()`](#handler-속성) 함수와 런타임에 입력 매개변수를 검사하는 선택적인 [`input`](#input-유효성-검사기) 속성을 받습니다.
+
+```ts title="src/actions/index.ts"
+import { defineAction } from 'astro:actions';
+import { z } from 'astro:schema';
+
+export const server = {
+  getGreeting: defineAction({
+    input: z.object({
+      name: z.string(),
+    }),
+    handler: async (input, context) => {
+      return `Hello, ${input.name}!`
+    }
+  })
+}
+```
+
+#### `handler()` 속성
+
+<p>
+
+**Type:** `(input, context) => any`
+</p>
+
+`defineAction()`에는 액션이 호출될 때 실행할 서버 로직이 포함된 `handler()` 함수가 필요합니다. 핸들러에서 반환된 데이터는 자동으로 직렬화되어 호출자에게 전송됩니다.
+
+`handler()`는 사용자 입력을 첫 번째 인수로 받아 호출됩니다. [`input`](#input-유효성-검사기) 유효성 검사기가 설정되어 있으면 사용자 입력은 핸들러로 전달되기 전에 유효성이 검사됩니다. 두 번째 인수는 `getActionResult()`, `callAction()` 및 `redirect()`를 제외한 대부분의 Astro [표준 엔드포인트 컨텍스트](/ko/reference/api-reference/#엔드포인트-context)를 포함하는 `context` 객체입니다.
+
+반환 값은 [devalue 라이브러리](https://github.com/Rich-Harris/devalue)를 사용하여 구문 분석됩니다. 이 라이브러리는 `Date()`, `Map()`, `Set()`, `URL()`의 인스턴스와 JSON 값을 지원합니다.
+
+#### `input` 유효성 검사기
+
+<p>
+
+**Type:** `ZodType | undefined`
+</p>
+
+선택적 `input` 속성은 런타임에 핸들러 입력의 유효성을 검사하기 위해 Zod 유효성 검사기를 전달받습니다. 액션이 유효성 검사에 실패하면 [`BAD_REQUEST` 오류](#actionerror)가 반환되고 `handler`가 호출되지 않습니다.
+
+`input`을 생략하면 `handler`는 JSON 요청의 경우 `unknown` 타입의 입력을, 양식 요청의 경우 `FormData` 타입의 입력을 받습니다.
+
+##### `accept: 'form'`과 함께 사용
+
+액션이 양식 입력을 전달받는 경우 `z.object()` 유효성 검사기를 사용하여 양식 데이터를 타입이 정해진 객체로 자동 구문 분석합니다. 양식 데이터 필드에 지원되는 유효성 검사기는 다음과 같습니다:
+
+- `number` 유형의 입력은 `z.number()`를 사용하여 검증할 수 있습니다.
+- `checkbox` 유형의 입력은 `z.boolean()`을 사용하여 검증할 수 있습니다.
+- `file` 유형의 입력은 `z.instanceof(File)`을 사용하여 검증할 수 있습니다.
+- 동일한 `name`의 여러 입력은 `z.array(/* validator */)`를 사용하여 검증할 수 있습니다.
+- 다른 모든 입력은 `z.string()`을 사용하여 검증할 수 있습니다.
+
+`.refine()`, `.transform()`, `.pipe()`를 포함한 확장 함수도 `z.object()` 유효성 검사기에서 지원됩니다.
+
+서로 다른 유효성 검사기의 조합을 적용하려면 `z.discriminatedUnion()` 래퍼를 사용하여 특정 양식 필드를 기준으로 타입을 좁히세요. 이 예시는 사용자 "생성" 또는 "업데이트" 중 하나로 양식 제출을 처리하며, `type`이라는 이름의 양식 필드를 사용하여 어떤 객체에 대해 유효성 검사를 수행할지 결정합니다.
+
+```ts
+import { defineAction } from 'astro:actions';
+import { z } from 'astro:schema';
+
+export const server = {
+  changeUser: defineAction({
+    accept: 'form',
+    input: z.discriminatedUnion('type', [
+      z.object({
+        // `type` 필드에 `create` 값이 있을 때 일치합니다.
+        type: z.literal('create'),
+        name: z.string(),
+        email: z.string().email(),
+      }),
+      z.object({
+        // `type` 필드에 `update` 값이 있을 때 일치합니다.
+        type: z.literal('update'),
+        id: z.number(),
+        name: z.string(),
+        email: z.string().email(),
+      }),
+    ]),
+    async handler(input) {
+      if (input.type === 'create') {
+        // input은 { type: 'create', name: string, email: string }
+      } else {
+        // input은 { type: 'update', id: number, name: string, email: string }
+      }
+    },
+  }),
+};
+```
+
+### `isInputError()`
+
+<p>
+
+**Type:** <code>(error?: unknown | <a href="#actionerror">ActionError</a>) => boolean</code><br/>
+<Since v="4.15.0" />
+</p>
+
+`isInputError()` 유틸리티는 `ActionError`가 입력 유효성 검사 오류인지 확인하는 데 사용됩니다. `input` 유효성 검사기가 `z.object()`인 경우 입력 오류에는 이름별로 그룹화된 오류 메시지가 있는 `fields` 객체가 포함됩니다.
+
+<ReadMore>[양식 입력 오류 가이드](/ko/guides/actions/#양식-입력-오류-표시)에서 `isInputError()` 사용에 대한 자세한 내용을 참조하세요.</ReadMore>
+
+### `ActionError`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+액션 `handler`가 던지는 오류를 생성하는 데 `ActionError()` 생성자가 사용됩니다. 이는 발생한 오류 (예: `"UNAUTHORIZED"`)를 설명하는 `code` 속성과 추가 세부정보가 포함된 선택적 `message` 속성을 허용합니다.
+
+#### `code`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+`code` 속성은 모든 HTTP 상태 코드의 사람이 읽을 수 있는 버전을 허용합니다. 지원되는 코드는 다음과 같습니다:
+
+- `BAD_REQUEST` (400): 클라이언트가 잘못된 입력을 보냈습니다. 이 오류는 액션 `input` 유효성 검사기가 유효성 검사에 실패할 때 발생합니다.
+- `UNAUTHORIZED` (401): 클라이언트에 유효한 인증 자격 증명이 없습니다.
+- `FORBIDDEN` (403): 클라이언트가 리소스에 액세스할 수 있는 권한이 없습니다.
+- `NOT_FOUND` (404): 서버가 요청된 리소스를 찾을 수 없습니다.
+- `METHOD_NOT_SUPPORTED` (405): 서버가 요청된 메서드를 지원하지 않습니다.
+- `TIMEOUT` (408):  서버가 요청을 처리하는 동안 시간 초과가 발생했습니다.
+- `CONFLICT` (409): 충돌로 인해 서버에서 리소스를 업데이트할 수 없습니다.
+- `PRECONDITION_FAILED` (412): 서버가 요청의 전제 조건을 충족하지 않습니다.
+- `PAYLOAD_TOO_LARGE` (413): 페이로드가 너무 커서 서버가 요청을 처리할 수 없습니다.
+- `UNSUPPORTED_MEDIA_TYPE` (415): 서버가 요청의 미디어 유형을 지원하지 않습니다. 참고: 액션은 이미 JSON 및 양식 요청에 대해 [`Content-Type` 헤더](https://developer.mozilla.org/ko/docs/Web/HTTP/Headers/Content-Type)를 확인하므로 이 코드를 수동으로 사용할 필요가 없을 것입니다.
+- `UNPROCESSABLE_CONTENT` (422): 시멘틱 오류로 인해 서버가 요청을 처리할 수 없습니다.
+- `TOO_MANY_REQUESTS` (429): 서버가 지정된 속도 제한을 초과했습니다.
+- `CLIENT_CLOSED_REQUEST` (499): 서버가 응답하기 전에 클라이언트가 요청을 종료했습니다.
+- `INTERNAL_SERVER_ERROR` (500): 서버가 예기치 않게 실패했습니다.
+- `NOT_IMPLEMENTED` (501): 서버가 요청된 기능을 지원하지 않습니다.
+- `BAD_GATEWAY` (502): 서버가 업스트림 서버로부터 잘못된 응답을 받았습니다.
+- `SERVICE_UNAVAILABLE` (503): 서버를 일시적으로 사용할 수 없습니다.
+- `GATEWAY_TIMEOUT` (504): 서버가 업스트림 서버로부터 시간 초과를 받았습니다.
+
+#### `message`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+`message` 속성은 문자열을 받습니다. (예: "사용자는 로그인해야 합니다.")
\ No newline at end of file

From 41f38cc29b95dd1f28d45837ae89f779d04b5f07 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 21:55:17 +0900
Subject: [PATCH 04/43] i18n(ko-KR): create `astro-assets.mdx` (#9814)

* i18n(ko-KR): create `astro-assets.mdx`

* fix typo

---------

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../ko/reference/modules/astro-assets.mdx     | 159 ++++++++++++++++++
 1 file changed, 159 insertions(+)
 create mode 100644 src/content/docs/ko/reference/modules/astro-assets.mdx

diff --git a/src/content/docs/ko/reference/modules/astro-assets.mdx b/src/content/docs/ko/reference/modules/astro-assets.mdx
new file mode 100644
index 0000000000000..57119e0c66cc8
--- /dev/null
+++ b/src/content/docs/ko/reference/modules/astro-assets.mdx
@@ -0,0 +1,159 @@
+---
+title: 자산 API 참조
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="3.0.0" /></p>
+
+ Astro는 최적화된 이미지를 표시하기 위한 기본 컴포넌트와 도우미 함수를 제공합니다. 기능 및 사용 예시는 [이미지 가이드](/ko/guides/images/)를 참조하세요.
+
+## `astro:assets`에서 가져오기
+
+```js
+import {
+  Image,
+  Picture,
+  getImage,
+ } from 'astro:assets';
+```
+
+### `<Image />`
+
+```astro title="src/components/MyComponent.astro"
+---
+// Image 컴포넌트 및 이미지 가져오기
+import { Image } from 'astro:assets';
+import myImage from "../assets/my_image.png"; // 1600x900의 이미지
+---
+
+<!-- Image 컴포넌트에서는 'alt'가 필수입니다. -->
+<Image src={myImage} alt="A description of my image." />
+```
+
+```html
+<!-- 결과 -->
+<!-- 이미지가 최적화되었으며 적절한 속성이 적용되었습니다. -->
+<img
+  src="/_astro/my_image.hash.webp"
+  width="1600"
+  height="900"
+  decoding="async"
+  loading="lazy"
+  alt="A description of my image."
+/>
+```
+#### 속성
+
+- src (필수)
+- alt (필수)
+- width 및 height (`public/` 및 원격 이미지를 사용하는 경우 필수)
+- format
+- quality
+- densities
+- widths
+
+위 속성 외에도 `<Image />` 컴포넌트는 HTML `<img>` 태그에서 허용하는 모든 속성을 허용합니다.
+
+[이미지 가이드](/ko/guides/images/#image--astroassets)에서 자세한 내용을 확인하세요.
+
+### `<Picture />`
+
+<p><Since v="3.3.0" /></p>
+
+다양한 형식 및/또는 크기로 반응형 이미지를 표시하려면 Astro의 `<Picture />` 컴포넌트를 사용하세요.
+
+```astro title="src/pages/index.astro"
+---
+import { Picture } from 'astro:assets';
+import myImage from "../assets/my_image.png"; // 1600x900의 이미지
+---
+
+<!-- Picture 컴포넌트에서는 'alt'가 필수입니다. -->
+<Picture src={myImage} formats={['avif', 'webp']} alt="A description of my image." />
+```
+
+```html
+<!-- 결과 -->
+<picture>
+  <source srcset="/_astro/my_image.hash.avif" type="image/avif" />
+  <source srcset="/_astro/my_image.hash.webp" type="image/webp" />
+  <img
+    src="/_astro/my_image.hash.png"
+    width="1600"
+    height="900"
+    decoding="async"
+    loading="lazy"
+    alt="A description of my image."
+  />
+</picture>
+```
+
+[이미지 안내서](/ko/guides/images/#picture-)에서 자세한 내용을 확인하세요.
+
+#### 속성
+
+`<Picture />`는 `<Image />` 컴포넌트의 모든 속성과 함께 다음을 허용합니다.
+
+##### `formats`
+
+`<source>` 태그에 사용할 이미지 형식의 배열입니다. 기본적으로 `['webp']`로 설정되어 있습니다.
+
+##### `fallbackFormat`
+
+`<img>` 태그에 대한 대체 값으로 사용할 형식입니다. 정적 이미지의 경우 기본값은 `.png`, 애니메이션 이미지의 경우 `.gif`, SVG 파일의 경우 `.svg`입니다.
+
+##### `pictureAttributes`
+
+`<picture>` 태그에 추가될 속성의 객체입니다. 이 속성을 사용하여 외부 `<picture>` 요소 자체에 속성을 적용합니다. `<Picture />` 컴포넌트에 직접 적용된 속성은 이미지 변환에 사용되는 속성을 제외하고 내부 `<img>` 요소에 적용됩니다.
+
+### `getImage()`
+
+<p>
+
+**타입:** `(options: UnresolvedImageTransform) => Promise<GetImageResult>`
+</p>
+
+:::caution
+`getImage()`는 서버 전용 API에 의존하며 클라이언트에서 사용될 때 빌드를 중단합니다.
+:::
+
+`getImage()` 함수는 HTML이 아닌 다른 곳 (예: [API 경로](/ko/guides/endpoints/#서버-엔드포인트-api-라우트))에서 사용할 이미지를 생성하기 위한 것입니다. 또한 사용자 정의 `<Image />` 컴포넌트를 만들 수도 있습니다.
+
+`getImage()`는 [Image 컴포넌트와 동일한 속성](/ko/reference/components-reference/#속성)을 가진 옵션 객체를 사용합니다 (`alt` 제외).
+
+```astro
+---
+import { getImage } from "astro:assets";
+import myBackground from "../background.png"
+
+const optimizedBackground = await getImage({src: myBackground, format: 'avif'})
+---
+
+<div style={`background-image: url(${optimizedBackground.src});`}></div>
+```
+
+다음 타입을 가진 객체를 반환합니다.
+
+```ts
+type GetImageResult = {
+  /* 이미지 렌더링에 필요한 추가 HTML 속성 (width, height, style 등) */
+  attributes: Record<string, any>;
+  /* 검증된 매개변수 전달 */
+  options: ImageTransform;
+  /* 원본 매개변수 전달 */
+  rawOptions: ImageTransform;
+  /* 생성된 이미지의 경로 */
+  src: string;
+  srcSet: {
+    /* 생성된 srcset의 값, 각 항목에는 URL과 크기 설명자가 있습니다. */
+    values: SrcSetValue[];
+    /* `srcset` 속성에서 사용할 수 있는 값 */
+    attribute: string;
+  };
+}
+```

From ead30afb2a71f2b01eb848f1248aef2a33d24f63 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 22:02:54 +0900
Subject: [PATCH 05/43] i18n(ko-KR): create `astro-content.mdx` (#9815)

* i18n(ko-KR): create `astro-content.mdx`

* fix typo

---------

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../ko/reference/modules/astro-content.mdx    | 373 ++++++++++++++++++
 1 file changed, 373 insertions(+)
 create mode 100644 src/content/docs/ko/reference/modules/astro-content.mdx

diff --git a/src/content/docs/ko/reference/modules/astro-content.mdx b/src/content/docs/ko/reference/modules/astro-content.mdx
new file mode 100644
index 0000000000000..d5fed161485e0
--- /dev/null
+++ b/src/content/docs/ko/reference/modules/astro-content.mdx
@@ -0,0 +1,373 @@
+---
+title: 콘텐츠 컬렉션 API 참조
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="2.0.0" /></p>
+
+콘텐츠 컬렉션은 `src/content/`에서 Markdown 또는 MDX 문서를 구성하고 쿼리하는 API를 제공합니다. 기능 및 사용 예시는 [콘텐츠 컬렉션 안내서를 참조하세요](/ko/guides/content-collections/).
+
+## `astro:content`에서 가져오기
+
+```js
+import {
+  z,
+  defineCollection,
+  getCollection,
+  getEntry,
+  getEntries,
+  reference,
+ } from 'astro:content';
+```
+### `defineCollection()`
+
+<p>
+
+**타입:** `(input: CollectionConfig) => CollectionConfig`
+</p>
+
+`defineCollection()`은 `src/content/config.*` 파일에 컬렉션을 구성하는 유틸리티입니다.
+
+```ts
+// src/content/config.ts
+import { z, defineCollection } from 'astro:content';
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    title: z.string(),
+    permalink: z.string().optional(),
+  }),
+});
+
+// `collections` 내보내기를 통해 정의된 컬렉션을 Astro에 노출합니다.
+export const collections = { blog };
+```
+
+이 함수는 다음 속성을 허용합니다.
+
+#### `type`
+
+<p>
+
+**타입:** `'content' | 'data'`<br />
+**기본값:** `'content'`<br />
+<Since v="2.5.0" />
+</p>
+
+`type`은 컬렉션에 저장된 항목의 형식을 정의하는 문자열입니다.
+
+- `'content'` - Markdown (`.md`), MDX (`.mdx`), Markdoc (`.mdoc`)와 같은 콘텐츠 작성 형식
+- `'data'` - JSON (`.json`) 또는 YAML (`.yaml`)과 같은 데이터 전용 형식의 경우
+
+:::tip
+즉, 컬렉션은 콘텐츠와 데이터 형식을 혼합하여 저장할 수 **없습니다**. 이러한 항목을 유형별로 별도의 컬렉션으로 분할해야 합니다.
+:::
+
+#### `schema`
+
+<p>
+
+**타입:** <code>ZodType | (context: <a href="#schemacontext">SchemaContext</a>) => ZodType</code>
+</p>
+
+`schema`는 컬렉션에 대한 문서 프런트매터의 타입과 모양을 구성하는 선택적 Zod 객체입니다. 각 값은 [Zod 유효성 검사기](https://github.com/colinhacks/zod)를 사용해야 합니다.
+
+사용 예시는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#컬렉션-스키마-정의).
+
+### `reference()`
+
+<p>
+
+**타입:** `(collection: string) => ZodEffects<ZodString, { collection, id: string } | { collection, slug: string }>`<br />
+<Since v="2.5.0" />
+</p>
+
+`reference()` 함수는 콘텐츠 구성에서 한 컬렉션에서 다른 컬렉션으로의 관계 또는 "reference"를 정의하는 데 사용됩니다. 이는 컬렉션 이름을 전달받고 콘텐츠 프런트매터 또는 데이터 파일에 지정된 항목 식별자의 유효성을 검사합니다.
+
+이 예시에서는 `authors` 컬렉션에 대한 블로그 작성자의 참조와 동일한 `blog` 컬렉션에 대한 관련 게시물 배열을 정의합니다.
+
+```ts
+import { defineCollection, reference, z } from 'astro:content';
+
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    // `id`로 `authors` 컬렉션에서 단일 저자 참조
+    author: reference('authors'),
+    // `slug`의 `blog` 컬렉션에서 관련 게시물 배열을 참조하세요.
+    relatedPosts: z.array(reference('blog')),
+  })
+});
+
+const authors = defineCollection({
+  type: 'data',
+  schema: z.object({ /* ... */ })
+});
+
+export const collections = { blog, authors };
+```
+
+사용 예시는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#컬렉션-참조-정의하기).
+
+### `getCollection()`
+
+<p>
+
+**타입:** `(collection: string, filter?: (entry: CollectionEntry<TCollectionName>) => boolean) => CollectionEntry<TCollectionName>[]`
+</p>
+
+`getCollection()`은 컬렉션 이름별로 콘텐츠 컬렉션 항목 목록을 검색하는 함수입니다.
+
+기본적으로 컬렉션의 모든 항목을 반환하고 항목 속성별로 범위를 좁힐 수 있는 선택적 `filter` 함수를 허용합니다. 이를 통해 `data` 객체를 통해 `id`, `slug` 또는 프런트매터 값을 기반으로 컬렉션의 일부 항목만 쿼리할 수 있습니다.
+
+```astro
+---
+import { getCollection } from 'astro:content';
+
+// 모든 `src/content/blog/` 항목을 가져옵니다.
+const allBlogPosts = await getCollection('blog');
+
+// 프런트매터에 `draft: true`가 포함된 게시물만 반환합니다.
+const draftBlogPosts = await getCollection('blog', ({ data }) => {
+  return data.draft === true;
+});
+---
+```
+
+사용 예시는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#컬렉션-쿼리).
+
+### `getEntry()`
+
+<p><Since v="2.5.0" /></p>
+
+**타입:**
+- `(collection: string, contentSlugOrDataId: string) => CollectionEntry<TCollectionName>`
+- `({ collection: string, id: string }) => CollectionEntry<TCollectionName>`
+- `({ collection: string, slug: string }) => CollectionEntry<TCollectionName>`
+
+`getEntry()`는 컬렉션 이름과 항목 `id` (`type: 'data'` 컬렉션의 경우) 또는 항목 `slug` (`type: 'content'` 컬렉션의 경우)로 단일 컬렉션 항목을 검색하는 함수입니다. `getEntry()`는 `data`, `body`, `render()` 속성에 액세스하기 위해 참조된 항목을 가져오는 데에도 사용할 수 있습니다.
+
+```astro
+---
+import { getEntry } from 'astro:content';
+
+// `src/content/blog/enterprise.md` 가져오기
+const enterprisePost = await getEntry('blog', 'enterprise');
+
+// `src/content/captains/picard.yaml` 가져오기
+const picardProfile = await getEntry('captains', 'picard');
+
+// `data.captain`이 참조하는 프로필 가져오기
+const enterpriseCaptainProfile = await getEntry(enterprisePost.data.captain);
+---
+```
+
+[컬렉션 항목 쿼리](/ko/guides/content-collections/#컬렉션-쿼리)의 예시는 `콘텐츠 컬렉션` 가이드를 참조하세요.
+
+### `getEntries()`
+
+<p><Since v="2.5.0" /></p>
+
+**타입:**
+- `(Array<{ collection: string, id: string }>) => CollectionEntry<TCollectionName>[]`
+- `(Array<{ collection: string, slug: string }>) => CollectionEntry<TCollectionName>[]`
+
+`getEntries()`는 동일한 컬렉션에서 여러 컬렉션 항목을 검색하는 함수입니다. 이는 [참조된 항목의 배열을 반환](/ko/guides/content-collections/#컬렉션-참조-정의하기)하여 관련 `data`, `body`, `render()` 속성에 액세스하는 데 유용합니다.
+
+```astro
+---
+import { getEntries } from 'astro:content';
+
+const enterprisePost = await getEntry('blog', 'enterprise');
+
+// `data.relatedPosts`에 의해 참조되는 관련 게시물 가져오기
+const enterpriseRelatedPosts = await getEntries(enterprisePost.data.relatedPosts);
+---
+```
+
+### `getEntryBySlug()`
+
+<p>
+
+**타입:** `(collection: string, slug: string) => Promise<CollectionEntry<TCollectionName>>`
+</p>
+
+:::caution[사용되지 않음]
+콘텐츠 항목을 쿼리하려면 [`getEntry()` 함수](#getentry)를 사용하세요. 이는 `getEntryBySlug()`와 동일한 인수를 허용하며 JSON 또는 YAML 컬렉션에 대해 `id`를 통한 쿼리를 지원합니다.
+:::
+
+`getEntryBySlug()`는 컬렉션 이름과 항목 `slug`로 단일 컬렉션 항목을 검색하는 함수입니다.
+
+```astro
+---
+import { getEntryBySlug } from 'astro:content';
+
+const enterprise = await getEntryBySlug('blog', 'enterprise');
+---
+```
+
+사용 예시는 [`콘텐츠 컬렉션` 가이드를 참조하세요](/ko/guides/content-collections/#컬렉션-쿼리).
+
+### `getDataEntryById()`
+
+<p>
+
+**타입:** `(collection: string, id: string) => Promise<CollectionEntry<TCollectionName>>`<br />
+<Since v="2.5.0" />
+</p>
+
+:::caution[사용되지 않음]
+데이터 항목을 쿼리하려면 [`getEntry()` 함수](#getentry)를 사용합니다. 이 함수는 `getDataEntryById()`와 동일한 인수를 전달받으며, Markdown과 같은 콘텐츠 작성 형식의 경우 `slug`로 쿼리할 수 있습니다.
+:::
+
+`getDataEntryById()`는 컬렉션 이름과 항목 `id`로 단일 컬렉션 항목을 검색하는 함수입니다.
+
+```astro
+---
+import { getDataEntryById } from 'astro:content';
+
+const picardProfile = await getDataEntryById('captains', 'picard');
+---
+```
+
+## `astro:content` 타입
+
+```ts
+import type {
+  CollectionEntry,
+  CollectionKey,
+  ContentCollectionKey,
+  DataCollectionKey,
+  SchemaContext,
+ } from 'astro:content';
+```
+
+### `CollectionEntry`
+
+[`getCollection()`](#getcollection), [`getEntry()`](#getentry), [`getEntries()`](#getentries)를 포함한 쿼리 함수는 각각 `CollectionEntry` 타입의 항목을 반환합니다. 이 타입은 `astro:content`에서 유틸리티로 사용할 수 있습니다.
+
+```ts
+import type { CollectionEntry } from 'astro:content';
+```
+
+`CollectionEntry`는 제네릭 타입입니다. 이 타입을 쿼리하려는 컬렉션의 이름과 함께 사용하세요.
+예를 들어, `blog` 컬렉션의 항목은 `CollectionEntry<'blog'>`와 같은 타입을 가질 것입니다.
+
+각 `CollectionEntry`는 다음 값을 가지는 객체입니다.
+
+#### `id`
+
+**사용 가능 대상:** `type: 'content'` 및 `type: 'data'` 컬렉션
+**타입 예시:**
+  - 콘텐츠 컬렉션: `'entry-1.md' | 'entry-2.md' | ...`
+  - 데이터 컬렉션: `'author-1' | 'author-2' | ...`
+
+`src/content/[collection]`에 상대적인 파일 경로를 사용하는 고유 ID입니다. 컬렉션 항목 파일 경로를 기반으로 가능한 모든 문자열 값을 열거합니다. [`type: 'content'`로 정의된](#type) 컬렉션은 ID에 파일 확장자를 포함하지만 `type: 'data'`로 정의된 컬렉션은 포함하지 않습니다.
+
+#### `collection`
+
+**사용 가능 대상:** `type: 'content'` 및 `type: 'data'` 컬렉션
+**타입 예시:** `'blog' | 'authors' | ...`
+
+항목이 위치한 `src/content/` 아래의 최상위 폴더 이름입니다. 이는 스키마 및 쿼리 함수에서 컬렉션을 참조하는 데 사용되는 이름입니다.
+
+#### `data`
+
+**사용 가능 대상:** `type: 'content'` 및 `type: 'data'` 컬렉션
+**타입:** `CollectionSchema<TCollectionName>`
+
+컬렉션 스키마에서 추론된 프런트매터 속성의 객체입니다 ([`defineCollection()` 참조를 확인하세요](#definecollection)). 스키마가 구성되지 않은 경우 기본값은 `any`입니다.
+
+#### `slug`
+
+**사용 가능 대상:** `type: 'content'` 컬렉션 전용
+**타입 예시:** `'entry-1' | 'entry-2' | ...`
+
+Markdown 또는 MDX 문서용 URL 지원 슬러그입니다. 파일 확장자가 없는 `id`가 기본값이지만 파일의 프런트매터에서 [`slug` 속성](/ko/guides/content-collections/#사용자-정의-슬러그-정의)을 설정하여 재정의할 수 있습니다.
+
+#### `body`
+
+**사용 가능 대상:** `type: 'content'` 컬렉션 전용
+**타입:** `string`
+
+Markdown 또는 MDX 문서의 컴파일되지 않은 원시 본문을 포함하는 문자열입니다.
+
+#### `render()`
+
+**사용 가능 대상:** `type: 'content'` 컬렉션 전용
+**타입:** `() => Promise<RenderedEntry>`
+
+렌더링을 위해 지정된 Markdown 또는 MDX 문서를 컴파일하는 함수입니다. 이 함수는 다음 속성을 반환합니다.
+
+- `<Content />` - Astro 파일에서 문서의 내용을 렌더링하는 데 사용되는 컴포넌트입니다.
+- `headings` - Markdown 및 MDX 가져오기에 대해 생성된 제목 목록, [Astro의 `getHeadings()` 유틸리티 미러링](/ko/guides/markdown-content/#사용-가능한-속성).
+- `remarkPluginFrontmatter ` - [remark 또는 rehype 플러그인이 적용된 후](/ko/guides/markdown-content/#프로그래밍-방식으로-프런트매터-수정하기) 수정된 frontmatter 객체. `any` 타입으로 설정됩니다.
+
+```astro
+---
+import { getEntryBySlug } from 'astro:content';
+const entry = await getEntryBySlug('blog', 'entry-1');
+
+const { Content, headings, remarkPluginFrontmatter } = await entry.render();
+---
+```
+
+사용 예시는 [`콘텐츠 컬렉션` 가이드를 참조하세요](/ko/guides/content-collections/#콘텐츠를-html로-렌더링).
+
+### `CollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+`src/content/config.*` 파일에 정의된 모든 컬렉션 이름의 문자열 유니언 타입입니다. 이 타입은 모든 컬렉션 이름을 허용하는 일반 함수를 정의할 때 유용할 수 있습니다.
+
+```ts
+import { type CollectionKey, getCollection } from 'astro:content';
+
+async function getCollection(collection: CollectionKey) {
+  return getCollection(collection);
+}
+```
+
+### `ContentCollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+`src/content/config.*` 파일에 정의된 `type: 'content'` 컬렉션의 모든 이름에 대한 문자열 유니언 타입입니다.
+
+### `DataCollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+`src/content/config.*` 파일에 정의된 `type: 'data'` 컬렉션의 모든 이름에 대한 문자열 유니언 타입입니다.
+
+### `SchemaContext`
+
+`defineCollection`이 `schema`의 함수 모양을 위해 사용하는 `context` 객체입니다. 이 타입은 여러 컬렉션에 대해 재사용 가능한 스키마를 구축할 때 유용할 수 있습니다.
+
+여기에는 다음 속성이 포함됩니다.
+
+- `image` - [콘텐츠 컬렉션에서 로컬 이미지를 사용](/ko/guides/images/#콘텐츠-컬렉션의-이미지)할 수 있게 해주는 `image()` 스키마 도우미
+
+```ts
+import type { SchemaContext } from 'astro:content';
+
+export const imageSchema = ({ image }: SchemaContext) =>
+    z.object({
+        image: image(),
+        description: z.string().optional(),
+    });
+
+const blog = defineCollection({
+  type: 'content',
+  schema: ({ image }) => z.object({
+    title: z.string(),
+    permalink: z.string().optional(),
+    image: imageSchema({ image })
+  }),
+});
+```

From 533ff335219f9a69500f2934acde1cdffd1c1541 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 22:09:53 +0900
Subject: [PATCH 06/43] i18n(ko-KR): update `actions.mdx` (#9803)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 src/content/docs/ko/guides/actions.mdx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/content/docs/ko/guides/actions.mdx b/src/content/docs/ko/guides/actions.mdx
index 9b7bf14b3fa71..cf5b101fc05a1 100644
--- a/src/content/docs/ko/guides/actions.mdx
+++ b/src/content/docs/ko/guides/actions.mdx
@@ -16,7 +16,7 @@ Astro 액션을 사용하면 타입 안전성을 갖춘 백엔드 함수를 정
 
 - [Zod 유효성 검사](https://zod.dev/?id=primitives)를 사용하여 JSON 및 양식 데이터 입력의 유효성을 자동으로 검사하세요.
 - 클라이언트는 물론 [HTML 양식 액션에서도](#html-양식-액션에서-액션-호출) 백엔드를 호출할 수 있는 타입이 안전한 함수를 생성하세요. 수동 `fetch()` 호출이 필요 없습니다.
-- [`ActionError`](/ko/reference/api-reference/#actionerror) 객체로 백엔드 오류를 표준화하세요.
+- [`ActionError`](/ko/reference/modules/astro-actions/#actionerror) 객체로 백엔드 오류를 표준화하세요.
 
 ## 기본 사용법
 
@@ -129,7 +129,7 @@ async () => {
 
 </Steps>
 
-<ReadMore>[`defineAction()`](/ko/reference/api-reference/#defineaction) 및 해당 속성에 대한 자세한 내용은 전체 액션 API 설명서를 참조하세요.</ReadMore>
+<ReadMore>[`defineAction()`](/ko/reference/modules/astro-actions/#defineaction) 및 해당 속성에 대한 자세한 내용은 전체 액션 API 설명서를 참조하세요.</ReadMore>
 
 ## 액션 조직화
 
@@ -340,7 +340,7 @@ export const server = {
     }
     ```
 
-    <ReadMore>사용 가능한 모든 양식 유효성 검사기는 [`input` API 참조](/ko/reference/api-reference/#input-유효성-검사기)를 확인하세요.</ReadMore>
+    <ReadMore>사용 가능한 모든 양식 유효성 검사기는 [`input` API 참조](/ko/reference/modules/astro-actions/#input-유효성-검사기)를 확인하세요.</ReadMore>
     
 3. HTML 양식에 `<script>`를 추가하여 사용자 입력을 제출합니다. 이 예시에서는 양식의 기본 제출 동작을 재정의하여 `actions.newsletter()`를 호출하고 `navigate()` 함수를 사용하여 `/confirmation`으로 리디렉션합니다:
 
@@ -375,7 +375,7 @@ export const server = {
 
 ### 양식 입력 오류 표시
 
-`required`, `type="email"`, `pattern`과 같은 [기본 HTML 양식 유효성 검사 속성](https://developer.mozilla.org/en-US/docs/Learn/Forms/Form_validation#using_built-in_form_validation)을 사용하여 제출 전에 양식 입력의 유효성을 검사할 수 있습니다. 백엔드에서 더 복잡한 `input` 유효성 검사를 수행하려면 제공된 [`isInputError()`](/ko/reference/api-reference/#isinputerror) 유틸리티 함수를 사용할 수 있습니다.
+`required`, `type="email"`, `pattern`과 같은 [기본 HTML 양식 유효성 검사 속성](https://developer.mozilla.org/en-US/docs/Learn/Forms/Form_validation#using_built-in_form_validation)을 사용하여 제출 전에 양식 입력의 유효성을 검사할 수 있습니다. 백엔드에서 더 복잡한 `input` 유효성 검사를 수행하려면 제공된 [`isInputError()`](/ko/reference/modules/astro-actions/#isinputerror) 유틸리티 함수를 사용할 수 있습니다.
 
 입력 오류를 검색하려면 `isInputError()` 유틸리티를 사용하여 잘못된 입력으로 인해 오류가 발생했는지 확인합니다. 입력 오류에는 유효성 검사에 실패한 각 입력 이름에 대한 메시지가 포함된 `fields` 객체가 포함됩니다. 이러한 메시지를 사용하여 사용자에게 제출물을 수정하라는 메시지를 표시할 수 있습니다.
 

From c995f08bed25aed63ce350176f6c74448349abc9 Mon Sep 17 00:00:00 2001
From: vrabe <git@vrabe.tw>
Date: Sat, 26 Oct 2024 21:27:09 +0800
Subject: [PATCH 07/43] i18n(zh-tw): add `guides/configuring-astro.mdx` (#9661)

* i18n(zh-tw): add `guides/configuring-astro.mdx`

* update translation

* Apply suggestions from code review

Co-authored-by: Ming-jun Lu <40516784+mingjunlu@users.noreply.github.com>

* Apply suggestions from code review

* Update src/content/docs/zh-tw/guides/configuring-astro.mdx

Co-authored-by: Ming-jun Lu <40516784+mingjunlu@users.noreply.github.com>

* change a heading

---------

Co-authored-by: Ming-jun Lu <40516784+mingjunlu@users.noreply.github.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../docs/zh-tw/guides/configuring-astro.mdx   | 171 ++++++++++++++++++
 1 file changed, 171 insertions(+)
 create mode 100644 src/content/docs/zh-tw/guides/configuring-astro.mdx

diff --git a/src/content/docs/zh-tw/guides/configuring-astro.mdx b/src/content/docs/zh-tw/guides/configuring-astro.mdx
new file mode 100644
index 0000000000000..f3794c6f7808d
--- /dev/null
+++ b/src/content/docs/zh-tw/guides/configuring-astro.mdx
@@ -0,0 +1,171 @@
+---
+title: 設定 Astro
+i18nReady: true
+---
+import ReadMore from '~/components/ReadMore.astro'
+
+要自訂 Astro 怎麽運作，可以在專案加入 `astro.config.mjs` 檔案。這是 Astro 專案常見的檔案，所有官方的範例模板和主題預設都帶有一個。
+
+<ReadMore>閱讀 Astro 的 [API 設定參考](/zh-tw/reference/configuration-reference/)以完整了解所有支援的設定選項。</ReadMore>
+
+## Astro 設定檔
+
+Astro 設定檔案必須使用 `default` export 匯出設定。建議搭配 `defineConfig` 輔助函式：
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // 這邊放你的設定選項...
+  // https://docs.astro.build/zh-tw/reference/configuration-reference/
+})
+```
+
+我們推薦使用 `defineConfig()`，這樣你的 IDE 會自動顯示型別提示，不過這不是必須的。最低限度的有效設定檔案看起來像這樣：
+
+```js title="astro.config.mjs"
+// 範例：最低限度的空設定檔案
+export default {}
+```
+
+## 支援的設定檔類型
+
+Astro 的 JavaScript 設定檔支援幾個格式：`astro.config.js`、`astro.config.mjs`、`astro.config.cjs` 以及 `astro.config.ts`。我們推薦在多數情況下使用 `.mjs`，如果你想要用 TypeScript 的話就用 `.ts`。
+
+TypeScript 設定檔的載入是透過 [`tsm`](https://github.com/lukeed/tsm) 處理的，它會遵循專案的 tsconfig 選項。
+
+## 解析設定檔的位置
+
+Astro 會自動嘗試在專案根目錄解析名稱是 `astro.config.mjs` 的設定檔。如果在專案根目錄找不到設定檔，則會使用 Astro 的預設選項。
+
+```bash
+# 範例：從 ./astro.config.mjs 讀取設定
+astro build
+```
+
+如果要明確指定設定檔，可以使用 `--config` 這個 CLI 選項。它總是會以相對於你執行 `astro` CLI 指令的工作目錄的路徑進行解析。
+
+```bash
+# 範例：從這個檔案讀取設定
+astro build --config my-config-file.js
+```
+
+## 設定的 IntelliSense
+
+Astro 推薦在設定檔中使用 `defineConfig()` 輔助函式。`defineConfig()` 提供 IDE 的自動 IntelliSense 功能。就算你的設定檔案不是用 TypeScript 寫的，VSCode 之類的編輯器依然能夠讀取 Astro 的 TypeScript 型別定義，並提供自動的 jsdoc 型別提示。
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // 這邊放你的設定選項...
+  // https://docs.astro.build/zh-tw/reference/configuration-reference/
+})
+```
+
+你也可以透過 JSDoc 標註，手動提供 VSCode 型別定義：
+
+```js
+// astro.config.mjs
+export default /** @type {import('astro').AstroUserConfig} */ {
+  // 這邊放你的設定選項...
+  // https://docs.astro.build/zh-tw/reference/configuration-reference/
+}
+```
+
+## 用相對路徑指定檔案
+
+如果提供相對路徑到 `root` 或 `--root` CLI 選項，Astro 會解析該相對路徑，而非執行 `astro` CLI 指令的工作目錄。
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // 解析到現在工作目錄下的 "./foo" 資料夾
+  root: 'foo'
+})
+```
+
+Astro 會將所有其他檔案和資料夾的相對路徑字串，解析為相對於專案根目錄：
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // 解析到現在工作目錄下的 "./foo" 資料夾
+  root: 'foo',
+  // 解析到現在工作目錄下的 "./foo/public" 資料夾
+  publicDir: 'public',
+})
+```
+
+要用相對於設定檔的路徑指定檔案或資料夾，請使用 `import.meta.url`（除非你是在寫 common.js 格式的 `astro.config.cjs` 檔案）。
+
+```js "import.meta.url"
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // 解析到相對於這個設定檔案的 "./foo" 資料夾
+  root: new URL("./foo", import.meta.url).toString(),
+  // 解析到相對於這個設定檔案的 "./public" 資料夾
+  publicDir: new URL("./public", import.meta.url).toString(),
+})
+```
+
+:::note 
+設定檔內無法存取 Vite 特有的 `import.meta` 屬性（例如：`import.meta.env` 或 `import.meta.glob`）。針對這些個別案例，我們推薦用 [dotenv](https://github.com/motdotla/dotenv) 或是 [fast-glob](https://github.com/mrmlnc/fast-glob) 之類的替代品。此外，[tsconfig 的路徑別名](https://www.typescriptlang.org/tsconfig#paths)不會被解析，在這個檔案請使用相對路徑引入模組。
+:::
+
+## 自訂輸出檔名
+
+對於 Astro 處理的程式碼，像是引入的 JavaScript 或 CSS 檔案，只要在 `astro.config.*` 檔案的 `vite.build.rollupOptions` 條目使用 [`entryFileNames`](https://rollupjs.org/configuration-options/#output-entryfilenames)、[`chunkFileNames`](https://rollupjs.org/configuration-options/#output-chunkfilenames) 和 [`assetFileNames`](https://rollupjs.org/configuration-options/#output-assetfilenames)，就可以自訂它們的輸出檔名。
+
+```js ins={9-11}
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  vite: {
+    build: {
+      rollupOptions: {
+        output: {
+          entryFileNames: 'entry.[hash].mjs',
+          chunkFileNames: 'chunks/chunk.[hash].mjs',
+          assetFileNames: 'assets/asset.[hash][extname]',
+        },
+      },
+    },
+  },
+})
+```
+
+如果你的程式檔有可能因為名稱而受到廣告攔截器影響（如 `ads.js` 或 `google-tag-manager.js`），這可能會有幫助。
+
+## 環境變數
+
+Astro 會在載入其他檔案前評估設定檔，因此你不能使用 `import.meta.env` 存取在 `.env` 檔設定的環境變數。
+
+你可以在設定檔使用 `process.env` 存取其他環境變數，像是由 CLI 設下的。
+
+也可以使用 [Vite 的 `loadEnv` 輔助函式](https://main.vite.dev/config/#using-environment-variables-in-config)手動載入 `.env` 檔。
+
+:::note
+`pnpm` 不允許引入沒在專案中直接安裝的模組。如果你用的是 `pnpm`，則需要安裝 `vite` 才能使用 `loadEnv` 輔助函式。
+```sh
+pnpm add vite --save-dev
+```
+:::
+
+```js title="astro.config.mjs"
+import { loadEnv } from "vite";
+const { SECRET_PASSWORD } = loadEnv(process.env.NODE_ENV, process.cwd(), "");
+```
+
+## 設定參考
+
+<ReadMore>閱讀 Astro 的 [API 設定參考](/zh-tw/reference/configuration-reference/)以完整了解所有支援的設定選項。</ReadMore>

From 2465465a264dac17cdcee6f2c0a88054a3303ea3 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 22:35:11 +0900
Subject: [PATCH 08/43] i18n(ko-KR): update
 `actions-returned-invalid-data-error.mdx` (#9810)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../ko/reference/errors/actions-returned-invalid-data-error.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/ko/reference/errors/actions-returned-invalid-data-error.mdx b/src/content/docs/ko/reference/errors/actions-returned-invalid-data-error.mdx
index fa1210da8aef3..65cb4b86f4062 100644
--- a/src/content/docs/ko/reference/errors/actions-returned-invalid-data-error.mdx
+++ b/src/content/docs/ko/reference/errors/actions-returned-invalid-data-error.mdx
@@ -10,6 +10,6 @@ githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/
 액션 핸들러가 잘못된 데이터를 반환했습니다. 핸들러는 직렬화 가능한 데이터 타입을 반환해야 하며 응답 객체를 반환할 수 없습니다.
 
 **더 보기:**
--  [Actions 핸들러 참조](/ko/reference/api-reference/#handler-속성)
+-  [Actions 핸들러 참조](/ko/reference/modules/astro-actions/#handler-속성)
 
 

From ce57a732198bb7d0f30d1cb9b4951962cde6ceaf Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 22:43:38 +0900
Subject: [PATCH 09/43] i18n(ko-KR): update `content-collections.mdx` (#9804)

* i18n(ko-KR): update `content-collections.mdx`

* fix: update wrong link

---------

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 src/content/docs/ko/guides/content-collections.mdx | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/content/docs/ko/guides/content-collections.mdx b/src/content/docs/ko/guides/content-collections.mdx
index 55614519b4132..827339e87f9ce 100644
--- a/src/content/docs/ko/guides/content-collections.mdx
+++ b/src/content/docs/ko/guides/content-collections.mdx
@@ -51,7 +51,7 @@ Astro는 프로젝트의 `.astro` 디렉터리에 콘텐츠 컬렉션을 위한
 
 <FileTree>
 - src/content/
-  - **newsletter/** 
+  - **newsletter/**
     - week-1.md
     - week-2.md
   - **blog/**
@@ -306,7 +306,7 @@ relatedPosts:
 
 ### 사용자 정의 슬러그 정의
 
-`type: 'content'`를 사용하면 모든 콘텐츠 항목은 해당 [파일 `id`](/ko/reference/api-reference/#id)에서 URL 친화적인 `slug` 속성을 생성합니다. 슬러그는 컬렉션에서 직접 항목을 쿼리하는 데 사용됩니다. 콘텐츠에서 새 페이지와 URL을 만들 때도 유용합니다.
+`type: 'content'`를 사용하면 모든 콘텐츠 항목은 해당 [파일 `id`](/ko/reference/modules/astro-content/#id)에서 URL 친화적인 `slug` 속성을 생성합니다. 슬러그는 컬렉션에서 직접 항목을 쿼리하는 데 사용됩니다. 콘텐츠에서 새 페이지와 URL을 만들 때도 유용합니다.
 
 파일 앞부분에 자신만의 `slug` 속성을 추가하여 항목에서 생성된 슬러그를 재정의할 수 있습니다. 이는 다른 웹 프레임워크의 "permalink" 기능과 유사합니다. `"slug"`는 사용자 정의 컬렉션 `스키마`에서 허용되지 않는 특수 예약 속성 이름이며 항목의 `data` 속성에 표시되지 않습니다.
 
@@ -320,7 +320,7 @@ slug: my-custom-slug/supports/slashes
 
 ## 컬렉션 쿼리
 
-Astro는 컬렉션을 쿼리하고 하나 이상의 콘텐츠 항목을 반환하는 두 가지 함수를 제공합니다: [`getCollection()`](/ko/reference/api-reference/#getcollection) 및 [`getEntry()`](/ko/reference/api-reference/#getentry).
+Astro는 컬렉션을 쿼리하고 하나 이상의 콘텐츠 항목을 반환하는 두 가지 함수를 제공합니다: [`getCollection()`](/ko/reference/modules/astro-content/#getcollection) 및 [`getEntry()`](/ko/reference/modules/astro-content/#getentry).
 
 ```js
 import { getCollection, getEntry } from 'astro:content';
@@ -337,7 +337,7 @@ const allBlogPosts = await getCollection('blog');
 const graceHopperProfile = await getEntry('authors', 'grace-hopper');
 ```
 
-두 함수 모두 [`CollectionEntry`](/ko/reference/api-reference/#컬렉션-항목-타입) 타입에 정의된 대로 콘텐츠 항목을 반환합니다.
+두 함수 모두 [`CollectionEntry`](/ko/reference/modules/astro-content/#collectionentry) 타입에 정의된 대로 콘텐츠 항목을 반환합니다.
 
 ### 참조 데이터 엑세스
 
@@ -432,7 +432,7 @@ const blogEntries = await getCollection('blog');
 
 컴포넌트는 전체 콘텐츠 항목을 prop으로 전달할 수도 있습니다.
 
-이렇게 하면 TypeScript를 사용하여 컴포넌트 props의 타입을 올바르게 구성하기 위해 [`CollectionEntry`](/ko/reference/api-reference/#컬렉션-항목-타입) 유틸리티를 사용할 수 있습니다. 이 유틸리티는 컬렉션 스키마 이름과 일치하는 문자열 인수를 사용하고 해당 컬렉션 스키마의 모든 속성을 상속합니다.
+이렇게 하면 TypeScript를 사용하여 컴포넌트 props의 타입을 올바르게 구성하기 위해 [`CollectionEntry`](/ko/reference/modules/astro-content/#collectionentry) 유틸리티를 사용할 수 있습니다. 이 유틸리티는 컬렉션 스키마 이름과 일치하는 문자열 인수를 사용하고 해당 컬렉션 스키마의 모든 속성을 상속합니다.
 
 ```astro /CollectionEntry(?:<.+>)?/
 ---
@@ -501,7 +501,7 @@ const { Content } = await entry.render();
 
 ### 서버 출력용 빌드 (SSR)
 
-Astro의 SSR 지원을 사용하여 동적 웹 사이트를 구축하는 경우 빌드 중 미리 경로를 생성할 것으로 예상되지 않습니다. 대신 페이지에서는 요청 (`Astro.request` 또는 `Astro.params` 사용)을 검사하여 필요에 따라 슬러그를 찾은 다음 [`getEntry()`](/ko/reference/api-reference/#getentry)를 사용하여 가져와야 합니다.
+Astro의 SSR 지원을 사용하여 동적 웹 사이트를 구축하는 경우 빌드 중 미리 경로를 생성할 것으로 예상되지 않습니다. 대신 페이지에서는 요청 (`Astro.request` 또는 `Astro.params` 사용)을 검사하여 필요에 따라 슬러그를 찾은 다음 [`getEntry()`](/ko/reference/modules/astro-content/#getentry)를 사용하여 가져와야 합니다.
 
 ```astro
 ---
@@ -530,7 +530,7 @@ const { Content } = await entry.render();
 ## 파일 기반 라우팅에서 마이그레이션
 
 `src/pages/` 디렉터리의 하위 폴더에 있는 Markdown 또는 MDX 파일을 사용하는 블로그와 같은 기존 Astro 프로젝트가 있는 경우 관련 콘텐츠 또는 데이터 파일을 콘텐츠 컬렉션으로 마이그레이션하는 것을 고려하세요.
- 
+
 [블로그 만들기 튜토리얼의 완성된 프로젝트](https://github.com/withastro/blog-tutorial-demo)의 코드베이스를 사용하는 [단계별 튜토리얼](/ko/tutorials/add-content-collections/)에서 기본 블로그 예시를 `src/pages/posts/` 디렉터리에서 `src/content/posts` 디렉터리로 변환하는 방법을 알아보세요.
 
 ## JSON 스키마 생성 활성화

From 39b6cc3829768dd0671c012437b1827122a5b5d8 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Sat, 26 Oct 2024 23:01:22 +0900
Subject: [PATCH 10/43] i18n(ko-KR): update `api-reference.mdx` (#9812)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../docs/ko/reference/api-reference.mdx       | 1537 +----------------
 1 file changed, 7 insertions(+), 1530 deletions(-)

diff --git a/src/content/docs/ko/reference/api-reference.mdx b/src/content/docs/ko/reference/api-reference.mdx
index 0b73465ccd9e5..90a84805e1d56 100644
--- a/src/content/docs/ko/reference/api-reference.mdx
+++ b/src/content/docs/ko/reference/api-reference.mdx
@@ -1,6 +1,9 @@
 ---
-title: API 참조
+title: Astro 런타임 API
 i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 4
 ---
 import Since from '~/components/Since.astro';
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
@@ -1008,7 +1011,7 @@ export function GET({ redirect }: APIContext) {
 <Since v="4.13.0" />
 </p>
 
-브라우저를 새 페이지로 리디렉션하지 않고 다른 URL이나 경로에서 콘텐츠를 제공할 수 있습니다. 
+브라우저를 새 페이지로 리디렉션하지 않고 다른 URL이나 경로에서 콘텐츠를 제공할 수 있습니다.
 
 이 메서드는 경로 위치에 대한 문자열, `URL`, 또는 `Request` 중 하나를 허용합니다.
 
@@ -1239,7 +1242,7 @@ const { page } = Astro.props;
   - `pageSize` - 페이지당 표시되는 항목 수 (기본값은 `10`)
   - `params` - 동적 경로 생성을 위한 추가 매개변수 보내기
   - `props` - 각 페이지에서 사용할 수 있도록 추가 props 보내기
-  
+
 `paginate()`는 `[page].astro` 또는 `[...page].astro`라는 파일 이름을 가정합니다. `page` 매개변수는 URL의 페이지 번호가 됩니다.
 
 - `/posts/[page].astro`는 `/posts/1`, `/posts/2`, `/posts/3` 등의 URL을 생성합니다.
@@ -1375,1530 +1378,4 @@ const { page } = Astro.props;
 export default function () {
   return import.meta.env.SSR ? <div class="spinner"></div> : <FancyComponent />;
 }
-```
-
-## 이미지 (`astro:assets`)
-
-### `getImage()`
-
-<p>
-
-**타입:** `(options: UnresolvedImageTransform) => Promise<GetImageResult>`
-</p>
-
-:::caution
-`getImage()`는 서버 전용 API에 의존하며 클라이언트에서 사용될 때 빌드를 중단합니다.
-:::
-
-`getImage()` 함수는 HTML이 아닌 다른 곳 (예: [API 경로](/ko/guides/endpoints/#서버-엔드포인트-api-라우트))에서 사용할 이미지를 생성하기 위한 것입니다. 또한 사용자 정의 `<Image />` 컴포넌트를 만들 수도 있습니다.
-
-`getImage()`는 [Image 컴포넌트와 동일한 속성](#속성)을 가진 옵션 객체를 사용합니다 (`alt` 제외).
-
-```astro
----
-import { getImage } from "astro:assets";
-import myBackground from "../background.png"
-
-const optimizedBackground = await getImage({src: myBackground, format: 'avif'})
----
-
-<div style={`background-image: url(${optimizedBackground.src});`}></div>
-```
-
-다음 타입을 가진 객체를 반환합니다.
-
-
-```ts
-type GetImageResult = {
-  /* 이미지 렌더링에 필요한 추가 HTML 속성 (width, height, style 등) */
-  attributes: Record<string, any>;
-  /* 검증된 매개변수 전달 */
-  options: ImageTransform;
-  /* 원본 매개변수 전달 */
-  rawOptions: ImageTransform;
-  /* 생성된 이미지의 경로 */
-  src: string;
-  srcSet: {
-    /* 생성된 srcset의 값, 각 항목에는 URL과 크기 설명자가 있습니다. */    
-    values: SrcSetValue[];
-    /* `srcset` 속성에서 사용할 수 있는 값 */
-    attribute: string;
-  };
-}
-```
-
-## 콘텐츠 컬렉션 (`astro:content`)
-
-<p><Since v="2.0.0" /></p>
-
-콘텐츠 컬렉션은 `src/content/`에서 Markdown 또는 MDX 문서를 구성하고 쿼리하는 API를 제공합니다. 기능 및 사용 예시는 [콘텐츠 컬렉션 안내서를 참조하세요](/ko/guides/content-collections/).
-
-### `defineCollection()`
-
-<p>
-
-**타입:** `(input: CollectionConfig) => CollectionConfig`
-</p>
-
-`defineCollection()`은 `src/content/config.*` 파일에 컬렉션을 구성하는 유틸리티입니다.
-
-```ts
-// src/content/config.ts
-import { z, defineCollection } from 'astro:content';
-const blog = defineCollection({
-  type: 'content',
-  schema: z.object({
-    title: z.string(),
-    permalink: z.string().optional(),
-  }),
-});
-
-// 'collections' 내보내기를 통해 정의된 컬렉션을 Astro에 노출하세요.
-export const collections = { blog };
-```
-
-이 함수는 다음 속성을 허용합니다.
-
-#### `type`
-
-<p>
-
-**타입:** `'content' | 'data'`<br />
-**기본값:** `'content'`<br />
-<Since v="2.5.0" />
-</p>
-
-`type`은 컬렉션에 저장된 항목의 형식을 정의하는 문자열입니다.
-
-- `'content'` - Markdown (`.md`), MDX (`.mdx`), Markdoc (`.mdoc`)와 같은 콘텐츠 작성 형식
-- `'data'` - JSON (`.json`) 또는 YAML (`.yaml`)과 같은 데이터 전용 형식의 경우
-
-:::tip
-즉, 컬렉션은 콘텐츠와 데이터 형식을 혼합하여 저장할 수 **없습니다**. 이러한 항목을 유형별로 별도의 컬렉션으로 분할해야 합니다.
-:::
-
-#### `schema`
-
-<p>
-
-**타입:** <code>ZodType | (context: <a href="#schemacontext">SchemaContext</a>) => ZodType</code>
-</p>
-
-`schema`는 컬렉션에 대한 문서 프런트매터의 타입과 모양을 구성하는 선택적 Zod 객체입니다. 각 값은 [Zod 유효성 검사기](https://github.com/colinhacks/zod)를 사용해야 합니다.
-
-사용 예시는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#컬렉션-스키마-정의).
-
-### `reference()`
-
-<p>
-
-**타입:** `(collection: string) => ZodEffects<ZodString, { collection, id: string } | { collection, slug: string }>`<br />
-<Since v="2.5.0" />
-</p>
-
-`reference()` 함수는 콘텐츠 구성에서 한 컬렉션에서 다른 컬렉션으로의 관계 또는 "reference"를 정의하는 데 사용됩니다. 이는 컬렉션 이름을 전달받고 콘텐츠 프런트매터 또는 데이터 파일에 지정된 항목 식별자의 유효성을 검사합니다.
-
-이 예시에서는 `authors` 컬렉션에 대한 블로그 작성자의 참조와 동일한 `blog` 컬렉션에 대한 관련 게시물 배열을 정의합니다.
-
-```ts
-import { defineCollection, reference, z } from 'astro:content';
-
-const blog = defineCollection({
-  type: 'content',
-  schema: z.object({
-    // `id`로 `authors` 컬렉션에서 단일 저자 참조
-    author: reference('authors'),
-    // `slug`의 `blog` 컬렉션에서 관련 게시물 배열을 참조하세요.
-    relatedPosts: z.array(reference('blog')),
-  })
-});
-
-const authors = defineCollection({
-  type: 'data',
-  schema: z.object({ /* ... */ })
-});
-
-export const collections = { blog, authors };
-```
-
-사용 예는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#컬렉션-참조-정의하기).
-
-### `getCollection()`
-
-<p>
-
-**타입:** `(collection: string, filter?: (entry: CollectionEntry<TCollectionName>) => boolean) => CollectionEntry<TCollectionName>[]`
-</p>
-
-`getCollection()`은 컬렉션 이름별로 콘텐츠 컬렉션 항목 목록을 검색하는 함수입니다.
-
-기본적으로 컬렉션의 모든 항목을 반환하고 항목 속성별로 범위를 좁힐 수 있는 선택적 `filter` 함수를 허용합니다. 이를 통해 `data` 객체를 통해 `id`, `slug` 또는 프런트매터 값을 기반으로 컬렉션의 일부 항목만 쿼리할 수 있습니다.
-
-```astro
----
-import { getCollection } from 'astro:content';
-
-// Get all `src/content/blog/` entries
-const allBlogPosts = await getCollection('blog');
-
-// 프런트매터에 `draft: true`가 포함된 게시물만 반환합니다.
-const draftBlogPosts = await getCollection('blog', ({ data }) => {
-  return data.draft === true;
-});
----
-```
-
-사용 예시는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#컬렉션-쿼리).
-
-### `getEntry()`
-
-<p><Since v="2.5.0" /></p>
-
-**타입:**
-- `(collection: string, contentSlugOrDataId: string) => CollectionEntry<TCollectionName>`
-- `({ collection: string, id: string }) => CollectionEntry<TCollectionName>`
-- `({ collection: string, slug: string }) => CollectionEntry<TCollectionName>`
-
-`getEntry()`는 컬렉션 이름과 항목 `id` (`type: 'data'` 컬렉션의 경우) 또는 항목 `slug` (`type: 'content'` 컬렉션의 경우)로 단일 컬렉션 항목을 검색하는 함수입니다. `getEntry()`는 `data`, `body`, `render()` 속성에 액세스하기 위해 참조된 항목을 가져오는 데에도 사용할 수 있습니다.
-
-```astro
----
-import { getEntry } from 'astro:content';
-
-// Get `src/content/blog/enterprise.md`
-const enterprisePost = await getEntry('blog', 'enterprise');
-
-// Get `src/content/captains/picard.yaml`
-const picardProfile = await getEntry('captains', 'picard');
-
-// `data.captain`이 참조하는 프로필 가져오기
-const enterpriseCaptainProfile = await getEntry(enterprisePost.data.captain);
----
-```
-
-[컬렉션 항목 쿼리](/ko/guides/content-collections/#컬렉션-쿼리)의 예시는 `콘텐츠 컬렉션` 안내서를 참조하세요.
-
-### `getEntries()`
-
-<p><Since v="2.5.0" /></p>
-
-**타입:**
-- `(Array<{ collection: string, id: string }>) => CollectionEntry<TCollectionName>[]`
-- `(Array<{ collection: string, slug: string }>) => CollectionEntry<TCollectionName>[]`
-
-`getEntries()`는 동일한 컬렉션에서 여러 컬렉션 항목을 검색하는 함수입니다. 이는 [참조된 항목의 배열을 반환](/ko/guides/content-collections/#컬렉션-참조-정의하기)하여 관련 `data`, `body`, `render()` 속성에 액세스하는 데 유용합니다.
-
-```astro
----
-import { getEntries } from 'astro:content';
-
-const enterprisePost = await getEntry('blog', 'enterprise');
-
-// `data.relatedPosts`에 의해 참조되는 관련 게시물 가져오기
-const enterpriseRelatedPosts = await getEntries(enterprisePost.data.relatedPosts);
----
-```
-
-### `getEntryBySlug()`
-
-<p>
-
-**타입:** `(collection: string, slug: string) => Promise<CollectionEntry<TCollectionName>>`
-</p>
-
-:::caution[Deprecated]
-콘텐츠 항목을 쿼리하려면 [`getEntry()` 함수](#getentry)를 사용하세요. 이는 `getEntryBySlug()`와 동일한 인수를 허용하며 JSON 또는 YAML 컬렉션에 대해 `id`를 통한 쿼리를 지원합니다.
-:::
-
-`getEntryBySlug()`는 컬렉션 이름과 항목 `slug`로 단일 컬렉션 항목을 검색하는 함수입니다.
-
-```astro
----
-import { getEntryBySlug } from 'astro:content';
-
-const enterprise = await getEntryBySlug('blog', 'enterprise');
----
-```
-
-사용 예시는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#컬렉션-쿼리).
-
-### `getDataEntryById()`
-
-<p>
-
-**타입:** `(collection: string, id: string) => Promise<CollectionEntry<TCollectionName>>`<br />
-<Since v="2.5.0" />
-</p>
-
-:::caution[더 이상 사용되지 않음]
-데이터 항목을 쿼리하려면 [`getEntry()` 함수](#getentry)를 사용합니다. 이 함수는 `getDataEntryById()`와 동일한 인수를 전달받으며, Markdown과 같은 콘텐츠 작성 형식의 경우 `slug`로 쿼리할 수 있습니다.
-:::
-
-`getDataEntryById()`는 컬렉션 이름과 항목 `id`로 단일 컬렉션 항목을 검색하는 함수입니다.
-
-
-```astro
----
-import { getDataEntryById } from 'astro:content';
-const picardProfile = await getDataEntryById('captains', 'picard');
----
-```
-
-### 컬렉션 항목 타입
-
-[`getCollection()`](#getcollection), [`getEntry()`](#getentry), [`getEntries()`](#getentries)를 포함한 쿼리 함수는 각각 `CollectionEntry` 타입의 항목을 반환합니다. 이 타입은 `astro:content`에서 유틸리티로 사용할 수 있습니다.
-
-```ts
-import type { CollectionEntry } from 'astro:content';
-```
-
-`CollectionEntry<TCollectionName>` 타입은 다음 값을 갖는 객체입니다. `TCollectionName`은 쿼리 중인 컬렉션의 이름입니다 (예: `CollectionEntry<'blog'>`).
-
-#### `id`
-
-**사용 가능 대상:** `type: 'content'` 및 `type: 'data'` 컬렉션    
-**타입 예시:**
-  - 콘텐츠 컬렉션: `'entry-1.md' | 'entry-2.md' | ...`
-  - 데이터 컬렉션: `'author-1' | 'author-2' | ...`
-
-`src/content/[collection]`에 상대적인 파일 경로를 사용하는 고유 ID입니다. 컬렉션 항목 파일 경로를 기반으로 가능한 모든 문자열 값을 열거합니다. [`type: 'content'`로 정의된](#type) 컬렉션은 ID에 파일 확장자를 포함하지만 `type: 'data'`로 정의된 컬렉션은 포함하지 않습니다.
-
-#### `collection`
-
-**사용 가능 대상:** `type: 'content'` 및 `type: 'data'` 컬렉션    
-**타입 예시:** `'blog' | 'authors' | ...`
-
-항목이 위치한 `src/content/` 아래의 최상위 폴더 이름입니다. 이는 스키마 및 쿼리 함수에서 컬렉션을 참조하는 데 사용되는 이름입니다.
-
-#### `data`
-
-**사용 가능 대상:** `type: 'content'` 및 `type: 'data'` 컬렉션    
-**타입:** `CollectionSchema<TCollectionName>`
-
-컬렉션 스키마에서 추론된 프런트매터 속성의 객체입니다 ([`defineCollection()` 참조를 확인하세요](#definecollection)). 스키마가 구성되지 않은 경우 기본값은 `any`입니다.
-
-#### `slug`
-
-**사용 가능 대상:** `type: 'content'` 컬렉션 전용      
-**타입 예시:** `'entry-1' | 'entry-2' | ...`
-
-Markdown 또는 MDX 문서용 URL 지원 슬러그입니다. 파일 확장자가 없는 `id`가 기본값이지만 파일의 프런트매터에서 [`slug` 속성](/ko/guides/content-collections/#사용자-정의-슬러그-정의)을 설정하여 재정의할 수 있습니다.
-
-#### `body`
-
-**사용 가능 대상:** `type: 'content'` 컬렉션 전용  
-**타입:** `string`
-
-Markdown 또는 MDX 문서의 컴파일되지 않은 원시 본문을 포함하는 문자열입니다.
-
-#### `render()`
-
-**사용 가능 대상:** `type: 'content'` 컬렉션 전용  
-**타입:** `() => Promise<RenderedEntry>`
-
-렌더링을 위해 지정된 Markdown 또는 MDX 문서를 컴파일하는 기능입니다. 그러면 다음 속성이 반환됩니다.
-
-- `<Content />` - Astro 파일에서 문서의 내용을 렌더링하는 데 사용되는 컴포넌트입니다.
-- `headings` - Markdown 및 MDX 가져오기에 대해 생성된 제목 목록, [Astro의 `getHeadings()` 유틸리티 미러링](/ko/guides/markdown-content/#사용-가능한-속성).
-- `remarkPluginFrontmatter ` - [remark 또는 rehype 플러그인이 적용된 후](/ko/guides/markdown-content/#프로그래밍-방식으로-프런트매터-수정하기) 수정된 frontmatter 객체. `any` 타입으로 설정합니다.
-
-```astro
----
-import { getEntryBySlug } from 'astro:content';
-const entry = await getEntryBySlug('blog', 'entry-1');
-
-const { Content, headings, remarkPluginFrontmatter } = await entry.render();
----
-```
-
-사용 예시는 [`콘텐츠 컬렉션` 안내서를 참조하세요](/ko/guides/content-collections/#콘텐츠를-html로-렌더링).
-
-### 기타 콘텐츠 컬렉션 타입
-
-`astro:content` 모듈은 Astro 프로젝트에서 사용할 수 있도록 다음 타입도 내보냅니다.
-
-#### `CollectionKey`
-
-<p><Since v="3.1.0" /></p>
-
-`src/content/config.*` 파일에 정의된 모든 컬렉션 이름의 문자열 통합입니다. 이 타입은 모든 컬렉션 이름을 허용하는 일반 함수를 정의할 때 유용할 수 있습니다.
-
-```ts
-import type { CollectionKey, getCollection } from 'astro:content';
-
-async function getCollection(collection: CollectionKey) {
-  return getCollection(collection);
-}
-```
-
-#### `ContentCollectionKey`
-
-<p><Since v="3.1.0" /></p>
-
-`src/content/config.*` 파일에 정의된 `type: 'content'` 컬렉션의 모든 이름에 대한 문자열 통합입니다.
-
-#### `DataCollectionKey`
-
-<p><Since v="3.1.0" /></p>
-
-`src/content/config.*` 파일에 정의된 `type: 'data'` 컬렉션의 모든 이름에 대한 문자열 통합입니다.
-
-#### `SchemaContext`
-
-`defineCollection`이 `schema`의 함수 모양을 위해 사용하는 `context` 객체입니다. 이 타입은 여러 컬렉션에 대해 재사용 가능한 스키마를 구축할 때 유용할 수 있습니다.
-
-여기에는 다음 속성이 포함됩니다.
-
-- `image` - [콘텐츠 컬렉션에서 로컬 이미지를 사용](/ko/guides/images/#콘텐츠-컬렉션의-이미지)할 수 있게 해주는 `image()` 스키마 도우미
-
-```ts
-import type { SchemaContext } from 'astro:content';
-
-export const imageSchema = ({ image }: SchemaContext) =>
-    z.object({
-        image: image(),
-        description: z.string().optional(),
-    });
-
-const blog = defineCollection({
-  type: 'content',
-  schema: ({ image }) => z.object({
-    title: z.string(),
-    permalink: z.string().optional(),
-    image: imageSchema({ image })
-  }),
-});
-```
-
-## 미들웨어 (`astro:middleware`)
-
-<p><Since v="2.6.0" /></p>
-
-미들웨어를 사용하면 페이지나 엔드포인트가 렌더링될 때마다 요청과 응답을 가로채고 동작을 동적으로 주입할 수 있습니다. 기능 및 사용 예시는 [미들웨어 안내서 참조](/ko/guides/middleware/)를 확인하세요.
-
-### `onRequest()`
-
-**타입:** `(context: APIContext, next: MiddlewareNext) => Promise<Response> | Response | Promise<void> | void`
-
-모든 페이지 또는 API 경로를 렌더링하기 전에 호출되는 `src/middleware.js`에서 내보낸 필수 함수입니다. 두 개의 인수 [context](#context) 및 [next()](#next)를 전달받습니다. `onRequest()`는 `Response`를 직접 반환하거나 `next()`를 호출하여 반환해야 합니다.
-
-```js title="src/middleware.js"
-export function onRequest (context, next) {
-    // 요청의 응답 데이터 가로채기
-    // 선택적으로 응답을 변환합니다.
-    // 응답을 직접 반환하거나 `next()` 호출 결과를 반환합니다.
-    return next();
-};
-```
-
-#### `context`
-
-<p>
-
-**타입:** `APIContext`
-</p>
-
-`onRequest()`의 첫 번째 인수는 컨텍스트 객체입니다. 이는 많은 `Astro` 전역 프로퍼티를 반영합니다.
-
-<ReadMore>컨텍스트 객체에 대해 더 자세히 알아보기 위해 [엔드포인트 컨텍스트](#엔드포인트-context)를 방문하세요.</ReadMore>
-
-#### `next()`
-
-<p>
-
-**타입:** `(rewritePayload?: string | URL | Request) => Promise<Response>`<br />
-</p>
-
-`onRequest()`의 두 번째 인수는 체인의 모든 후속 미들웨어를 호출하고 `Response`를 반환하는 함수입니다. 예를 들어, 다른 미들웨어가 응답의 HTML 본문을 수정할 수 있으며 `next()`의 결과를 기다리면 미들웨어가 이러한 변경 사항에 응답할 수 있습니다.
-
-Astro v4.13.0부터 `next()`는 새 렌더링 단계를 다시 트리거하지 않고 현재 요청을 [리라이트](/ko/guides/routing/#리라이트)하기 위해 문자열 형식의 선택적 URL 경로 매개 변수인 `URL` 또는 `Request`를 허용합니다.
-
-### `sequence()`
-
-<p>
-
-**타입:** `(...handlers: MiddlewareHandler[]) => MiddlewareHandler`
-</p>
-
-미들웨어 함수를 인수로 받아들이고 전달된 순서대로 실행하는 함수입니다.
-
-```js title="src/middleware.js"
-import { sequence } from "astro:middleware";
-
-async function validation(_, next) {...}
-async function auth(_, next) {...}
-async function greeting(_, next) {...}
-
-export const onRequest = sequence(validation, auth, greeting);
-```
-
-### `createContext()`
-
-<p>
-
-**타입:** `(context: CreateContext) => APIContext`<br />
-<Since v="2.8.0" />
-</p>
-
-Astro 미들웨어 `onRequest()` 함수에 전달될 [`APIContext`](#엔드포인트-context)를 생성하는 저수준 API입니다.
-
-이 함수는 Astro 미들웨어를 프로그래밍 방식으로 실행하기 위해 통합/어댑터에서 사용할 수 있습니다.
-
-### `trySerializeLocals()`
-
-<p>
-
-**타입:** `(value: unknown) => string`<br />
-<Since v="2.8.0" />
-</p>
-
-모든 값을 받아들여 해당 값의 직렬화된 버전 (문자열)을 반환하려고 시도하는  저수준 API입니다. 값을 직렬화할 수 없으면 함수에서 런타임 오류가 발생합니다.
-
-## 국제화 (`astro:i18n`)
-
-<p><Since v="3.5.0" /></p>
-
-이 모듈은 프로젝트에 구성된 로케일을 사용하여 URL을 생성하는 데 도움이 되는 함수를 제공합니다.
-
-i18n 라우터를 사용하여 프로젝트에 대한 경로를 생성하는 것은 페이지 경로에 영향을 주는 특정 구성 값에 따라 달라집니다. 이러한 함수를 사용하여 경로를 생성할 때 다음에 대한 개별 설정을 고려해야 합니다.
-
-- [`base`](/ko/reference/configuration-reference/#base)
-- [`trailingSlash`](/ko/reference/configuration-reference/#trailingslash)
-- [`build.format`](/ko/reference/configuration-reference/#buildformat)
-- [`site`](/ko/reference/configuration-reference/#site)
-
-또한 `defaultLocale`에 대해 이러한 함수에서 반환된 URL은 `i18n.routing` 구성을 반영합니다.
-
-기능 및 사용 예시는 [i18n 라우팅 가이드](/ko/guides/internationalization/)를 참조하세요.
-
-### `getRelativeLocaleUrl()` 
-
-<p>
-
-**타입:** `(locale: string, path?: string,  options?: GetLocaleOptions) => string`
-</p>
-
-이 함수를 사용하여 로케일의 상대 경로를 검색합니다. 해당 로케일이 존재하지 않으면 Astro는 오류를 발생시킵니다.
-
-```astro
----
-getRelativeLocaleUrl("fr");
-// /fr 반환
-getRelativeLocaleUrl("fr", "");
-// /fr 반환
-getRelativeLocaleUrl("fr", "getting-started");
-// /fr/getting-started 반환
-getRelativeLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog"
-}); 
-// /blog/fr-ca/getting-started 반환
-getRelativeLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog",
-  normalizeLocale: false
-}); 
-// /blog/fr_CA/getting-started 반환
----
-```
-
-### `getAbsoluteLocaleUrl()` 
-
-<p>
-
-**타입:** `(locale: string, path: string, options?: GetLocaleOptions) => string`
-</p>
-
-[`site`]의 값이 존재할 때 로케일의 절대 경로를 검색하려면 이 함수를 사용하세요. [`site`]가 구성되지 않은 경우 함수는 상대 URL을 반환합니다. 해당 로케일이 존재하지 않으면 Astro는 오류를 발생시킵니다.
-
-```astro title="src/pages/index.astro"
----
-// `site`가 `https://example.com`로 설정된 경우
-getAbsoluteLocaleUrl("fr"); 
-// https://example.com/fr 반환
-getAbsoluteLocaleUrl("fr", ""); 
-// https://example.com/fr 반환
-getAbsoluteLocaleUrl("fr", "getting-started"); 
-// https://example.com/fr/getting-started 반환
-getAbsoluteLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog"
-}); 
-// https://example.com/blog/fr-ca/getting-started 반환
-getAbsoluteLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog",
-  normalizeLocale: false
-}); 
-// https://example.com/blog/fr_CA/getting-started 반환
----
-```
-
-### `getRelativeLocaleUrlList()` 
-
-<p>
-
-**타입:** `(path?: string, options?: GetLocaleOptions) => string[]`
-</p>
-
-모든 로케일에 대한 상대 경로 목록을 반환하려면 [`getRelativeLocaleUrl`](#getrelativelocaleurl)처럼 이 함수를 사용하세요.
-
-### `getAbsoluteLocaleUrlList()` 
-
-<p>
-
-**타입:** `(path?: string, options?: GetLocaleOptions) => string[]`
-</p>
-
-모든 로케일에 대한 절대 경로 목록을 반환하려면 [`getAbsoluteLocaleUrl`](/ko/guides/internationalization/#사용자-정의-로케일-경로)처럼 이 함수를 사용하세요.
-
-### `getPathByLocale()` 
-
-<p>
-
-**타입:** `(locale: string) => string`
-</p>
-
-[사용자 정의 로케일 경로](/ko/guides/internationalization/#사용자-정의-로케일-경로)가 구성된 경우 하나 이상의 `codes`와 연결된 `path`를 반환하는 함수입니다.
-
-```js title="astro.config.mjs"
-export default defineConfig({
-  i18n: {
-    locales: ["es", "en", {
-      path: "french",
-      codes: ["fr", "fr-BR", "fr-CA"]
-    }]
-  }
-})
-```
-
-```astro title="src/pages/index.astro"
----
-getPathByLocale("fr"); // "french" 반환
-getPathByLocale("fr-CA"); // "french" 반환
----
-```
-
-### `getLocaleByPath()`
-
-<p>
-
-**타입:** `(path: string) => string`
-</p>
-
-로케일 `path`와 연관된 `code`를 반환하는 함수입니다.
-
-```js title="astro.config.mjs"
-export default defineConfig({
-  i18n: {
-    locales: ["es", "en", {
-      path: "french",
-      codes: ["fr", "fr-BR", "fr-CA"]
-    }]
-  }
-})
-```
-
-```astro title="src/pages/index.astro"
----
-getLocaleByPath("french"); // 구성된 첫 번째 code이기 때문에 "fr"을 반환합니다.
----
-```
-
-### `redirectToDefaultLocale()`
-
-<p>
-
-**타입:** `(context: APIContext, statusCode?: ValidRedirectStatus) => Promise<Response>`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-`i18n.routing`이 `"manual"`로 설정된 경우에만 사용할 수 있습니다.
-:::
-
-구성된 `defaultLocale`로 리디렉션되는 `Response`를 반환하는 함수입니다. 유효한 리디렉션 상태 코드를 선택적으로 허용합니다.
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { redirectToDefaultLocale } from "astro:i18n";
-
-export const onRequest = defineMiddleware((context, next) => {
-  if (context.url.pathname.startsWith("/about")) {
-    return next();
-  } else {
-    return redirectToDefaultLocale(context, 302);
-  }
-})
-```
-
-### `redirectToFallback()`
-
-<p>
-
-**타입:** `(context: APIContext, response: Response) => Promise<Response>`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-`i18n.routing`이 `"manual"`로 설정된 경우에만 사용할 수 있습니다.
-:::
-
-자체 미들웨어에서 [`i18n.fallback` 구성](/ko/reference/configuration-reference/#i18nfallback)을 사용할 수 있게 해주는 함수입니다.
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { redirectToFallback } from "astro:i18n";
-
-export const onRequest = defineMiddleware(async (context, next) => {
-  const response = await next();
-  if (response.status >= 300) {
-    return redirectToFallback(context, response)
-  }
-  return response;
-})
-```
-
-### `notFound()`
-
-<p>
-
-**타입:** `(context: APIContext, response?: Response) => Promise<Response> | undefined`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-`i18n.routing`이 `"manual"`로 설정된 경우에만 사용할 수 있습니다.
-:::
-
-다음과 같은 경우 라우팅 미들웨어에서 이 함수를 사용하여 404를 반환합니다. 
-- 현재 경로가 루트가 아닌 경우. 예를 들어 `/` 또는 `/<base>` 
-- URL에 로케일이 포함되어 있지 않은 경우
-
-`Response`가 전달되면 이 함수에서 내보낸 새 `Response`에는 원래 응답과 동일한 헤더가 포함됩니다.
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { notFound } from "astro:i18n";
-
-export const onRequest = defineMiddleware((context, next) => {
-  const pathNotFound = notFound(context);
-  if (pathNotFound) {
-    return pathNotFound;
-  }
-  return next();
-})
-```
-
-### `middleware()`
-
-<p>
-
-**타입:** `(options: { prefixDefaultLocale: boolean, redirectToDefaultLocale: boolean }) => MiddlewareHandler`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-`i18n.routing`이 `"manual"`로 설정된 경우에만 사용할 수 있습니다.
-:::
-
-Astro i18n 미들웨어를 프로그래밍 방식으로 생성할 수 있는 함수입니다.
-
-이는 기본 i18n 로직을 계속 사용하고 싶지만 웹 사이트에 몇 가지 예외만 추가하려는 경우에 유용합니다.
-
-```js title="middleware.js"
-import { middleware } from "astro:i18n";
-import { sequence, defineMiddleware } from "astro:middleware";
-
-const customLogic = defineMiddleware(async (context, next) => {
-  const response = await next();
-
-  // 응답을 해결한 후 사용자 정의 로직.
-  // Astro i18n 미들웨어에서 오는 응답을 캐치할 수 있습니다.
-
-  return response;
-});
-
-export const onRequest = sequence(customLogic, middleware({
-	prefixDefaultLocale: true,
-	redirectToDefaultLocale: false
-}))
-```
-
-### `requestHasLocale()`
-
-<p>
-
-**타입:** `(context: APIContext) => boolean`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-`i18n.routing`이 `"manual"`로 설정된 경우에만 사용할 수 있습니다.
-:::
-
-현재 URL에 구성된 로케일이 포함되어 있는지 확인합니다. 내부적으로 이 함수는 `APIContext#url.pathname`을 사용합니다.
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { requestHasLocale } from "astro:i18n";
-
-export const onRequest = defineMiddleware(async (context, next) => {
-  if (requestHasLocale(context)) {
-    return next();
-  }
-  return new Response("Not found", { status: 404 });
-})
-```
-
-## View Transitions 클라이언트 API (`astro:transitions/client`)
-
-<p><Since v="3.2.0" /></p>
-
-이 모듈은 View Transitions API 및 클라이언트 측 라우터를 제어하고 상호 작용하는 함수를 제공합니다.
-
-기능 및 사용 예시는 [View Transitions 가이드](/ko/guides/view-transitions/)를 참조하세요.
-
-### `navigate()`
-
-<p>
-
-**타입:** `(href: string, options?: Options) => void`<br />
-<Since v="3.2.0" />
-</p>
-
-View Transitions API를 사용하여 지정된 `href`로 탐색을 실행하는 함수입니다.
-
-이 함수 시그니처는 [브라우저 Navigation API의 `navigate`](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate) 함수를 기반으로 합니다. 이 함수는 Navigation API를 기반으로 하지만, 페이지를 다시 로드하지 않고 탐색할 수 있도록 [History API](https://developer.mozilla.org/ko/docs/Web/API/History_API) 위에 구현되어 있습니다.
-
-#### `history` 옵션
-
-<p>
-
-**타입:** `'auto' | 'push' | 'replace'`<br />
-**기본값:** `'auto'`<br />
-<Since v="3.2.0" />
-</p>
-
-이 탐색을 브라우저 기록에 추가하는 방법을 정의합니다.
-
-- `'push'`: 라우터는 `history.pushState`를 사용하여 브라우저 기록에 새 항목을 생성합니다.
-- `'replace'`: 라우터는 `history.replaceState`를 사용하여 탐색에 새 항목을 추가하지 않고 URL을 업데이트합니다.
-- `'auto'` (기본값): 라우터는 `history.pushState`를 시도하지만, URL을 전환할 수 없는 경우 현재 URL은 브라우저 기록을 변경하지 않고 그대로 유지됩니다.
-
-이 옵션은 브라우저 Navigation API의 [`history` 옵션](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#history)을 따르지만, Astro 프로젝트에서 발생할 수 있는 경우를 위해 단순화되었습니다.
-
-#### `formData` 옵션
-
-<p>
-
-**타입:** `FormData`<br />
-<Since v="3.5.0" />
-</p>
-
-`POST` 요청을 위한 `FormData` 객체입니다.
-
-이 옵션을 제공하면 탐색 대상 페이지에 대한 요청이 양식 데이터 객체를 콘텐츠로 하는 `POST` 요청으로 전송됩니다.
-
-view transitions가 활성화된 HTML 양식을 제출하면 페이지 새로 고침이 있는 기본 탐색 대신 이 메서드가 사용됩니다. 이 메서드를 호출하면 프로그래밍 방식으로 동일한 동작을 트리거할 수 있습니다.
-
-#### `info` 옵션
-
-<p>
-
-**타입:** `any`<br />
-<Since v="3.6.0" />
-</p>
-
-이 탐색으로 인해 발생하는 `astro:before-preparation` 및 `astro:before-swap` 이벤트에 포함될 임의의 데이터입니다.
-
-이 옵션은 브라우저 Navigation API의 [`info` 옵션](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#info)을 모방합니다.
-
-#### `state` 옵션
-
-<p>
-
-**타입:** `any`<br />
-<Since v="3.6.0" />
-</p>
-
-이 탐색에서 생성된 `NavitationHistoryEntry` 객체에 연결할 임의의 데이터입니다. 이 데이터는 History API의 [`history.getState` 함수](https://developer.mozilla.org/en-US/docs/Web/API/NavigationHistoryEntry/getState)를 사용하여 검색할 수 있습니다.
-
-이 옵션은 브라우저 Navigation API의 [`state` 옵션](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#state)을 모방합니다.
-
-#### `sourceElement` 옵션
-
-<p>
-
-**타입:** `Element`<br />
-<Since v="3.6.0" />
-</p>
-
-이 탐색을 트리거한 요소 (있는 경우)입니다. 이 요소는 다음 이벤트에서 사용할 수 있습니다:
-- `astro:before-preparation`
-- `astro:before-swap`
-
-### `supportsViewTransitions`
-
-<p>
-
-**타입:** `boolean`<br />
-<Since v="3.2.0" />
-</p>
-
-현재 브라우저에서 view transitions가 지원되고 활성화되어 있는지 여부입니다.
-
-### `transitionEnabledOnThisPage`
-
-<p>
-
-**타입:** `boolean`<br />
-<Since v="3.2.0" />
-</p>
-
-현재 페이지에 클라이언트 측 탐색을 위한 view transitions가 활성화되어 있는지 여부입니다. view transitions가 있는 페이지에서 사용할 때 다르게 동작하는 컴포넌트를 만드는 데 사용할 수 있습니다.
-
-### `getFallback`
-
-<p>
-
-**타입:** `() => 'none' | 'animate' | 'swap'`<br />
-<Since v="3.6.0" />
-</p>
-
-view transitions를 지원하지 않는 브라우저에서 사용할 대체 전략을 반환합니다.
-
-대체 동작을 선택하고 구성하는 방법은 [대체 제어](/ko/guides/view-transitions/#대체-제어) 가이드를 참조하세요.
-
-
-### `astro:before-preparation` 이벤트
-
-View Transitions를 사용하여 탐색을 시작할 때 전송되는 이벤트입니다. 이 이벤트는 요청이 이루어지고 브라우저 상태가 변경되기 전에 발생합니다.
-
-이 이벤트에는 속성이 있습니다:
-- [`info`](#info)
-- [`sourceElement`](#sourceelement)
-- [`navigationType`](#navigationtype)
-- [`direction`](#direction)
-- [`from`](#from)
-- [`to`](#to)
-- [`formData`](#formdata)
-- [`loader`](#loader)
-
-이 이벤트의 사용 방법에 대한 자세한 내용은 [View Transitions 가이드](/ko/guides/view-transitions/#astrobefore-preparation)에서 확인하세요.
-
-### `astro:after-preparation` 이벤트
-
-View Transitions를 사용하는 탐색에서 다음 페이지가 로드된 후에 전송되는 이벤트입니다.
-
-이 이벤트에는 속성이 없습니다.
-
-이 이벤트의 사용 방법에 대한 자세한 내용은 [View Transitions 가이드](/ko/guides/view-transitions/#astroafter-preparation)에서 확인하세요.
-
-### `astro:before-swap` 이벤트
-
-다음 페이지가 구문 분석되고, 준비되고, 트랜지션을 준비하면서 문서에 링크된 후, 문서 간 콘텐츠가 교환되기 전에 전송되는 이벤트입니다.
-
-이 이벤트는 취소할 수 없습니다. `preventDefault()`를 호출하는 것은 아무 작업도 하지 않습니다.
-
-이 이벤트에는 속성이 있습니다:
-- [`info`](#info)
-- [`sourceElement`](#sourceelement)
-- [`navigationType`](#navigationtype)
-- [`direction`](#direction)
-- [`from`](#from)
-- [`to`](#to)
-- [`viewTransition`](#viewtransition)
-- [`swap`](#swap)
-
-이 이벤트의 사용 방법에 대한 자세한 내용은 [View Transitions 가이드](/ko/guides/view-transitions/#astrobefore-swap)에서 확인하세요.
-
-### `astro:after-swap` 이벤트 
-
-페이지의 콘텐츠가 교체된 후, view transition이 끝나기 전에 전달되는 이벤트입니다.
-
-이 이벤트가 트리거될 때는, 이미 기록 항목과 스크롤 위치가 업데이트된 후입니다.
-
-### `astro:page-load` 이벤트 
-
-view transitions을 사용한 탐색이나 브라우저의 기본 기능으로 페이지 로드가 완료된 후 전달되는 이벤트입니다.
-
-페이지에서 view transitions가 활성화되면 일반적으로 `DOMContentLoaded`에서 실행되는 코드가 이 이벤트에서 실행되도록 변경되어야 합니다.
-
-### View Transitions 이벤트 속성 
-
-<p><Since v="3.6.0" /></p>
-
-#### `info`
-
-<p>
-
-**타입:** `URL`
-</p>
-
-탐색 중에 정의된 임의의 데이터입니다.
-
-이는 [`navigate()` 함수](#navigate)의 [`info` 옵션](#info-옵션)에 전달된 리터럴 값입니다.
-
-#### `sourceElement`
-
-<p>
-
-**타입:** `Element | undefined`
-</p>
-
-탐색을 트리거한 요소입니다. 예를 들어 클릭된 `<a>` 요소가 될 수 있습니다.
-
-[`navigate()` 함수](#navigate)를 사용할 때, 이는 호출에서 지정된 요소가 됩니다.
-
-#### `newDocument`
-
-<p>
-
-**타입:** `Document`
-</p>
-
-탐색의 다음 페이지에 대한 문서입니다. 이 문서의 내용은 현재 문서의 내용 대신 교체됩니다.
-
-#### `navigationType`
-
-<p>
-
-**타입:** `'push' | 'replace' | 'traverse'`
-</p>
-
-어떤 종류의 기록 탐색이 일어나고 있나요.
-- `push`: 새 페이지에 대한 새 `NavigationHistoryEntry`가 만들어지고 있습니다.
-- `replace`: 현재 `NavigationHistoryEntry`가 새 페이지의 항목으로 대체됩니다.
-- `traverse`: `NavigationHistoryEntry`이 생성되지 않습니다. 히스토리 내 위치가 변경됩니다.
-  순회 방향은 [`direction` 속성](#direction)에 지정됩니다.
-
-#### `direction`
-
-<p>
-
-**타입:** `Direction`
-</p>
-
-트랜지션 방향입니다.
-- `forward`: 기록의 다음 페이지 또는 새 페이지로 이동합니다.
-- `back`: 기록의 이전 페이지로 이동합니다.
-- 다른 리스너가 설정했을 수 있는 기타 모든 항목.
-
-#### `from`
-
-<p>
-
-**타입:** `URL`
-</p>
-
-탐색을 시작하는 페이지의 URL입니다.
-
-#### `to`
-
-<p>
-
-**타입:** `URL`
-</p>
-
-탐색 중인 페이지의 URL입니다. 이 속성은 수정할 수 있으며, 라이프사이클이 끝날 때의 값이 다음 페이지의 `NavigationHistoryEntry`에 사용됩니다.
-
-#### `formData`
-
-<p>
-
-**타입:** `FormData | undefined`
-</p>
-
-`POST` 요청을 위한 `FormData` 객체입니다.
-
-이 속성을 설정하면 일반적인 `GET` 요청 대신 지정된 양식 데이터 객체를 콘텐츠로 하는 `POST` 요청이 [`to` URL](#to)로 전송됩니다.
-
-view transitions가 활성화된 HTML 양식을 제출할 때 이 필드는 양식의 데이터로 자동 설정됩니다. [`navigate()` 함수](#navigate)를 사용하는 경우 이 값은 옵션에 지정된 것과 동일합니다.
-
-#### `loader`
-
-<p>
-
-**타입:** `() => Promise<void>`
-</p>
-
-탐색에서 다음 단계 (다음 페이지 로딩)를 구현합니다. 이 구현을 재정의하여 동작을 추가할 수 있습니다.
-
-#### `viewTransition`
-
-<p>
-
-**타입:** [`ViewTransition`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransition)
-</p>
-
-이 탐색에 사용된 view transition 객체입니다. [View Transitions API](https://developer.mozilla.org/ko/docs/Web/API/View_Transitions_API)를 지원하지 않는 브라우저에서는 편의를 위해 동일한 API를 구현하지만 DOM 통합이 없는 객체입니다.
-
-#### `swap`
-
-<p>
-
-**타입:** `() => void`
-</p>
-
-문서 스왑 로직 구현.
-
-[나만의 사용자 지정 스왑 함수](/ko/guides/view-transitions/#사용자-정의-스왑-함수-구현)를 구축하는 방법에 대한 자세한 내용은 View Transitions 가이드를 참조하세요.
-
-기본적으로 이 구현은 다음 함수를 순서대로 호출합니다:
-
-##### `deselectScripts()`
-
-<p>
-
-**타입:** `(newDocument: Document) => void`
-</p>
-
-새 문서에서 실행해서는 안 되는 스크립트를 표시합니다. 이러한 스크립트는 이미 현재 문서에 있으며 [`data-astro-rerun`](/ko/guides/view-transitions/#data-astro-rerun)을 사용하여 다시 실행하도록 플래그가 지정되지 않습니다.
-
-##### `swapRootAttributes()`
-
-<p>
-
-**타입:** `(newDocument: Document) => void`
-</p>
-
-`lang` 속성과 같은 문서 루트 간 속성을 스왑합니다. 여기에는 `data-astro-transition`과 같은 Astro에서 삽입한 내부 속성도 포함되어 있어, 트랜지션 방향을 Astro에서 생성된 CSS 규칙에 사용할 수 있습니다.
-
-사용자 지정 스왑 함수를 만들 때, view transition의 애니메이션이 깨지지 않도록 이 함수를 호출하는 것이 중요합니다.
-
-##### `swapHeadElements()`
-
-<p>
-
-**타입:** `(newDocument: Document) => void`
-</p>
-
-현재 문서의 `<head>`에서 새 문서에 유지되지 않는 모든 요소를 제거합니다. 그런 다음 새 문서의 `<head>`에 있는 모든 새 요소를 현재 문서의 `<head>`에 추가합니다.
-
-##### `saveFocus()`
-
-<p>
-
-**타입:** `() => () => void`
-</p>
-
-현재 페이지에서 초점이 맞춰진 요소를 저장하고 호출 시 초점이 맞춰진 요소가 유지된 경우 해당 요소에 초점을 반환하는 함수를 반환합니다.
-
-
-##### `swapBodyElements()`
-
-<p>
-
-**타입:** `(newBody: Element, oldBody: Element) => void`
-</p>
-
-이전 body를 새 body로 교체합니다. 그런 다음 이전 body에서 유지되어야 하는 모든 요소를 검토하고 새 body에서 일치하는 요소를 찾아 이전 요소를 다시 제자리로 바꿉니다.
-
-## 액션 (`astro:actions`)
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-액션을 사용하면 클라이언트 코드 및 HTML 양식에서 호출할 수 있는 타입 안정성을 갖춘 백엔드를 구축할 수 있습니다. 액션을 정의하고 호출하는 모든 유틸리티는 `astro:actions` 모듈에 의해 노출됩니다. 예시 및 사용 지침은 [액션 가이드](/ko/guides/actions/)를 참조하세요.
-
-### `defineAction()`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-`defineAction()` 유틸리티는 `src/actions/index.ts` 파일에서 새 액션을 정의하는 데 사용됩니다. 이 함수는 실행할 서버 로직이 포함된 [`handler()`](#handler-속성) 함수와 런타임에 입력 매개변수를 검사하는 선택적인 [`input`](#input-유효성-검사기) 속성을 받습니다.
-
-```ts
-export const server = {
-  getGreeting: defineAction({
-    input: z.object({
-      name: z.string(),
-    }),
-    handler: async (input, context) => {
-      return `Hello, ${input.name}!`
-    }
-  })
-}
-```
-
-#### `handler()` 속성
-
-<p>
-
-**타입:** `(input, context) => any`
-</p>
-
-`defineAction()`에는 액션이 호출될 때 실행할 서버 로직이 포함된 `handler()` 함수가 필요합니다. 핸들러에서 반환된 데이터는 자동으로 직렬화되어 호출자에게 전송됩니다.
-
-`handler()`는 사용자 입력을 첫 번째 인수로 받아 호출됩니다. [`input`](#input-유효성-검사기) 유효성 검사기가 설정되어 있으면 사용자 입력은 핸들러로 전달되기 전에 유효성이 검사됩니다. 두 번째 인수는 `getActionResult()`, `callAction()` 및 `redirect()`를 제외한 대부분의 Astro [표준 엔드포인트 컨텍스트](#엔드포인트-context)를 포함하는 `context` 객체입니다.
-
-반환 값은 [devalue 라이브러리](https://github.com/Rich-Harris/devalue)를 사용하여 구문 분석됩니다. 이 라이브러리는 `Date()`, `Map()`, `Set()` 및 `URL()`의 인스턴스와 JSON 값을 지원합니다.
-
-#### `input` 유효성 검사기
-
-<p>
-
-**타입:** `ZodType | undefined`
-</p>
-
-선택적 `input` 속성은 런타임에 핸들러 입력의 유효성을 검사하기 위해 Zod 유효성 검사기를 전달받습니다. 액션이 유효성 검사에 실패하면 [`BAD_REQUEST` 오류](#actionerror)가 반환되고 `handler`가 호출되지 않습니다.
-
-`input`을 생략하면 `handler`는 JSON 요청의 경우 `unknown` 타입의 입력을, 양식 요청의 경우 `FormData` 타입의 입력을 받습니다.
-
-##### `accept: 'form'`과 함께 사용
-
-액션이 양식 입력을 전달받는 경우 `z.object()` 유효성 검사기를 사용하여 양식 데이터를 타입이 정해진 객체로 자동 구문 분석합니다. 양식 데이터 필드에 지원되는 유효성 검사기는 다음과 같습니다:
-
-- `number` 유형의 입력은 `z.number()`를 사용하여 검증할 수 있습니다.
-- `checkbox` 유형의 입력은 `z.boolean()`을 사용하여 검증할 수 있습니다.
-- `file` 유형의 입력은 `z.instanceof(File)`을 사용하여 검증할 수 있습니다.
-- 동일한 `name`의 여러 입력은 `z.array(/* validator */)`를 사용하여 검증할 수 있습니다.
-- 다른 모든 입력은 `z.string()`을 사용하여 검증할 수 있습니다.
-
-`.refine()`, `.transform()`, `.pipe()`를 포함한 확장 함수도 `z.object()` 유효성 검사기에서 지원됩니다.
-
-서로 다른 유효성 검사기의 조합을 적용하려면 `z.discriminatedUnion()` 래퍼를 사용하여 특정 양식 필드를 기준으로 타입을 좁히세요. 이 예시는 사용자 "생성" 또는 "업데이트" 중 하나로 양식 제출을 처리하며, `type`이라는 이름의 양식 필드를 사용하여 어떤 객체에 대해 유효성 검사를 수행할지 결정합니다.
-
-```ts
-import { defineAction } from 'astro:actions';
-import { z } from 'astro:schema';
-
-export const server = {
-  changeUser: defineAction({
-    accept: 'form',
-    input: z.discriminatedUnion('type', [
-      z.object({
-        // `type` 필드에 `create` 값이 있을 때 일치합니다.
-        type: z.literal('create'),
-        name: z.string(),
-        email: z.string().email(),
-      }),
-      z.object({
-        // `type` 필드에 `update` 값이 있을 때 일치합니다.
-        type: z.literal('update'),
-        id: z.number(),
-        name: z.string(),
-        email: z.string().email(),
-      }),
-    ]),
-    async handler(input) {
-      if (input.type === 'create') {
-        // input은 { type: 'create', name: string, email: string }
-      } else {
-        // input은 { type: 'update', id: number, name: string, email: string }
-      }
-    },
-  }),
-};
-```
-
-### `isInputError()`
-
-<p>
-
-**타입:** <code>(error?: unknown | <a href="#actionerror">ActionError</a>) => boolean</code><br/>
-<Since v="4.15.0" />
-</p>
-
-`isInputError()` 유틸리티는 `ActionError`가 입력 유효성 검사 오류인지 확인하는 데 사용됩니다. `input` 유효성 검사기가 `z.object()`인 경우 입력 오류에는 이름별로 그룹화된 오류 메시지가 있는 `fields` 객체가 포함됩니다.
-
-<ReadMore>[양식 입력 오류 가이드](/ko/guides/actions/#양식-입력-오류-표시)에서 `isInputError()` 사용에 대한 자세한 내용을 참조하세요.</ReadMore>
-
-### `ActionError`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-액션 `handler`가 던지는 오류를 생성하는 데 `ActionError()` 생성자가 사용됩니다. 이는 발생한 오류 (예: `"UNAUTHORIZED"`)를 설명하는 `code` 속성과 추가 세부정보가 포함된 선택적 `message` 속성을 허용합니다.
-
-#### `code`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-`code` 속성은 모든 HTTP 상태 코드의 사람이 읽을 수 있는 버전을 허용합니다. 지원되는 코드는 다음과 같습니다:
-
-- `BAD_REQUEST` (400): 클라이언트가 잘못된 입력을 보냈습니다. 이 오류는 액션 `input` 유효성 검사기가 유효성 검사에 실패할 때 발생합니다.
-- `UNAUTHORIZED` (401): 클라이언트에 유효한 인증 자격 증명이 없습니다.
-- `FORBIDDEN` (403): 클라이언트가 리소스에 액세스할 수 있는 권한이 없습니다.
-- `NOT_FOUND` (404): 서버가 요청된 리소스를 찾을 수 없습니다.
-- `METHOD_NOT_SUPPORTED` (405): 서버가 요청된 메서드를 지원하지 않습니다.
-- `TIMEOUT` (408):  서버가 요청을 처리하는 동안 시간 초과가 발생했습니다.
-- `CONFLICT` (409): 충돌로 인해 서버에서 리소스를 업데이트할 수 없습니다.
-- `PRECONDITION_FAILED` (412): 서버가 요청의 전제 조건을 충족하지 않습니다.
-- `PAYLOAD_TOO_LARGE` (413): 페이로드가 너무 커서 서버가 요청을 처리할 수 없습니다.
-- `UNSUPPORTED_MEDIA_TYPE` (415): 서버가 요청의 미디어 유형을 지원하지 않습니다. 참고: 액션은 이미 JSON 및 양식 요청에 대해 [`Content-Type` 헤더](https://developer.mozilla.org/ko/docs/Web/HTTP/Headers/Content-Type)를 확인하므로 이 코드를 수동으로 사용할 필요가 없을 것입니다.
-- `UNPROCESSABLE_CONTENT` (422): 시멘틱 오류로 인해 서버가 요청을 처리할 수 없습니다.
-- `TOO_MANY_REQUESTS` (429): 서버가 지정된 속도 제한을 초과했습니다.
-- `CLIENT_CLOSED_REQUEST` (499): 서버가 응답하기 전에 클라이언트가 요청을 종료했습니다.
-- `INTERNAL_SERVER_ERROR` (500): 서버가 예기치 않게 실패했습니다.
-- `NOT_IMPLEMENTED` (501): 서버가 요청된 기능을 지원하지 않습니다.
-- `BAD_GATEWAY` (502): 서버가 업스트림 서버로부터 잘못된 응답을 받았습니다.
-- `SERVICE_UNAVAILABLE` (503): 서버를 일시적으로 사용할 수 없습니다.
-- `GATEWAY_TIMEOUT` (504): 서버가 업스트림 서버로부터 시간 초과를 받았습니다.
-
-#### `message`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-`message` 속성은 문자열을 받습니다. (예: "사용자는 로그인해야 합니다.")
-
-## 내장 컴포넌트
-
-Astro에는 프로젝트에 사용할 수 있는 여러 내장 컴포넌트가 포함되어 있습니다. 모든 내장 컴포넌트는 `import {} from 'astro:components';`를 통해 `.astro` 파일에서 사용할 수 있습니다.
-
-[`ComponentProp` 타입](/ko/guides/typescript/#컴포넌트-props) 유틸리티를 사용하여 이 컴포넌트의 `Props`를 참조할 수 있습니다.
-
-### `<Code />`
-
-```astro 'theme="dark-plus"' /wrap\b/ /(inline) \/>/
----
-import { Code } from 'astro:components';
----
-<!-- 구문은 일부 JavaScript 코드를 강조합니다. -->
-<Code code={`const foo = 'bar';`} lang="js" />
-<!-- 선택 사항: 테마를 맞춤설정합니다. -->
-<Code code={`const foo = 'bar';`} lang="js" theme="dark-plus" />
-<!-- 선택 사항: 단어 줄 바꿈을 활성화합니다. -->
-<Code code={`const foo = 'bar';`} lang="js" wrap />
-<!-- 선택 사항: 인라인 코드를 출력합니다. -->
-<p>
-  <Code code={`const foo = 'bar';`} lang="js" inline />
-  will be rendered inline.
-</p>
-<!-- 선택 사항: defaultColor -->
-<Code code={`const foo = 'bar';`} lang="js" defaultColor={false} />
-```
-
-이 컴포넌트는 빌드 시 코드 블록에 구문 강조 표시를 제공합니다 (클라이언트 측 JavaScript는 포함되지 않음). 이 컴포넌트는 Shiki에 의해 내부적으로 구동되며 모든 인기 있는 [테마](https://shiki.style/themes) 및 [언어](https://shiki.style/languages)를 지원합니다. 또한 사용자 정의 테마, 언어, [transformers](#transformers) 및 [기본 색상](https://shiki.style/guide/dual-themes#without-default-color)을 각각 `theme`, `lang`, `transformers`, `defaultColor` 속성에 전달하여 추가할 수 있습니다.
-
-:::note
-이 컴포넌트는 [Shiki 구성](/ko/guides/markdown-content/#shiki-구성)에서 설정을 상속하지 **않습니다**. 반드시 컴포넌트 props를 사용하여 설정해야 합니다.
-:::
-
-#### Transformers
-
-<p><Since v="4.11.0" /></p>
-
-[Shiki transformers](https://shiki.style/packages/transformers#shikijs-transformers)는 `transformers` 속성에 배열로 전달하여 선택적으로 코드에 적용할 수 있습니다. Astro v4.14.0부터는 [Shiki의 `meta` 속성](https://shiki.style/guide/transformers#meta)에 문자열을 제공하여 트랜스포머에 옵션을 전달할 수도 있습니다.
-
-`transformers`는 단지 클래스만 적용하며 코드 블록의 요소를 대상으로 지정하려면 자체 CSS 규칙을 제공해야 합니다.
-
-```astro title="src/pages/index.astro" {12-13}
----
-import { transformerNotationFocus, transformerMetaHighlight } from '@shikijs/transformers'
-import { Code } from 'astro:components'
-const code = `const foo = 'hello'
-const bar = ' world'
-console.log(foo + bar) // [!code focus]
-`
----
-<Code
-  code={code}
-  lang="js"
-  transformers={[transformerMetaHighlight()]}
-  meta="{1,3}" />
-  
-  <style is:global>
-    pre.has-focused .line:not(.focused) {
-      filter: blur(1px);
-    }
-  </style>
-```
-
-### `<Fragment />`
-
-추가 래핑 요소 없이 HTML 콘텐츠를 렌더링하기 위해 [`set:*` 지시어](/ko/reference/directives-reference/#sethtml)와 함께 사용되는 컴포넌트:
-
-```astro title="src/components/SetHtml.astro" "Fragment"
----
-const htmlString = '<p>Raw HTML content</p>';
----
-<Fragment set:html={htmlString} />
-```
-
-Astro 구문의 [프래그먼트 사용](/ko/basics/astro-syntax/#프래그먼트)에 대해 자세히 알아보세요.
-
-### `<Prism />`
-
-`Prism` 구문 강조 컴포넌트를 사용하려면 먼저 `@astrojs/prism` 패키지를 **설치**하세요.
-
-<PackageManagerTabs>
-  <Fragment slot="npm">
-  ```shell
-  npm install @astrojs/prism
-  ```
-  </Fragment>
-  <Fragment slot="pnpm">
-  ```shell
-  pnpm add @astrojs/prism
-  ```
-  </Fragment>
-  <Fragment slot="yarn">
-  ```shell
-  yarn add @astrojs/prism
-  ```
-  </Fragment>
-</PackageManagerTabs>
-
-```astro
----
-import { Prism } from '@astrojs/prism';
----
-<Prism lang="js" code={`const foo = 'bar';`} />
-```
-
-이 컴포넌트는 Prism의 CSS 클래스를 적용하여 코드 블록에 대한 언어별 구문 강조를 제공합니다. 구문 강조를 표시하려면 **Prism CSS 스타일시트를 제공** (또는 자신만의 스타일시트)해야합니다! 자세한 내용은 [Prism 구성 섹션](/ko/guides/markdown-content/#prism-구성)을 참조하세요.
-
-언어에 해당하는 별칭을 찾을 수 있도록 [Prism이 지원하는 언어 목록](https://prismjs.com/#supported-languages)을 참조하세요. 그리고 `lang="astro"`를 사용하여 Astro 코드 블록을 표시할 수도 있습니다!
-
-### `<Image />`
-
-```astro title="src/components/MyComponent.astro"
----
-// Image 컴포넌트 및 이미지 가져오기
-import { Image } from 'astro:assets';
-import myImage from "../assets/my_image.png"; // 1600x900의 이미지
----
-
-<!-- Image 컴포넌트에서는 'alt'가 필수입니다. -->
-<Image src={myImage} alt="A description of my image." />
-```
-
-```html
-<!-- 결과 -->
-<!-- 이미지가 최적화되었으며 적절한 속성이 적용되었습니다. -->
-<img
-  src="/_astro/my_image.hash.webp"
-  width="1600"
-  height="900"
-  decoding="async"
-  loading="lazy"
-  alt="A description of my image."
-/>
-```
-#### 속성
-
-- src (필수)
-- alt (필수)
-- width 및 height (`public/` 및 원격 이미지를 사용하는 경우 필수)
-- format
-- quality
-- densities
-- widths
-
-위 속성 외에도 `<Image />` 컴포넌트는 HTML `<img>` 태그에서 허용하는 모든 속성을 허용합니다.
-
-[이미지 안내서](/ko/guides/images/#image--astroassets)에서 자세한 내용을 확인하세요.
-
-### `<Picture />`
-
-<p><Since v="3.3.0" /></p>
-
-다양한 형식 및/또는 크기로 반응형 이미지를 표시하려면 내장된 `<Picture />` Astro 컴포넌트를 사용하세요.
-
-```astro title="src/pages/index.astro"
----
-import { Picture } from 'astro:assets';
-import myImage from "../assets/my_image.png"; // 1600x900의 이미지
----
-
-<!-- Picture 컴포넌트에서는 'alt'가 필수입니다. -->
-<Picture src={myImage} formats={['avif', 'webp']} alt="A description of my image." />
-```
-
-```html
-<!-- 결과 -->
-<picture>
-  <source srcset="/_astro/my_image.hash.avif" type="image/avif" />
-  <source srcset="/_astro/my_image.hash.webp" type="image/webp" />
-  <img
-    src="/_astro/my_image.hash.png"
-    width="1600"
-    height="900"
-    decoding="async"
-    loading="lazy"
-    alt="A description of my image."
-  />
-</picture>
-```
-
-[이미지 안내서](/ko/guides/images/#picture-)에서 자세한 내용을 확인하세요.
-
-#### 속성
-
-`<Picture />`는 `<Image />` 컴포넌트의 모든 속성과 함께 다음을 허용합니다.
-
-##### `formats`
-
-`<source>` 태그에 사용할 이미지 형식의 배열입니다. 기본적으로 `['webp']`로 설정되어 있습니다.
-
-##### `fallbackFormat`
-
-`<img>` 태그에 대한 대체 값으로 사용할 형식입니다. 정적 이미지의 경우 기본값은 `.png`, 애니메이션 이미지의 경우 `.gif`, SVG 파일의 경우 `.svg`입니다.
-
-##### `pictureAttributes`
-
-`<picture>` 태그에 추가될 속성의 객체입니다. 이 속성을 사용하여 외부 `<picture>` 요소 자체에 속성을 적용합니다. `<Picture />` 컴포넌트에 직접 적용된 속성은 이미지 변환에 사용되는 속성을 제외하고 내부 `<img>` 요소에 적용됩니다.
-
-### `<Content />`
-
-[콘텐츠 컬렉션 항목](/ko/guides/content-collections/#콘텐츠-컬렉션이란-무엇입니까)의 콘텐츠를 렌더링하는 데 사용되는 일반 컴포넌트입니다.
-
-먼저 `getCollection()` 또는 `getEntry()`를 사용하여 하나 이상의 항목을 쿼리합니다. 그런 다음 `entry.render()` 함수는 `.astro` 파일 템플릿에 사용할 `<Content />` 컴포넌트를 반환할 수 있습니다.
-
-```astro title="src/pages/render-example.astro" {4, 7}
----
-import { getEntry } from 'astro:content';
-const entry = await getEntry('blog', 'post-1');
-const { Content } = await entry.render();
----
-<p>Published on: {entry.data.published.toDateString()}</p>
-<Content />
-```
-
-### `<ViewTransitions />`
-
-<p><Since v="2.9.0" /></p>
-
-원하는 모든 페이지의 `<head>`에 `<ViewTransitions />` 라우팅 컴포넌트를 가져오고 추가하여 개별 페이지에서 view transitions를 사용하도록 선택합니다.
-
-```astro title="src/pages/index.astro" ins={2,7}
----
-import { ViewTransitions } from 'astro:transitions';
----
-<html lang="en">
-  <head>
-    <title>My Homepage</title>
-    <ViewTransitions />
-  </head>
-  <body>
-    <h1>Welcome to my website!</h1>
-  </body>
-</html>
-```
-
-페이지 요소 및 컴포넌트에 [라우터 제어](/ko/guides/view-transitions/#라우터-제어) 및 [전환 지시어 추가](/ko/guides/view-transitions/#전환-지시어) 방법에 대해 자세히 알아보세요.
-
-### `<Debug />`
-
-```astro
----
-import { Debug } from 'astro:components';
-const serverObject = {
-  a: 0,
-  b: "string",
-  c: {
-    nested: "object"
-  }
-}
----
-<Debug {serverObject} />
-```
-
-이 컴포넌트는 JavaScript 없이 클라이언트 측에서 값을 검사하는 방법을 제공합니다.
-
-[canonical]: https://en.wikipedia.org/wiki/Canonical_link_element
+```
\ No newline at end of file

From d3ab88cb2e8928664b8d9d1e9038db520cbaed7f Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Sat, 26 Oct 2024 17:16:38 +0200
Subject: [PATCH 11/43] i18n(fr): update `nav.ts` (#9822)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 src/i18n/fr/nav.ts | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/src/i18n/fr/nav.ts b/src/i18n/fr/nav.ts
index 1f2860a7049ac..5d983518f34f9 100644
--- a/src/i18n/fr/nav.ts
+++ b/src/i18n/fr/nav.ts
@@ -60,23 +60,31 @@ export default NavDictionary({
 	'guides/testing': 'Tests',
 	'guides/troubleshooting': 'Dépannage',
 
+	communityResources: 'Ressources communautaires',
+	'community-resources/content': 'Cours, Guides et Recettes',
+	'community-resources/talks': 'Entretiens, Interviews et Streams',
+
 	reference: 'Référence',
 	'reference/configuration-reference': 'Configuration',
-	'reference/api-reference': "API d'Exécution",
 	'reference/cli-reference': "CLI d'Astro",
 	'reference/directives-reference': 'Utilisation des Directives',
 	'reference/components-reference': 'Composants Intégrés',
 	'guides/typescript': 'Référence TypeScript',
 	'reference/error-reference': 'Référence des erreurs',
 
+	'api-reference': "Référence de l'API d'Astro",
+	'reference/api-reference': "API d'Exécution d'Astro",
+	'reference/modules/astro-actions': 'astro:actions',
+	'reference/modules/astro-assets': 'astro:assets',
+	'reference/modules/astro-content': 'astro:content',
+	'reference/modules/astro-i18n': 'astro:i18n',
+	'reference/modules/astro-middleware': 'astro:middleware',
+	'reference/modules/astro-transitions': 'astro:transitions',
+
 	dev: 'Autres APIs de Développement',
 	'reference/integrations-reference': "API d'Intégration",
 	'reference/adapter-reference': "API de l'Adaptateur",
 	'reference/image-service-reference': "API du Service d'Images",
 	'reference/dev-toolbar-app-reference': "API de la barre d'outils Dev",
 	'reference/container-reference': 'API de Conteneur',
-
-	communityResources: 'Ressources communautaires',
-	'community-resources/content': 'Cours, Guides et Recettes',
-	'community-resources/talks': 'Entretiens, Interviews et Streams',
 });

From ed43550889c040cc86594e79577a99dcaff5333d Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Sat, 26 Oct 2024 17:34:36 +0200
Subject: [PATCH 12/43] i18n(fr): update `guides/middleware.mdx` (#9833)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 src/content/docs/fr/guides/middleware.mdx | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/content/docs/fr/guides/middleware.mdx b/src/content/docs/fr/guides/middleware.mdx
index 9e6ad22fc941f..02941b9eb8963 100644
--- a/src/content/docs/fr/guides/middleware.mdx
+++ b/src/content/docs/fr/guides/middleware.mdx
@@ -16,7 +16,7 @@ Le middleware vous permet également de définir et de partager des informations
 <Steps>
 1. Créez `src/middleware.js|ts` (Alternativement, vous pouvez créer `src/middleware/index.js|ts`.)
 
-2. Dans ce fichier, exportez une fonction [`onRequest()`](/fr/reference/api-reference/#onrequest) à laquelle on peut passer un objet [`context`](#objet-context) et une fonction `next()`. Il ne doit pas s'agir d'une exportation par défaut.
+2. Dans ce fichier, exportez une fonction [`onRequest()`](/fr/reference/modules/astro-middleware/#onrequest) à laquelle on peut passer un objet [`context`](#objet-context) et une fonction `next()`. Il ne doit pas s'agir d'une exportation par défaut.
 
     ```js title="src/middleware.js"
     export function onRequest (context, next) {
@@ -138,10 +138,11 @@ export const onRequest = (context, next) => {
 };
 ```
 
-Pour taper l'information dans `Astro.locals`, ce qui vous donne l'autocomplétion dans les fichiers `.astro` et le code middleware, déclarez un espace de noms global dans le fichier `env.d.ts` :
+Pour activer les types pour les informations contenues dans `Astro.locals`, ce qui vous donne l'autocomplétion dans les fichiers `.astro` et le code middleware, déclarez un espace de noms global dans le fichier `env.d.ts` :
 
 ```ts title="src/env.d.ts"
 /// <reference path="../.astro/types.d.ts" />
+
 declare namespace App {
     interface Locals {
         user: {
@@ -157,7 +158,7 @@ Ensuite, dans le fichier du middleware, vous pouvez tirer parti de l'autocomplé
 
 ## Enchaînement middleware
 
-Plusieurs intergiciels peuvent être reliés dans un ordre précis à l'aide de [`séquence()`](/fr/reference/api-reference/#sequence) :
+Plusieurs middlewares peuvent être reliés dans un ordre précis à l'aide de [`séquence()`](/fr/reference/modules/astro-middleware/#sequence) :
 
 ```js title="src/middleware.js"
 import { sequence } from "astro/middleware";

From 2b4652cc3146cb25eeddf9328656bdcf976e0c8d Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Sat, 26 Oct 2024 18:16:58 +0200
Subject: [PATCH 13/43] i18n(fr): update `guides/imports.mdx` (#9836)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 src/content/docs/fr/guides/imports.mdx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/content/docs/fr/guides/imports.mdx b/src/content/docs/fr/guides/imports.mdx
index ee7d998f81a61..1890f5c87698b 100644
--- a/src/content/docs/fr/guides/imports.mdx
+++ b/src/content/docs/fr/guides/imports.mdx
@@ -186,6 +186,7 @@ import logoUrl from '@assets/logo.png?url';
 
 Ces alias sont également intégrés automatiquement dans [VS Code](https://code.visualstudio.com/docs/languages/jsconfig) et d'autres éditeurs de code.
 
+
 ## `Astro.glob()`
 
 [`Astro.glob()`](/fr/reference/api-reference/#astroglob) est un moyen d'importer plusieurs fichiers à la fois.
@@ -245,7 +246,7 @@ En outre, les motifs globaux doivent commencer par l'un des éléments suivants
 
 #### `Astro.glob()` vs `getCollection()`
 
-[Les collections de contenu](/fr/guides/content-collections/) fournissent une [API `getCollection()`](/fr/reference/api-reference/#getcollection) pour charger plusieurs fichiers au lieu de `Astro.glob()`. Si vos fichiers de contenu (par exemple Markdown, MDX, Markdoc) sont situés dans des collections dans le répertoire `src/content/`, utilisez `getCollection()` pour [interroger une collection](/fr/guides/content-collections/#interroger-les-collections) et retourner les entrées de la collection.
+[Les collections de contenu](/fr/guides/content-collections/) fournissent une [API `getCollection()`](/fr/reference/modules/astro-content/#getcollection) pour charger plusieurs fichiers au lieu de `Astro.glob()`. Si vos fichiers de contenu (par exemple Markdown, MDX, Markdoc) sont situés dans des collections dans le répertoire `src/content/`, utilisez `getCollection()` pour [interroger une collection](/fr/guides/content-collections/#interroger-les-collections) et retourner les entrées de la collection.
 
 ## WASM
 

From ae3e7fb40b05f471aac389dff7c8d65f63504de1 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Sat, 26 Oct 2024 18:25:03 +0200
Subject: [PATCH 14/43] i18n(fr): update `guides/internationalization.mdx`
 (#9835)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 src/content/docs/fr/guides/internationalization.mdx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/content/docs/fr/guides/internationalization.mdx b/src/content/docs/fr/guides/internationalization.mdx
index 7a68018f567a8..fee8abe9cd992 100644
--- a/src/content/docs/fr/guides/internationalization.mdx
+++ b/src/content/docs/fr/guides/internationalization.mdx
@@ -60,7 +60,7 @@ Les dossiers localisés n'ont pas besoin d'être à la racine du dossier `/pages
 
 ### Créer des liens
 
-Une fois le routage i18n configuré, vous pouvez désormais calculer des liens vers des pages de votre site à l'aide des fonctions d'assistance telles que [`getRelativeLocaleUrl()`](/fr/reference/api-reference/#getrelativelocaleurl) disponible avec le [module `astro:i18n`](/fr/reference/api-reference/#internationalisation-astroi18n). Ces liens générés fourniront toujours la bonne route localisée et peuvent vous aider à utiliser ou à vérifier correctement les URL de votre site.
+Une fois le routage i18n configuré, vous pouvez désormais calculer des liens vers des pages de votre site à l'aide des fonctions d'assistance telles que [`getRelativeLocaleUrl()`](/fr/reference/modules/astro-i18n/#getrelativelocaleurl) disponible avec le [module `astro:i18n`](/fr/reference/modules/astro-i18n/). Ces liens générés fourniront toujours la bonne route localisée et peuvent vous aider à utiliser ou à vérifier correctement les URL de votre site.
 
 Vous pouvez également continuer à rédiger les liens manuellement.
 
@@ -197,7 +197,7 @@ export default defineConfig({
 })
 ```
 
-Astro fournit des fonctions d'assistance pour votre middleware afin que vous puissiez contrôler votre propre routage par défaut, vos exceptions, le comportement de repli, la détection des erreurs, etc. : [`redirectToDefaultLocale()`](/fr/reference/api-reference/#redirecttodefaultlocale), [`notFound()`](/fr/reference/api-reference/#notfound), et [`redirectToFallback()`](/fr/reference/api-reference/#redirecttofallback) :
+Astro fournit des fonctions d'assistance pour votre middleware afin que vous puissiez contrôler votre propre routage par défaut, vos exceptions, le comportement de repli, la détection des erreurs, etc. : [`redirectToDefaultLocale()`](/fr/reference/modules/astro-i18n/#redirecttodefaultlocale), [`notFound()`](/fr/reference/modules/astro-i18n/#notfound), et [`redirectToFallback()`](/fr/reference/modules/astro-i18n/#redirecttofallback) :
 
 
 ```js title="src/middleware.js"
@@ -216,7 +216,7 @@ export const onRequest = defineMiddleware(async (ctx, next) => {
 
 La fonction [`middleware`](#fonction-middleware) crée manuellement le middleware i18n d'Astro. Cela vous permet d'étendre le routage i18n d'Astro plutôt que de le remplacer complètement. 
 
-Vous pouvez exécuter `middleware` avec des [options de routage](#routing) en combinaison avec votre propre middleware, en utilisant l'utilitaire [`sequence`](/fr/reference/api-reference/#sequence) pour déterminer l'ordre :
+Vous pouvez exécuter `middleware` avec des [options de routage](#routing) en combinaison avec votre propre middleware, en utilisant l'utilitaire [`sequence`](/fr/reference/modules/astro-middleware/#sequence) pour déterminer l'ordre :
 
 ```js title="src/middleware.js"
 import {defineMiddleware, sequence} from "astro:middleware";
@@ -342,7 +342,7 @@ export default defineConfig({
 })
 ```
 
-Lors de l'utilisation des fonctions du [module virtuel `astro:i18n`](/fr/reference/api-reference/#internationalisation-astroi18n) pour calculer des chemins d'URL valides en fonction de votre configuration (par exemple `getRelativeLocaleUrl()`), [utilisez `path` comme valeur pour `locale`](/fr/reference/api-reference/#getlocalebypath).
+Lors de l'utilisation des fonctions du [module virtuel `astro:i18n`](/fr/reference/modules/astro-i18n/) pour calculer des chemins d'URL valides en fonction de votre configuration (par exemple `getRelativeLocaleUrl()`), [utilisez `path` comme valeur pour `locale`](/fr/reference/modules/astro-i18n/#getlocalebypath).
 
 #### Limitations
 

From 75cae47e6c260c74aea71a76eac0bcd068e09315 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Sun, 27 Oct 2024 15:33:38 +0100
Subject: [PATCH 15/43] i18n(fr): update `guides/content-collections.mdx`
 (#9837)

See #9687

Co-authored-by: Paul Valladares <85648028+dreyfus92@users.noreply.github.com>
---
 src/content/docs/fr/guides/content-collections.mdx | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/content/docs/fr/guides/content-collections.mdx b/src/content/docs/fr/guides/content-collections.mdx
index 893a67e91f824..4e041bec4d3d8 100644
--- a/src/content/docs/fr/guides/content-collections.mdx
+++ b/src/content/docs/fr/guides/content-collections.mdx
@@ -312,7 +312,7 @@ relatedPosts:
 
 ### Définition d'un slug personnalisé
 
-Lorsque vous utilisez `type: 'content' `, chaque entrée de contenu génère une propriété `slug` conviviale à partir de son [fichier `id`](/fr/reference/api-reference/#id). Cette propriété est utilisée pour interroger l'entrée directement à partir de votre collection. Il est également utile pour créer de nouvelles pages et URL à partir de votre contenu.
+Lorsque vous utilisez `type: 'content' `, chaque entrée de contenu génère une propriété `slug` conviviale à partir de son [fichier `id`](/fr/reference/modules/astro-content/#id). Cette propriété est utilisée pour interroger l'entrée directement à partir de votre collection. Il est également utile pour créer de nouvelles pages et URL à partir de votre contenu.
 
 Vous pouvez remplacer la balise générée par une entrée en ajoutant votre propre propriété `slug` au fichier frontmatter. Ceci est similaire à la fonctionnalité "permalink" d'autres frameworks web. `"slug"` est un nom de propriété spécial et réservé qui n'est pas autorisé dans le `schema` de votre collection personnalisée et qui n'apparaîtra pas dans la propriété `data` de votre entrée. 
 
@@ -326,7 +326,7 @@ Le contenu de votre article
 
 ## Interroger les collections
 
-Astro fournit deux fonctions pour interroger une collection et retourner une (ou plusieurs) entrée de contenu : [`getCollection()`](/fr/reference/api-reference/#getcollection) et [`getEntry()`](/fr/reference/api-reference/#getentry).
+Astro fournit deux fonctions pour interroger une collection et retourner une (ou plusieurs) entrée de contenu : [`getCollection()`](/fr/reference/modules/astro-content/#getcollection) et [`getEntry()`](/fr/reference/modules/astro-content/#getentry).
 
 ```js
 import { getCollection, getEntry } from 'astro:content';
@@ -343,7 +343,7 @@ const allBlogPosts = await getCollection('blog');
 const graceHopperProfile = await getEntry('authors', 'grace-hopper');
 ```
 
-Les deux fonctions renvoient des entrées de contenu telles que définies par le type [`CollectionEntry`](/fr/reference/api-reference/#type-des-entrées-de-collection).
+Les deux fonctions renvoient des entrées de contenu telles que définies par le type [`CollectionEntry`](/fr/reference/modules/astro-content/#collectionentry).
 
 ### Accès aux données référencées
 
@@ -438,7 +438,7 @@ const blogEntries = await getCollection('blog');
 
 Un composant peut également passer une entrée de contenu entière en tant que propriété. 
 
-Si vous faites cela, vous pouvez utiliser l'utilitaire [`CollectionEntry`](/fr/reference/api-reference/#type-des-entrées-de-collection) pour taper correctement les propriétés de vos composants en utilisant TypeScript. Cet utilitaire prend un argument de type chaîne qui correspond au nom du schéma de votre collection, et hérite de toutes les propriétés du schéma de cette collection.
+Si vous faites cela, vous pouvez utiliser l'utilitaire [`CollectionEntry`](/fr/reference/modules/astro-content/#collectionentry) pour taper correctement les propriétés de vos composants en utilisant TypeScript. Cet utilitaire prend un argument de type chaîne qui correspond au nom du schéma de votre collection, et hérite de toutes les propriétés du schéma de cette collection.
 
 ```astro /CollectionEntry(?:<.+>)?/
 ---
@@ -508,7 +508,7 @@ Si vos slugs personnalisés contiennent le caractère `/` pour produire des URLs
 
 ### Construction pour la sortie serveur (SSR)
 
-Si vous construisez un site web dynamique (en utilisant le support SSR d'Astro), vous n'êtes pas censé générer des chemins à l'avance pendant la construction. Au lieu de cela, votre page devrait examiner la requête (en utilisant `Astro.request` ou `Astro.params`) pour trouver le `slug` à la demande, et ensuite le récupérer en utilisant [`getEntry()`](/fr/reference/api-reference/#getentry).
+Si vous construisez un site web dynamique (en utilisant le support SSR d'Astro), vous n'êtes pas censé générer des chemins à l'avance pendant la construction. Au lieu de cela, votre page devrait examiner la requête (en utilisant `Astro.request` ou `Astro.params`) pour trouver le `slug` à la demande, et ensuite le récupérer en utilisant [`getEntry()`](/fr/reference/modules/astro-content/#getentry).
 
 
 ```astro

From 6e06d6125b9bd5345b62cf6e65b43f84772adb90 Mon Sep 17 00:00:00 2001
From: Shinya Fujino <shf0811@gmail.com>
Date: Mon, 28 Oct 2024 03:44:56 +0900
Subject: [PATCH 16/43] i18n(ja): Update ui.ts (#9843)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: ryuapp <114303361+ryuapp@users.noreply.github.com>
---
 src/i18n/ja/ui.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/i18n/ja/ui.ts b/src/i18n/ja/ui.ts
index 72f7b53ceb1a5..8c3756101babe 100644
--- a/src/i18n/ja/ui.ts
+++ b/src/i18n/ja/ui.ts
@@ -52,6 +52,8 @@ export default UIDictionary({
 	'deploy.staticTag': 'Static',
 	// CMS Guides vocabulary
 	'cms.navTitle': 'その他のCMSガイド',
+	// Media Guides voccabulary
+	'media.navTitle': 'その他のDAMガイド',
 	// Migration Guides vocabulary
 	'migration.navTitle': 'その他のマイグレーションガイド',
 	// Recipes vocabulary

From c82c51908ea9ddfbfcc880cd317268de0ab3bbc8 Mon Sep 17 00:00:00 2001
From: Shinya Fujino <shf0811@gmail.com>
Date: Mon, 28 Oct 2024 03:51:09 +0900
Subject: [PATCH 17/43] i18n(ja): Update nav.ts (#9842)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: ryuapp <114303361+ryuapp@users.noreply.github.com>
---
 src/i18n/ja/nav.ts | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/src/i18n/ja/nav.ts b/src/i18n/ja/nav.ts
index e9a3f261b694d..124d8183fa453 100644
--- a/src/i18n/ja/nav.ts
+++ b/src/i18n/ja/nav.ts
@@ -23,15 +23,16 @@ export default NavDictionary({
 	'guides/integrations-guide': 'インテグレーションの追加',
 
 	content: 'コンテンツ管理',
-	'guides/content': 'コンテンツのオーサリング',
+	'guides/content': 'コンテンツの執筆',
 	'guides/markdown-content': 'Markdown',
 	'guides/content-collections': 'コンテンツコレクション',
 	'guides/cms': 'CMSとの接続',
-	'guides/rss': 'RSSフィードを追加する',
+	'guides/rss': 'RSSフィードの追加',
 
 	routes: 'ルートとナビゲーション',
 	'guides/routing': 'ルーティング',
 	'guides/endpoints': 'エンドポイント',
+	'guides/actions': 'アクション',
 	'guides/prefetch': 'プリフェッチ',
 	'guides/middleware': 'ミドルウェア',
 	'guides/internationalization': '国際化',
@@ -41,6 +42,7 @@ export default NavDictionary({
 	'guides/styling': 'CSSとスタイル',
 	'guides/images': '画像',
 	'guides/fonts': 'フォント',
+	'guides/media': 'ホストされたメディアやDAMの接続',
 
 	data: 'データ接続',
 	'guides/data-fetching': 'データフェッチ',
@@ -54,27 +56,35 @@ export default NavDictionary({
 	'guides/framework-components': 'UIフレームワーク',
 	'guides/client-side-scripts': 'スクリプトとイベントハンドリング',
 
-	maintain: 'プロジェクト維持',
+	maintain: 'プロジェクトの保守',
 	'upgrade-astro': 'Astroのアップグレード',
 	'guides/testing': 'テスト',
 	'guides/troubleshooting': 'トラブルシューティング',
 
+	communityResources: 'コミュニティリソース',
+	'community-resources/content': 'コース、ガイド、レシピ',
+	'community-resources/talks': 'トーク、インタビュー、配信',
+
 	reference: 'リファレンス',
 	'reference/configuration-reference': '設定方法',
 	'reference/api-reference': 'ランタイムAPI',
 	'reference/cli-reference': 'Astro CLI',
 	'reference/directives-reference': 'テンプレートディレクティブ',
+	'reference/components-reference': '組み込みのコンポーネント',
 	'guides/typescript': 'TypeScript',
 	'reference/error-reference': 'エラーリファレンス',
 
+	'api-reference': 'Astro APIリファレンス',
+	'reference/modules/astro-actions': 'astro:actions',
+	'reference/modules/astro-assets': 'astro:assets',
+	'reference/modules/astro-content': 'astro:content',
+	'reference/modules/astro-i18n': 'astro:i18n',
+	'reference/modules/astro-transitions': 'astro:transitions',
+
 	dev: 'その他の開発API',
 	'reference/integrations-reference': 'インテグレーションAPI',
 	'reference/adapter-reference': 'アダプターAPI',
 	'reference/image-service-reference': '画像サービスAPI',
 	'reference/dev-toolbar-app-reference': '開発ツールバーアプリAPI',
 	'reference/container-reference': 'コンテナAPI (実験的)',
-
-	communityResources: 'コミュニティリソース',
-	'community-resources/content': 'コース、ガイド、レシピ',
-	'community-resources/talks': 'トーク、インタビュー、配信',
 });

From b2dab8cc865ee67ccd1860811d6e3609bda875e7 Mon Sep 17 00:00:00 2001
From: Shinya Fujino <shf0811@gmail.com>
Date: Mon, 28 Oct 2024 03:58:51 +0900
Subject: [PATCH 18/43] i18n(ja): Update content-collections.mdx (#9845)

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: ryuapp <114303361+ryuapp@users.noreply.github.com>
---
 src/content/docs/ja/guides/content-collections.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/content/docs/ja/guides/content-collections.mdx b/src/content/docs/ja/guides/content-collections.mdx
index d37b953a72792..cc6deea5e1cd5 100644
--- a/src/content/docs/ja/guides/content-collections.mdx
+++ b/src/content/docs/ja/guides/content-collections.mdx
@@ -3,6 +3,8 @@ title: コンテンツコレクション
 description: >-
   コンテンツコレクションは、Markdownを整理し、フロントマターをスキーマで型チェックするのに役立ちます。
 i18nReady: true
+banner:
+  content: 新しいコンテンツコレクションを試してみませんか？<a href="https://5-0-0-beta.docs.astro.build/ja/guides/upgrade-to/v5/">ベータ版のv5にアップグレード</a>！
 ---
 import { FileTree } from '@astrojs/starlight/components';
 import Since from '~/components/Since.astro'

From d45078c58b054e27d7063354563fc94989bbb883 Mon Sep 17 00:00:00 2001
From: Shinya Fujino <shf0811@gmail.com>
Date: Mon, 28 Oct 2024 04:05:26 +0900
Subject: [PATCH 19/43] i18n(ja): Update imports.mdx (#9844)

* 82677457dd9189e501cb8c0191c1693f32cb11f6

* 1e261305a6094fb816f58e41ae09711f57aa055f

* ba9fcbeb2d20046170397f766653c3bdffdb8ca0 and c75f2f6ca17ac2378e44b22045dafe9350c5a27a

---------

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: ryuapp <114303361+ryuapp@users.noreply.github.com>
---
 src/content/docs/ja/guides/imports.mdx | 32 +++++++++++---------------
 1 file changed, 14 insertions(+), 18 deletions(-)

diff --git a/src/content/docs/ja/guides/imports.mdx b/src/content/docs/ja/guides/imports.mdx
index 6a4a959316870..df9e4d5d9550e 100644
--- a/src/content/docs/ja/guides/imports.mdx
+++ b/src/content/docs/ja/guides/imports.mdx
@@ -16,10 +16,9 @@ Astroは、標準で以下のファイル形式をサポートしています。
 - Astroコンポーネント（`.astro`）
 - Markdown（`.md`, `.markdown`など）
 - JavaScript（`.js`、`.mjs`）
-- TypeScript（`.ts`、`.tsx`）
+- TypeScript（`.ts`）
 - NPMパッケージ
 - JSON（`.json`）
-- JSX（`.jsx`、`.tsx`）
 - CSS（`.css`）
 - CSS Modules（`.module.css`）
 - イメージとアセット（`.svg`、`.jpg`、`.png`など）
@@ -44,6 +43,12 @@ import { getUser } from './user.js';
 
 JavaScriptは、通常のESMの`import`と`export`の構文でインポートできます。
 
+:::note[JSXファイルのインポート]
+
+JSXやTSXファイルをレンダリングするには、適切な[UIフレームワーク](/ja/guides/framework-components/)（[React](/ja/guides/integrations-guide/react/)、[Preact](/ja/guides/integrations-guide/preact/)、[Solid](/ja/guides/integrations-guide/solid-js/)）が必要です。Astroは`.js`や`.ts`ファイル内のJSXをサポートしていないため、必要に応じて`.jsx`か`.tsx`拡張子を使用してください。
+
+:::
+
 
 ### TypeScript
 
@@ -70,21 +75,6 @@ import MyComponent from "./MyComponent"; // MyComponent.tsx
 <ReadMore>[AstroのTypeScriptサポート](/ja/guides/typescript/)の詳細はこちら。</ReadMore>
 
 
-### JSX / TSX
-
-```js
-import { MyComponent } from './MyComponent.jsx';
-```
-
-Astroには、プロジェクトにJSX（`*.jsx`と`*.tsx`）ファイルのサポートが組み込まれています。JSXの構文は、自動的にJavaScriptにトランスパイルされます。
-
-AstroはJSX構文を標準で理解できますが、React、Preact、Solidなどのフレームワークを適切にレンダリングするには、フレームワークのインテグレーションをインストールする必要があります。詳しくは、[インテグレーションガイド](/ja/guides/integrations-guide/)をご覧ください。
-
-:::note
-**Astroは`.js`/`.ts`ファイル内のJSXをサポートしません。** JSXは、`.jsx`と`.tsx`のファイル拡張子で終わるファイル内でのみ扱われます。
-:::
-
-
 ### npmパッケージ
 
 npmパッケージをインストールした場合、Astroでインポートできます。
@@ -121,6 +111,10 @@ import './style.css';
 
 Astroは、CSSファイルをアプリケーションに直接インポートできます。インポートされたスタイルはエクスポートされませんが、インポートすることで自動的にそれらのスタイルがページに追加されます。これはデフォルトですべてのCSSファイルに対して機能し、プラグインによってSassやLessのようなコンパイル可能なCSS言語もサポートします。
 
+<ReadMore>
+CSSファイルのURLを直接参照したり、CSSを文字列としてインポートするなどの高度なCSSインポートの使用例については、[スタイリングガイド](/ja/guides/styling/#アドバンスド)を参照してください。
+</ReadMore>
+
 
 ### CSSモジュール
 
@@ -153,6 +147,8 @@ import txtReference from './words.txt'; // txt === '/src/words.txt'
 
 また、[ディレクトリ構造](/ja/basics/project-structure/#public)で説明されているように、画像は`public/`フォルダに配置するのも便利です。
 
+<ReadMore>`?url`や`?raw`など、Viteのインポートパラメータを追加する方法については、[Viteの静的アセットの取り扱いガイド](https://ja.vite.dev/guide/assets)を参照してください。</ReadMore>
+
 :::note
 アクセシビリティの観点から、`<img>`タグに**altテキスト**を付加することが推奨されています！画像要素に`alt="役に立つ説明"`属性を追加することを忘れないでください。画像が単なる装飾である場合は、この属性を空で指定します。
 :::
@@ -172,7 +168,7 @@ import logoUrl from '../../assets/logo.png?url';
 
 この例では、開発者は`src/pages/about/company.astro`、`src/components/controls/Button.astro`、そして`src/assets/logo.png`間のツリーの関係を理解する必要があります。そして、`company.astro`ファイルが移動された場合、これらのインポートも更新しなければなりません。
 
-インポートエイリアスは`tsconfig.json`または`jsconfig.json`のどちらかから追加できます。
+インポートエイリアスは`tsconfig.json`から追加できます。
 
 ```json title="tsconfig.json" ins={5-6}
 {

From d6c53cbc5d6ee88333cbfbf57b39c27b781178c6 Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 14:26:43 +0800
Subject: [PATCH 20/43] i18n(zh-cn): add `astro-actions.mdx` and update
 `actions.mdx` & `actions-returned-invalid-data-error.mdx` (#9839)

* i18n(zh-cn): add `astro-actions.mdx`

* Update `astro-actions.mdx`

* Update astro-actions.mdx

* Update link in `actions.mdx`

* Update link in `actions-returned-invalid-data-error.mdx`

* fix broken link

---------

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 src/content/docs/zh-cn/guides/actions.mdx     |   8 +-
 .../actions-returned-invalid-data-error.mdx   |   2 +-
 .../zh-cn/reference/modules/astro-actions.mdx | 177 ++++++++++++++++++
 3 files changed, 182 insertions(+), 5 deletions(-)
 create mode 100644 src/content/docs/zh-cn/reference/modules/astro-actions.mdx

diff --git a/src/content/docs/zh-cn/guides/actions.mdx b/src/content/docs/zh-cn/guides/actions.mdx
index 4e66bf8c4ab01..6ada5d6e79517 100644
--- a/src/content/docs/zh-cn/guides/actions.mdx
+++ b/src/content/docs/zh-cn/guides/actions.mdx
@@ -16,7 +16,7 @@ Astro Actions 允许你定义和调用具有类型安全性的后端函数。Act
 
 - 使用 [Zod](https://zod.dev/?id=primitives) 自动校验 JSON 和表单数据输入。
 - 生成类型安全的函数，以便从客户端调用后端，甚至可以[从 HTML 表单操作](#从-html-表单操作调用-action)中调用。无需手动 `fetch()` 调用。
-- 使用 [`ActionError`](/zh-cn/reference/api-reference/#actionerror) 对象标准化后端错误。
+- 使用 [`ActionError`](/zh-cn/reference/modules/astro-actions/#actionerror) 对象标准化后端错误。
 
 ## 基本用法
 
@@ -129,7 +129,7 @@ async () => {
 
 </Steps>
 
-<ReadMore>有关 [`defineAction()`](/zh-cn/reference/api-reference/#defineaction) 及其属性的详细信息，请参阅完整的 Actions API 文档。</ReadMore>
+<ReadMore>有关 [`defineAction()`](/zh-cn/reference/modules/astro-actions/#defineaction) 及其属性的详细信息，请参阅完整的 Actions API 文档。</ReadMore>
 
 ## 组织 actions
 
@@ -339,7 +339,7 @@ Actions 将解析提交的表单数据为一个对象，使用每个输入的 `n
     }
     ```
 
-    <ReadMore>请参阅 [`input` 验证器](/zh-cn/reference/api-reference/#input-验证器) 查看所有可用的校验器</ReadMore>
+    <ReadMore>请参阅 [`input` 验证器](/zh-cn/reference/modules/astro-actions/#input-验证器) 查看所有可用的校验器</ReadMore>
 
 3. 添加一个 `<script>` 到 HTML 表单中以提交用户输入。这个例子覆盖了表单的默认提交行为，调用 `actions.newsletter()`，并使用 `navigate()` 函数重定向到 `/confirmation`：
 
@@ -374,7 +374,7 @@ Actions 将解析提交的表单数据为一个对象，使用每个输入的 `n
 
 ### 展示表单输入错误
 
-你可以在提交前校验表单输入，使用原生 HTML 表单校验属性，例如 `required`、`type="email"` 和 `pattern`。对于后端的更复杂的 `input` 校验，你可以使用 [`isInputError()`](/zh-cn/reference/api-reference/#isinputerror) 工具函数。
+你可以在提交前校验表单输入，使用原生 HTML 表单校验属性，例如 `required`、`type="email"` 和 `pattern`。对于后端的更复杂的 `input` 校验，你可以使用 [`isInputError()`](/zh-cn/reference/modules/astro-actions/#isinputerror) 工具函数。
 
 要检索输入错误，可以使用 `isInputError()` 工具函数来检查错误是否是由无效输入而引起的。输入错误包含一个 `fields` 对象，其中包含每个验证失败的输入名称的消息。你可以使用这些消息提示用户以纠正他们的提交。
 
diff --git a/src/content/docs/zh-cn/reference/errors/actions-returned-invalid-data-error.mdx b/src/content/docs/zh-cn/reference/errors/actions-returned-invalid-data-error.mdx
index 4f1489cc766be..556ea0ff456dc 100644
--- a/src/content/docs/zh-cn/reference/errors/actions-returned-invalid-data-error.mdx
+++ b/src/content/docs/zh-cn/reference/errors/actions-returned-invalid-data-error.mdx
@@ -10,4 +10,4 @@ githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/
 Action handler 返回了无效数据。handler 应该返回可序列化的数据类型，并且不能返回 Response 对象。
 
 **另请参阅：**
--  [Actions handler 参考](/zh-cn/reference/api-reference/#handler-属性)
+-  [Actions handler 参考](/zh-cn/reference/modules/astro-actions/#handler-属性)
diff --git a/src/content/docs/zh-cn/reference/modules/astro-actions.mdx b/src/content/docs/zh-cn/reference/modules/astro-actions.mdx
new file mode 100644
index 0000000000000..7e9b212acca8f
--- /dev/null
+++ b/src/content/docs/zh-cn/reference/modules/astro-actions.mdx
@@ -0,0 +1,177 @@
+---
+title: Actions API 参考
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+Action 帮助你构建一个类型安全的后端，你可以从客户端代码和 HTML 表单中调用它。所有用于定义和调用 Action 的工具函数都由 `astro:actions` 模块暴露。有关示例和使用说明，请参阅 [Actions 指南](/zh-cn/guides/actions/)。
+
+## 从 `astro:actions` 导入
+
+```js
+import { 
+  actions,
+  defineAction,
+  isInputError,
+  ActionError,
+ } from 'astro:actions';
+```
+
+### `defineAction()`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+`defineAction()` 函数接受一个 [`handler()`](#handler-属性) 函数，其中包含在调用 Action 时要运行的服务器逻辑，以及一个可选的 [`input`](#input-验证器) 属性，用于在运行时验证输入参数。
+
+```ts
+export const server = {
+    getGreeting: defineAction({
+    input: z.object({
+      name: z.string(),
+    }),
+    handler: async (input, context) => {
+      return `Hello, ${input.name}!`
+    }
+  })
+}
+```
+
+#### `handler()` 属性
+
+<p>
+
+**类型：**`(input, context) => any`
+</p>
+
+`defineAction()` 函数接受一个 `handler()` 函数，其中包含在调用 Action 时要运行的服务器逻辑。此函数可以返回数据，这些数据将自动序列化并发送给调用者。
+
+`handler()` 函数被调用时，接受用户输入作为其第一个参数。如果设置了 [`input`](#input-验证器) 验证器，那么用户输入将在传递给 `handler()` 前进行验证。第二个参数是一个 `context` 对象，包含大多数 Astro 的 [标准端点上下文](/zh-cn/reference/api-reference/#端点上下文)，不包括 `getActionResult()`, `callAction()`, 和 `redirect()`。
+
+返回值使用 [devalue 库](https://github.com/Rich-Harris/devalue) 进行解析。它支持 JSON 值，以及 `Date()`, `Map()`, `Set()`, 或 `URL()` 的实例。
+
+#### `input` 验证器
+
+<p>
+
+**类型：**`ZodType | undefined`
+</p>
+
+可选的 `input` 属性接受一个 Zod 验证器，用于在运行时验证处理程序的输入。如果 action 验证失败，将返回 [`BAD_REQUEST` 错误](#actionerror) 并跳过 `handler`。
+
+如果省略 `input`，则 `handler` 将接收 JSON 请求的 `unknown` 类型的输入，以及表单请求的 `FormData` 类型。
+
+##### 与 `accept: 'form'` 一起使用
+
+如果你的 action 接受表单输入，请使用 `z.object()` 验证器将表单数据自动解析为类型化对象。表单数据字段支持以下验证器：
+
+- 使用 `z.number()` 验证类型为 `number` 的输入
+- 使用 `z.boolean()` 验证类型为 `checkbox` 的输入
+- 使用 `z.instanceof(File)` 验证类型为 `file` 的输入
+- 使用 `z.array(/* validator */)` 验证相同 `name` 的多个输入
+- 使用 `z.string()` 验证所有其他输入
+
+`z.object()` 验证器还支持包括 `.refine()`, `.transform()`, 和 `.pipe()` 在内的扩展函数。
+
+要搭配应用不同验证器的组合，请使用 `z.discriminatedUnion()` 包装器，它根据表单的特定字段以缩小类型范围。此示例通过接受表单提交以判断是 “创建(create)” 或是 “更新(update)” 了一名用户信息，判断时使用表单域的 `type` 属性字段来确定要验证的对象：
+
+```ts
+import { defineAction } from 'astro:actions';
+import { z } from 'astro:schema';
+
+export const server = {
+  changeUser: defineAction({
+    accept: 'form',
+    input: z.discriminatedUnion('type', [
+      z.object({
+        // 当 `type` 字段中的值含有 `create` 时匹配
+        type: z.literal('create'),
+        name: z.string(),
+        email: z.string().email(),
+      }),
+      z.object({
+        // 当 `type` 字段中的值含有 `update` 时匹配
+        type: z.literal('update'),
+        id: z.number(),
+        name: z.string(),
+        email: z.string().email(),
+      }),
+    ]),
+    async handler(input) {
+      if (input.type === 'create') {
+        // input 为 { type: 'create', name: string, email: string }
+      } else {
+        // input 为 { type: 'update', id: number, name: string, email: string }
+      }
+    },
+  }),
+};
+```
+
+### `isInputError()`
+
+<p>
+
+**类型：**<code>(error?: unknown | <a href="#actionerror">ActionError</a>) => boolean</code><br/>
+<Since v="4.15.0" />
+</p>
+
+`isInputError()` 函数常用于检查 `ActionError` 是否是输入验证错误。当 `input` 验证器是 `z.object()` 时，输入错误包括一个 `fields` 对象，其中错误消息按名称分组。
+
+<ReadMore> 
+更多关于使用 `isInputError()` 的信息，请参见 [表单输入错误指南](/zh-cn/guides/actions/#展示表单输入错误)。
+</ReadMore>
+
+### `ActionError`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+`ActionError` 构造函数常用于在 `handler()` 函数中抛出错误。它接受一个 `code` 属性，描述发生的错误（例如：`"UNAUTHORIZED"`），以及一个可选的 `message` 属性，提供进一步的细节。
+
+#### `code`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+`code` 属性接受所有 HTTP 状态码的人类可读版本。以下是支持的 code：
+
+- `BAD_REQUEST` (400): 客户端发送了无效的输入。当 action `input` 验证器验证失败时会抛出此错误。
+- `UNAUTHORIZED` (401): 客户端缺乏有效的身份验证凭据。
+- `FORBIDDEN` (403): 客户端无权访问资源。
+- `NOT_FOUND` (404): 服务器找不到请求的资源。
+- `METHOD_NOT_SUPPORTED` (405): 服务器不支持请求的方法。
+- `TIMEOUT` (408): 服务器在处理请求时超时。
+- `CONFLICT` (409): 服务器无法更新资源，因为存在冲突。
+- `PRECONDITION_FAILED` (412): 服务器不满足请求的前提条件。
+- `PAYLOAD_TOO_LARGE` (413): 服务器无法处理请求，因为负载过大。
+- `UNSUPPORTED_MEDIA_TYPE` (415): 服务器不支持请求的媒体类型。注意：Actions 已经检查了 JSON 和表单请求的 [`Content-Type` 标头](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Content-Type)，所以你可能不需要手动引发此代码。
+- `UNPROCESSABLE_CONTENT` (422): 服务器无法处理请求，因为存在语义错误。
+- `TOO_MANY_REQUESTS` (429): 服务器已超出指定的速率限制。
+- `CLIENT_CLOSED_REQUEST` (499): 客户端在服务器响应之前关闭了请求。
+- `INTERNAL_SERVER_ERROR` (500): 服务器意外失败。
+- `NOT_IMPLEMENTED` (501): 服务器不支持请求的功能。
+- `BAD_GATEWAY` (502): 服务器从上游服务器接收到无效响应。
+- `SERVICE_UNAVAILABLE` (503): 服务器暂时不可用。
+- `GATEWAY_TIMEOUT` (504): 服务器从上游服务器接收到超时。
+
+#### `message`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+`message` 属性接受一个字符串。（例如："用户必须登录。"）
+
+[canonical]: https://en.wikipedia.org/wiki/Canonical_link_element

From d012956cd15c700a4d3b47a15bfdf0aa96ead8b1 Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 14:43:40 +0800
Subject: [PATCH 21/43] i18n(zh-cn): add `astro-assets.mdx` (#9840)

* i18n(zh-cn): add `astro-assets.mdx`

* fix: line wrap

---------

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 .../zh-cn/reference/modules/astro-assets.mdx  | 159 ++++++++++++++++++
 1 file changed, 159 insertions(+)
 create mode 100644 src/content/docs/zh-cn/reference/modules/astro-assets.mdx

diff --git a/src/content/docs/zh-cn/reference/modules/astro-assets.mdx b/src/content/docs/zh-cn/reference/modules/astro-assets.mdx
new file mode 100644
index 0000000000000..5b58d0fe92256
--- /dev/null
+++ b/src/content/docs/zh-cn/reference/modules/astro-assets.mdx
@@ -0,0 +1,159 @@
+---
+title: 资源 API 参考
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="3.0.0" /></p>
+
+Astro 提供了内置组件和辅助函数来优化和显示图像。有关功能和使用示例，[请参阅我们的图像指南](/zh-cn/guides/images/)。
+
+## 从 `astro:assets` 导入
+
+```js
+import { 
+  Image,
+  Picture,
+  getImage,
+ } from 'astro:assets';
+```
+
+### `<Image />`
+
+```astro title="src/components/MyComponent.astro"
+---
+// 导入图像组件和图片
+import { Image } from 'astro:assets';
+import myImage from "../assets/my_image.png"; // Image is 1600x900
+---
+
+<!-- `alt` 在 Image 组件中是必需的属性 -->
+<Image src={myImage} alt="A description of my image." />
+```
+
+```html
+<!-- 输出 -->
+<!-- Image 组件已经过优化，并且对应的属性也被强制使用。 -->
+<img
+  src="/_astro/my_image.hash.webp"
+  width="1600"
+  height="900"
+  decoding="async"
+  loading="lazy"
+  alt="A description of my image."
+/>
+```
+
+#### 属性
+
+- src（必需的）
+- alt（必需的）
+- width 和 height（对 `public/` 和远程图像而言是必需的）
+- format
+- quality
+- densities
+- widths
+
+除了上述属性之外，`<Image />` 组件还接受 HTML `<img>` 标签接受的所有属性。
+
+详见 [图像指南](/zh-cn/guides/images/#image--astroassets)。
+
+### `<Picture />`
+
+<p><Since v="3.3.0" /></p>
+
+使用内置的 `<Picture />` Astro 组件来展示具有多种格式和（或）尺寸的响应式图像。
+
+```astro title="src/pages/index.astro"
+---
+import { Picture } from 'astro:assets';
+import myImage from "../assets/my_image.png"; // 图像的分辨率为 1600x900
+---
+<!-- 在图片组件上 `alt` 属性是必需的 -->
+<Picture src={myImage} formats={['avif', 'webp']} alt="A description of my image." />
+```
+
+```html
+<!-- 输出 -->
+<picture>
+  <source srcset="/_astro/my_image.hash.avif" type="image/avif" />
+  <source srcset="/_astro/my_image.hash.webp" type="image/webp" />
+  <img
+    src="/_astro/my_image.hash.png"
+    width="1600"
+    height="900"
+    decoding="async"
+    loading="lazy"
+    alt="A description of my image."
+  />
+</picture>
+```
+
+详见 [图像指南](/zh-cn/guides/images/#picture-)。
+
+#### 属性
+
+`<Picture />` 接受 `<Image />` 组件的所有属性，以及以下属性：
+
+##### `formats`
+
+一个图像格式的数组，用于 `<source>` 标签。默认情况下，它被设置为 `['webp']`。
+
+##### `fallbackFormat`
+
+用于作为 `<img>` 标签的回退值的格式。对于静态图像，默认为 `.png`；对于动画图像，默认为 `.gif`；对于 SVG 文件，默认为 `.svg`。
+
+##### `pictureAttributes`
+
+一个被添加到 `<picture>` 标签的属性对象。使用该属性可将属性应用于外部的 `<picture>` 元素本身。除了用于图像转换的属性外，直接应用于 `<Picture />` 组件的属性将应用于内部的 `<img>` 元素。
+
+### `getImage()`
+
+<p>
+
+**类型：**`(options: UnresolvedImageTransform) => Promise<GetImageResult>`
+</p>
+
+:::caution
+`getImage()` 依赖于仅在服务器上可用的 API，当在客户端使用时会导致构建失败。
+:::
+
+`getImage()`函数旨在生成用于在 HTML 之外的其他地方所使用的图像，例如在 [API 路由](/zh-cn/guides/endpoints/#服务器端点api-路由) 中。它还允许你创建自定义的 `<Image />` 组件。
+
+`getImage()` 函数接受一个选项对象，其中包含与 [Image 组件相同的属性](/zh-cn/reference/components-reference/#属性)（除了 `alt`）。
+
+```astro
+---
+import { getImage } from "astro:assets";
+import myBackground from "../background.png"
+
+const optimizedBackground = await getImage({src: myBackground, format: 'avif'})
+---
+
+<div style={`background-image: url(${optimizedBackground.src});`}></div>
+```
+
+它返回了一个具有以下类型的对象：
+
+```js
+type GetImageResult = {
+  /* 渲染图像所需的附加 HTML 属性（宽度、高度、样式等） */
+  attributes: Record<string, any>;
+  /* 已通过校验的参数 */
+  options: ImageTransform;
+  /* 传递的原始参数 */
+  rawOptions: ImageTransform;
+  /* 生成图像的路径 */
+  src: string;
+  srcSet: {
+    /* 为 srcset 生成值，每个条目都有一个 url 和一个 size */
+    values: SrcSetValue[];
+    /* 准备在`srcset`属性中使用的值 */
+    attribute: string;
+  };
+}
+```

From f964d29526d3221208318e76b63fd78d84c28b28 Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 15:06:03 +0800
Subject: [PATCH 22/43] i18n(zh-cn): Update `routing.mdx` (#9850)

* i18n(zh-cn): Update `routing.mdx`

* Update src/content/docs/zh-cn/guides/routing.mdx

Co-authored-by: liruifengv <liruifeng1024@gmail.com>

* Update src/content/docs/zh-cn/guides/routing.mdx

Co-authored-by: liruifengv <liruifeng1024@gmail.com>

---------

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 src/content/docs/zh-cn/guides/routing.mdx | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/content/docs/zh-cn/guides/routing.mdx b/src/content/docs/zh-cn/guides/routing.mdx
index 8533488ace10b..885c3e6b6ff1e 100644
--- a/src/content/docs/zh-cn/guides/routing.mdx
+++ b/src/content/docs/zh-cn/guides/routing.mdx
@@ -379,6 +379,7 @@ export const onRequest = async (context, next) => {
 
 Astro 需要知道哪个路由应该被用来构建页面。为此，它会按照以下规则按顺序对它们进行排序：
 
+- Astro [预留路由](#预留路由)
 - 路径段更多的路由将优先于不太具体的路由。在上面的例子中，所有在 `/posts/` 下的路由优先于根目录的 `/[...slug].astro`。
 - 没有路径参数的静态路由将优先于动态路由。例如，`/posts/create.astro` 优先于示例中的所有其他路由。
 - 使用命名参数的动态路由优先于剩余参数。例如，`/posts/[page].astro` 优先于 `/posts/[...slug].astro`。
@@ -395,6 +396,14 @@ Astro 需要知道哪个路由应该被用来构建页面。为此，它会按
 - `pages/posts/[...slug].astro` - 将构建 `/posts/1/2`、`/posts/a/b/c` 等，但不包括 `/posts/create`、`/posts/1`、`/posts/abc` 等
 - `pages/[...slug].astro` - 将构建 `/abc`、`/xyz`、`/abc/xyz` 等，但不包括 `/posts/create`、`/posts/1`、`/posts/abc` 等
 
+### 预留路由
+
+内部路由优先于任何用户定义或集成定义的路由，因为 Astro 功能需要它们才能工作。以下是 Astro 的预留路由：
+
+- `_astro/`: 向客户端提供所有静态资源，包括 CSS 文档、打包的客户端脚本、优化后的图像和任何 Vite 资源。
+- `_server_islands/`: 为延迟渲染的 [服务器群岛](/zh-cn/reference/configuration-reference/#experimentalserverislands) 动态组件提供服务。
+- `_actions/`: 服务于任何已定义的 [action](/zh-cn/guides/actions/)。
+
 ## 分页
 
 Astro 支持内置分页，用于需要分割成多个页面的大量数据。Astro 会生成常见的分页属性，包括上一页/下一页链接、总页数等。

From e84ff9f2f747cebd0e0d192e142f5435bccb5cde Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 15:17:23 +0800
Subject: [PATCH 23/43] i18n(zh-cn): Update `fleek.mdx` (#9851)

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 src/content/docs/zh-cn/guides/deploy/fleek.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/zh-cn/guides/deploy/fleek.mdx b/src/content/docs/zh-cn/guides/deploy/fleek.mdx
index 34b74a1e60631..fd404959f96f9 100644
--- a/src/content/docs/zh-cn/guides/deploy/fleek.mdx
+++ b/src/content/docs/zh-cn/guides/deploy/fleek.mdx
@@ -75,4 +75,4 @@ import ReadMore from '~/components/ReadMore.astro';
 ## 了解更多
 
 <ReadMore>[通过 Fleek UI 完成部署](https://fleek.xyz/docs/platform/deployments/)</ReadMore>
-<ReadMore>[通过 Fleek 命令行工具完成部署](https://fleek.xyz/docs/cli/sites/)</ReadMore>
+<ReadMore>[通过 Fleek 命令行工具完成部署](https://fleek.xyz/docs/cli/hosting/)</ReadMore>

From d7739a2c7aec374e6538984c30ca6f884245534f Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 15:25:06 +0800
Subject: [PATCH 24/43] i18n(zh-cn): add `astro-content.mdx` and update related
 link (#9846)

* i18n(zh-cn): add `astro-content.mdx`

* Update link in `content-collections.mdx`

* Update link in `imports.mdx`

* Update link in `markdown-content.mdx`

* fix: link in `content-collections.mdx`

* fix: link in `imports.mdx`

* Update link in `add-content-collections.mdx`

* fix: line wrap

* fix: add indented line

* Update src/content/docs/zh-cn/reference/modules/astro-content.mdx

Co-authored-by: liruifengv <liruifeng1024@gmail.com>

* Update src/content/docs/zh-cn/reference/modules/astro-content.mdx

Co-authored-by: liruifengv <liruifeng1024@gmail.com>

* Update src/content/docs/zh-cn/reference/modules/astro-content.mdx

Co-authored-by: liruifengv <liruifeng1024@gmail.com>

---------

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 .../docs/zh-cn/guides/content-collections.mdx |  10 +-
 src/content/docs/zh-cn/guides/imports.mdx     |   4 +-
 .../docs/zh-cn/guides/markdown-content.mdx    |   2 +-
 .../zh-cn/reference/modules/astro-content.mdx | 378 ++++++++++++++++++
 .../tutorials/add-content-collections.mdx     |   2 +-
 5 files changed, 386 insertions(+), 10 deletions(-)
 create mode 100644 src/content/docs/zh-cn/reference/modules/astro-content.mdx

diff --git a/src/content/docs/zh-cn/guides/content-collections.mdx b/src/content/docs/zh-cn/guides/content-collections.mdx
index 7fca0b5b029c9..9c343f3c9212e 100644
--- a/src/content/docs/zh-cn/guides/content-collections.mdx
+++ b/src/content/docs/zh-cn/guides/content-collections.mdx
@@ -311,7 +311,7 @@ relatedPosts:
 
 ### 定义自定义 slugs
 
-当使用 `type: 'content'` 时，每个内容条目从它的[文件 `id`](/zh-cn/reference/api-reference/#id) 生成一个 URL 友好的 `slug` 属性。slug 用于直接从集合中查询条目。在根据内容创建新页面和 URL 时，它也很有用。
+当使用 `type: 'content'` 时，每个内容条目从它的[文件 `id`](/zh-cn/reference/modules/astro-content/#id) 生成一个 URL 友好的 `slug` 属性。slug 用于直接从集合中查询条目。在根据内容创建新页面和 URL 时，它也很有用。
 
 你可以通过将自己的 `slug` 属性添加到文件 frontmatter 来覆盖条目生成的 slug。这类似于其他 Web 框架的 "permalink" 特性。`"slug"` 是一个特殊的保留属性名称，不允许出现在自定义集合 `schema` 中，也不会出现在条目的 `data` 属性中。
 
@@ -325,7 +325,7 @@ slug: my-custom-slug/supports/slashes
 
 ## 查询集合
 
-Astro 提供了两个函数来查询一个集合并返回一个（或多个）内容条目：[`getCollection()`](/zh-cn/reference/api-reference/#getcollection) 和 [`getEntry()`](/zh-cn/reference/api-reference/#getentry)。
+Astro 提供了两个函数来查询一个集合并返回一个（或多个）内容条目：[`getCollection()`](/zh-cn/reference/modules/astro-content/#getcollection) 和 [`getEntry()`](/zh-cn/reference/modules/astro-content/#getentry)。
 
 ```js
 import { getCollection, getEntry } from 'astro:content';
@@ -342,7 +342,7 @@ const allBlogPosts = await getCollection('blog');
 const graceHopperProfile = await getEntry('authors', 'grace-hopper');
 ```
 
-这两个函数都返回由 [`CollectionEntry`](/zh-cn/reference/api-reference/#集合条目类型) 类型定义的内容条目。
+这两个函数都返回由 [`CollectionEntry`](/zh-cn/reference/modules/astro-content/#collectionentry) 类型定义的内容条目。
 
 ### 使用引用的数据
 
@@ -437,7 +437,7 @@ const blogEntries = await getCollection('blog');
 
 组件还可以将整个内容条目作为属性传递。
 
-如果这样做，你可以使用 [`CollectionEntry`](/zh-cn/reference/api-reference/#集合条目类型) 实用工具使用 TypeScript 正确地输入组件属性。此实用工具接受与集合 schema 名称匹配的字符串参数，并将继承该集合 schema 的所有属性。
+如果这样做，你可以使用 [`CollectionEntry`](/zh-cn/reference/modules/astro-content/#collectionentry) 实用工具使用 TypeScript 正确地输入组件属性。此实用工具接受与集合 schema 名称匹配的字符串参数，并将继承该集合 schema 的所有属性。
 
 ```astro /CollectionEntry(?:<.+>)?/
 ---
@@ -507,7 +507,7 @@ const { Content } = await entry.render();
 
 ### 构建为服务器输出（SSR）
 
-如果你正在构建一个动态网站（使用 Astro 的 SSR 支持），则不需要在构建期间提前生成任何路径。相反，你的页面应该检查请求（使用 `Astro.request` 或 `Astro.params`）以按需找到 `slug`，然后使用 [`getEntry()`](/zh-cn/reference/api-reference/#getentry) 获取它。
+如果你正在构建一个动态网站（使用 Astro 的 SSR 支持），则不需要在构建期间提前生成任何路径。相反，你的页面应该检查请求（使用 `Astro.request` 或 `Astro.params`）以按需找到 `slug`，然后使用 [`getEntry()`](/zh-cn/reference/modules/astro-content/#getentry) 获取它。
 
 
 ```astro
diff --git a/src/content/docs/zh-cn/guides/imports.mdx b/src/content/docs/zh-cn/guides/imports.mdx
index ae345bc4dd897..bd7d84d683b73 100644
--- a/src/content/docs/zh-cn/guides/imports.mdx
+++ b/src/content/docs/zh-cn/guides/imports.mdx
@@ -244,9 +244,7 @@ glob 模式是一个支持特殊通配符的文件路径。用于一次引用项
 
 #### `Astro.glob()` vs `getCollection()`
 
-[内容集合](/zh-cn/guides/content-collections/) 提供用于加载多个文件的 [`getCollection()` API](/zh-cn/reference/api-reference/#getcollection) 代替 `Astro.glob()`。如果你的内容文件 (例如 Markdown, MDX, Markdoc) 位于`src/content/` 目录内的集合中，使用 `getCollection()` [查询集合](/zh-cn/guides/content-collections/#查询集合)并返回内容条目。
-
-
+[内容集合](/zh-cn/guides/content-collections/) 提供用于加载多个文件的 [`getCollection()` API](/zh-cn/reference/modules/astro-content/#getcollection) 代替 `Astro.glob()`。如果你的内容文件 (例如 Markdown, MDX, Markdoc) 位于`src/content/` 目录内的集合中，使用 `getCollection()` [查询集合](/zh-cn/guides/content-collections/#查询集合)并返回内容条目。
 
 ## WASM
 
diff --git a/src/content/docs/zh-cn/guides/markdown-content.mdx b/src/content/docs/zh-cn/guides/markdown-content.mdx
index c3a974814f0e0..c00392ccf5879 100644
--- a/src/content/docs/zh-cn/guides/markdown-content.mdx
+++ b/src/content/docs/zh-cn/guides/markdown-content.mdx
@@ -62,7 +62,7 @@ const posts = Object.values(await import.meta.glob('../posts/*.md', { eager: tru
 
 当通过辅助函数从集合中获取数据时，Markdown 的 frontmatter 属性在 `data` 对象（例如 `post.data.title`）上可用。此外，`body` 包含了 Markdown 的正文内容，这部分内容是原始的、未编译的字符串类型。
 
-<ReadMore>请参阅完整的 [集合条目类型](/zh-cn/reference/api-reference/#集合条目类型)。</ReadMore>
+<ReadMore>请参阅完整的 [集合条目类型](/zh-cn/reference/modules/astro-content/#collectionentry)。</ReadMore>
 
 #### 导入 Markdown
 
diff --git a/src/content/docs/zh-cn/reference/modules/astro-content.mdx b/src/content/docs/zh-cn/reference/modules/astro-content.mdx
new file mode 100644
index 0000000000000..c4b8f22ff290c
--- /dev/null
+++ b/src/content/docs/zh-cn/reference/modules/astro-content.mdx
@@ -0,0 +1,378 @@
+---
+title: 内容集合 API 参考
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="2.0.0" /></p>
+
+内容集合提供了 API 来配置和查询 `src/content/` 中的 Markdown 或 MDX 文档。有关功能和用法示例，请参考[内容集合指南](/zh-cn/guides/content-collections/)。
+
+## 从 `astro:content` 导入
+
+```js
+import { 
+  z,
+  defineCollection,
+  getCollection,
+  getEntry,
+  getEntries,
+  reference,
+ } from 'astro:content';
+```
+
+### `defineCollection()`
+
+<p>
+
+**类型：**`(input: CollectionConfig) => CollectionConfig`
+</p>
+
+`defineCollection()` 是一个用于在 `src/content/config.*` 文件中配置集合的工具函数。
+
+```ts
+// src/content/config.ts
+import { z, defineCollection } from 'astro:content';
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    title: z.string(),
+    permalink: z.string().optional(),
+  }),
+});
+
+// 将定义的集合公开给 Astro
+// 通过 `collections` 导出
+export const collections = { blog };
+```
+
+这个函数接受以下属性：
+
+#### `type`
+
+<p>
+
+**类型：**`'content' | 'data'`<br />
+**默认：**`'content'`<br />
+<Since v="2.5.0" />
+</p>
+
+`type` 是一个字符串，用于定义存储在集合中的条目的类型：
+
+- `'content'` - 用于内容创作格式，如 Markdown (`.md`)、MDX (`.mdx`) 或 Markdoc (`.mdoc`)
+- `'data'` - 用于 JSON (`.json`) 或 YAML (`.yaml`) 等纯数据格式
+
+:::tip
+这意味着集合**不能**存储内容和数据格式的混合。你必须按类型将这些条目分割成单独的集合。
+:::
+
+#### `schema`
+
+<p>
+
+**类型：**<code>ZodType | (context: <a href="#schemacontext">SchemaContext</a>) => ZodType</code>
+</p>
+
+`schema` 是一个可选的 Zod 对象，用于配置集合的文档 frontmatter 的类型和形状。每个值必须使用 [Zod 验证器](https://github.com/colinhacks/zod)
+
+有关示例请 [参考 `内容集合`指南](/zh-cn/guides/content-collections/#定义集合模式)。
+
+### `reference()`
+
+<p>
+
+**类型：**`(collection: string) => ZodEffects<ZodString, { collection, id: string } | { collection, slug: string }>`<br />
+<Since v="2.5.0" />
+</p>
+
+在内容配置中使用 `reference()` 函数来定义从一个集合到另一个集合的关系或 "引用"。该函数接受一个集合名称，并验证内容前置事项或数据文件中指定的条目标识符。
+
+此示例定义了从博客作者到 "作者 "集合的引用，以及到同一 "博客 "集合的相关文章数组的引用：
+
+```ts
+import { defineCollection, reference, z } from 'astro:content';
+
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    // 通过 "id "从 "作者 "集合中引用单个作者
+    author: reference('authors'),
+    // 按 "slug "从 "blog "集合中引用相关帖子数组
+    relatedPosts: z.array(reference('blog')),
+  })
+});
+
+const authors = defineCollection({
+  type: 'data',
+  schema: z.object({ /* ... */ })
+});
+
+export const collections = { blog, authors };
+```
+
+有关示例请 [参考 `内容集合`指南](/zh-cn/guides/content-collections/#定义集合引用)。
+
+### `getCollection()`
+
+<p>
+
+**类型：** `(collection: string, filter?: (entry: CollectionEntry<TCollectionName>) => boolean) => CollectionEntry<TCollectionName>[]`
+</p>
+
+`getCollection()` 是一个函数，用于通过集合名称检索内容集合条目列表。
+
+默认情况下，它返回集合中的所有项目，并接受可选的 `filter` 函数来缩小条目属性。这允许你根据 `id`、`slug` 或 frontmatter 值（通过 `data` 对象）查询集合中的某些项目。
+
+```astro
+---
+import { getCollection } from 'astro:content';
+
+// 获取 `src/content/blog/` 中的所有条目
+const allBlogPosts = await getCollection('blog');
+
+// 仅返回 frontmatter 中 `draft: true` 的条目
+const draftBlogPosts = await getCollection('blog', ({ data }) => {
+  return data.draft === true;
+});
+---
+```
+
+有关示例请 [参考 `内容集合`指南](/zh-cn/guides/content-collections/#查询集合) 以获取示例用法。
+
+### `getEntry()`
+
+<p><Since v="2.5.0" /></p>
+
+**类型：**
+
+- `(collection: string, contentSlugOrDataId: string) => CollectionEntry<TCollectionName>`
+- `({ collection: string, id: string }) => CollectionEntry<TCollectionName>`
+- `({ collection: string, slug: string }) => CollectionEntry<TCollectionName>`
+
+`getEntry()` 是一个函数，可通过集合名称和条目 `id` （对于 `type: 'data'` 集合）或条目 `slug` （对于 `type: 'content'` 集合）检索单个集合条目。`getEntry()`也可用于获取引用条目，以访问`data`、`body`或`render()`属性：
+
+```astro
+---
+import { getEntry } from 'astro:content';
+
+// 得到 `src/content/blog/enterprise.md`
+const enterprisePost = await getEntry('blog', 'enterprise');
+
+// 得到 `src/content/captains/picard.yaml`
+const picardProfile = await getEntry('captains', 'picard');
+
+// 得到 the profile referenced by `data.captain`
+const enterpriseCaptainProfile = await getEntry(enterprisePost.data.captain);
+---
+```
+
+有关`内容集合`的示例，请参考 [查询集合条目](/zh-cn/guides/content-collections/#查询集合)。
+
+### `getEntries()`
+
+<p><Since v="2.5.0" /></p>
+
+**类型：**
+
+- `(Array<{ collection: string, id: string }>) => CollectionEntry<TCollectionName>[]`
+- `(Array<{ collection: string, slug: string }>) => CollectionEntry<TCollectionName>[]`
+
+`getEntries()` 是一个从同一集合中检索多个集合条目的函数。这对于[返回引用条目的数组](/zh-cn/guides/content-collections/#定义集合引用)访问其关联的`data`、`body`和`render()`属性非常有用。
+
+```astro
+---
+import { getEntries } from 'astro:content';
+
+const enterprisePost = await getEntry('blog', 'enterprise');
+
+// 获取由 `data.relatedPosts` 引用的相关帖子
+const enterpriseRelatedPosts = await getEntries(enterprisePost.data.relatedPosts);
+---
+```
+
+### `getEntryBySlug()`
+
+<p>
+
+**类型：** `(collection: string, slug: string) => Promise<CollectionEntry<TCollectionName>>`
+</p>
+
+:::caution[已废弃]
+使用 [`getEntry()`函数](#getentry) 查询内容条目。该函数接受与 `getEntryBySlug()` 相同的参数，并支持通过 `id` 查询 JSON 或 YAML 集合。
+:::
+
+`getEntryBySlug()` 是一个函数，用于通过集合名称和条目 `slug` 检索单个集合条目。
+
+```astro
+---
+import { getEntryBySlug } from 'astro:content';
+
+const enterprise = await getEntryBySlug('blog', 'enterprise');
+---
+```
+
+有关示例请 [参考`内容集合`指南](/zh-cn/guides/content-collections/#查询集合) 以获取示例用法。
+
+### `getDataEntryById()`
+
+<p>
+
+**类型：** `(collection: string, id: string) => Promise<CollectionEntry<TCollectionName>>`<br />
+<Since v="2.5.0" />
+</p>
+
+:::caution[已废弃]
+使用 [`getEntry()`函数](#getentry) 查询数据条目。该函数接受与 `getDataEntryById()` 相同的参数，并支持通过 `slug` 查询 Markdown 等内容创作格式的条目。
+:::
+
+`getDataEntryById()` 是一个用于通过集合名称和条目 `id` 检索单个集合条目的函数。
+
+```astro
+---
+import { getDataEntryById } from 'astro:content';
+
+const picardProfile = await getDataEntryById('captains', 'picard');
+---
+```
+
+## `astro:content` 类型
+
+```ts
+import type {
+  CollectionEntry,
+  CollectionKey,
+  ContentCollectionKey,
+  DataCollectionKey,
+  SchemaContext,
+ } from 'astro:content';
+```
+
+### `CollectionEntry`
+
+查询函数包括 [`getCollection()`](#getcollection)、[`getEntry()`](#getentry) 和 [`getEntries()`](#getentries)，每个函数都会返回 `CollectionEntry` 类型的条目。这种类型可以作为 `astro:content` 中的实用程序使用：
+
+```ts
+import type { CollectionEntry } from 'astro:content';
+```
+
+`CollectionEntry` 是一个泛型类型。将其与你正在查询的集合的名称一起使用。
+例如，`blog` 集合中的条目的类型为 `CollectionEntry<'blog'>`。
+
+每个 `CollectionEntry` 都是一个具有以下值的对象：
+
+#### `id`
+
+**适用于：** `type: 'content'` 和 `type: 'data'` 集合  
+**示例类型：**
+  - 内容集合: `'entry-1.md' | 'entry-2.md' | ...`
+  - 数据集合: `'author-1' | 'author-2' | ...`
+
+一个使用相对于 `src/content/[collection]` 的文件路径的唯一 ID。根据集合条目文件路径枚举所有可能的字符串值。
+请注意，[`类型: 'content'`](#type) 的集合在其 ID 中包含文件扩展名，而定义为 `type: 'data'` 的集合则不包含。
+
+#### `collection`
+
+**适用于：** `type: 'content'` 和 `type: 'data'` 集合  
+**示例类型：** `'blog' | 'authors' | ...`
+
+`src/content/` 下顶级文件夹的名称，条目位于该文件夹中。该名称用于在 schema 和查询函数中引用集合。
+
+#### `data`
+
+**适用于：** `type: 'content'` 和 `type: 'data'` 集合  
+**类型：**`CollectionSchema<TCollectionName>`
+
+一个从集合模式推断出的 frontmatter 属性对象（[参考 `defineCollection()`](#definecollection)）。如果没有配置模式，则默认为 `any`。
+
+#### `slug`
+
+**适用于：** 仅仅 `type: 'content'` 集合  
+**示例类型：** `'entry-1' | 'entry-2' | ...`
+
+可用于 Markdown 或 MDX 文档的 URL 标头。默认为不含文件扩展名的 "id"，但可以通过在文件的 frontmatter 中设置[`slug`属性](/zh-cn/guides/content-collections/#定义自定义-slugs)来覆盖。
+
+#### `body`
+
+**适用于：** 仅 `type: 'content'` 集合  
+**类型：**`string`
+
+一个包含 Markdown 或 MDX 文档原始未编译的 body 的字符串。
+
+#### `render()`
+
+**适用于：** 仅 `type: 'content'` 集合  
+**类型：**`() => Promise<RenderedEntry>`
+
+一个用于编译给定的 Markdown 或 MDX 文档以进行渲染的函数。它返回以下属性：
+
+- `<Content />` - 用于在 Astro 文件中渲染文档内容的组件。
+- `headings` - 生成的标题列表，[与 Astro 的 `getHeadings()` 工具函数相同](/zh-cn/guides/markdown-content/#可用属性) 在 Markdown 和 MDX 导入中。
+- `remarkPluginFrontmatter ` - 在应用 [remark 或 rehype 插件](/zh-cn/guides/markdown-content/#以编程方式修改-frontmatter)后修改后的 frontmatter 对象。设置为类型 `any`。
+
+```astro
+---
+import { getEntryBySlug } from 'astro:content';
+const entry = await getEntryBySlug('blog', 'entry-1');
+
+const { Content, headings, remarkPluginFrontmatter } = await entry.render();
+---
+```
+
+有关示例请 [参考 `内容集合`指南](/zh-cn/guides/content-collections/#将内容渲染成-html) 以获取示例用法。
+
+### `CollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+这是一个在 `src/content/config.*` 文件中定义的所有集合名称的字符串联合类型。当定义一个可以接受任何集合名称的通用函数时，这个类型很有用。
+
+```ts
+import { type CollectionKey, getCollection } from 'astro:content';
+
+async function getCollection(collection: CollectionKey) {
+  return getCollection(collection);
+}
+```
+
+### `ContentCollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+一个在 `src/content/config.*` 文件中定义的所有 `type: 'content'` 集合名称的字符串联合类型。
+
+### `DataCollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+一个在 `src/content/config.*` 文件中定义的所有 `type: 'data'` 集合名称的字符串联合类型。
+
+### `SchemaContext`
+
+即 `defineCollection` 在 `schema` 函数形状中所使用的 `context` 对象。当为多个集合构建可重用的模式时，这个类型很有用。
+
+它包括了以下属性：
+
+- `image` - `image()` schema 辅助工具允许你 [在内容集合中使用本地图片](/zh-cn/guides/images/#内容集合中的图像)。
+
+```ts
+import type { SchemaContext } from 'astro:content';
+
+export const imageSchema = ({ image }: SchemaContext) =>
+    z.object({
+        image: image(),
+        description: z.string().optional(),
+    });
+
+const blog = defineCollection({
+  type: 'content',
+  schema: ({ image }) => z.object({
+    title: z.string(),
+    permalink: z.string().optional(),
+    image: imageSchema({ image })
+  }),
+});
+```
diff --git a/src/content/docs/zh-cn/tutorials/add-content-collections.mdx b/src/content/docs/zh-cn/tutorials/add-content-collections.mdx
index 6884107efc30e..e3932e47ca6eb 100644
--- a/src/content/docs/zh-cn/tutorials/add-content-collections.mdx
+++ b/src/content/docs/zh-cn/tutorials/add-content-collections.mdx
@@ -246,7 +246,7 @@ import { Steps } from '@astrojs/starlight/components';
 ### 用 `getCollection()` 代替 `Astro.glob()`
 
 <Steps>
-11. 在任何你有博客文章列表的地方，比如教程中的博客页面 (`src/pages/blog.astro/`)，你需要将 `Astro.glob()` 替换为 [`getCollection()`](/zh-cn/reference/api-reference/#getcollection) 来获取 Markdown 文件的内容和元数据。
+11. 在任何你有博客文章列表的地方，比如教程中的博客页面 (`src/pages/blog.astro/`)，你需要将 `Astro.glob()` 替换为 [`getCollection()`](/zh-cn/reference/modules/astro-content/#getcollection) 来获取 Markdown 文件的内容和元数据。
 
     ```astro title="src/pages/blog.astro" "post.data" "getCollection(\"posts\")" "/posts/${post.slug}/" del={7} ins={2,8}
     ---

From 38cc9a31054684024e23a45a4c1ea0affc69105a Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 15:44:02 +0800
Subject: [PATCH 25/43] i18n(zh-cn): add `astro-i18n.mdx` &
 `astro-middleware.mdx` and update related link (#9847)

* i18n(zh-cn): add `astro-i18n.mdx`

* i18n(zh-cn): add `astro-middleware.mdx`

* Update link in `internationalization.mdx`

* Update link in `middleware.mdx`

* fix: link in `astro-middleware.mdx`

* Update src/content/docs/zh-cn/reference/modules/astro-middleware.mdx

Co-authored-by: liruifengv <liruifeng1024@gmail.com>

---------

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 .../zh-cn/guides/internationalization.mdx     |   8 +-
 src/content/docs/zh-cn/guides/middleware.mdx  |   4 +-
 .../zh-cn/reference/modules/astro-i18n.mdx    | 334 ++++++++++++++++++
 .../reference/modules/astro-middleware.mdx    | 122 +++++++
 4 files changed, 462 insertions(+), 6 deletions(-)
 create mode 100644 src/content/docs/zh-cn/reference/modules/astro-i18n.mdx
 create mode 100644 src/content/docs/zh-cn/reference/modules/astro-middleware.mdx

diff --git a/src/content/docs/zh-cn/guides/internationalization.mdx b/src/content/docs/zh-cn/guides/internationalization.mdx
index 85bdfdf80916b..5c1bf63483ea8 100644
--- a/src/content/docs/zh-cn/guides/internationalization.mdx
+++ b/src/content/docs/zh-cn/guides/internationalization.mdx
@@ -60,7 +60,7 @@ export default defineConfig({
 
 ### 创建链接
 
-配置了 i18n 路由后，你现在可以使用诸如 [`astro:i18n` 模块](/zh-cn/reference/api-reference/#国际化astroi18n) 中提供的 [`getRelativeLocaleUrl()`](/zh-cn/reference/api-reference/#getrelativelocaleurl) 辅助函数来计算站点内页面的链接。这些生成的链接将始终提供正确的、本地化的路由，并且可以帮助你正确地使用或检查站点上的 URL。
+配置了 i18n 路由后，你现在可以使用诸如 [`astro:i18n` 模块](/zh-cn/reference/modules/astro-i18n/) 中提供的 [`getRelativeLocaleUrl()`](/zh-cn/reference/modules/astro-i18n/#getrelativelocaleurl) 辅助函数来计算站点内页面的链接。这些生成的链接将始终提供正确的、本地化的路由，并且可以帮助你正确地使用或检查站点上的 URL。
 
 你也可以选择手动编写链接。
 
@@ -196,7 +196,7 @@ export default defineConfig({
 })
 ```
 
-Astro 为你的中间件提供了辅助函数，以便你可以控制自己的默认路由、异常、回退行为、错误捕获等：[`redirectToDefaultLocale()`](/zh-cn/reference/api-reference/#redirecttodefaultlocale)、[`notFound()`](/zh-cn/reference/api-reference/#notfound) 和 [`redirectToFallback()`](/zh-cn/reference/api-reference/#redirecttofallback)：
+Astro 为你的中间件提供了辅助函数，以便你可以控制自己的默认路由、异常、回退行为、错误捕获等：[`redirectToDefaultLocale()`](/zh-cn/reference/modules/astro-i18n/#redirecttodefaultlocale)、[`notFound()`](/zh-cn/reference/modules/astro-i18n/#notfound) 和 [`redirectToFallback()`](/zh-cn/reference/modules/astro-i18n/#redirecttofallback)：
 
 
 ```js title="src/middleware.js"
@@ -215,7 +215,7 @@ export const onRequest = defineMiddleware(async (ctx, next) => {
 
 [`middleware`](#中间件函数) 函数手动创建 Astro 的 i18n 中间件。这允许你扩展 Astro 的 i18n 路由，而不是完全替换它。
 
-你可以将带有 [路由选项](#routing)的 `middleware` 与你自己的中间件结合使用，通过使用 [`sequence`](/zh-cn/reference/api-reference/#sequence) 工具来确定顺序运行 `middleware`：
+你可以将带有 [路由选项](#routing)的 `middleware` 与你自己的中间件结合使用，通过使用 [`sequence`](/zh-cn/reference/modules/astro-middleware/#sequence) 工具来确定顺序运行 `middleware`：
 
 ```js title="src/middleware.js"
 import { defineMiddleware, sequence } from "astro:middleware";
@@ -341,7 +341,7 @@ export default defineConfig({
 })
 ```
 
-当使用来自 [`astro:i18n` 虚拟模块](/zh-cn/reference/api-reference/#国际化astroi18n) 的函数根据你的配置计算有效的 URL 路径时（例如 `getRelativeLocaleUrl()`），[请使用 `path` 作为 `locale` 的值](/zh-cn/reference/api-reference/#getlocalebypath)。
+当使用来自 [`astro:i18n` 虚拟模块](/zh-cn/reference/modules/astro-i18n/) 的函数根据你的配置计算有效的 URL 路径时（例如 `getRelativeLocaleUrl()`），[请使用 `path` 作为 `locale` 的值](/zh-cn/reference/modules/astro-i18n/#getlocalebypath)。
 
 #### 限制
 
diff --git a/src/content/docs/zh-cn/guides/middleware.mdx b/src/content/docs/zh-cn/guides/middleware.mdx
index 3c6e9e734a707..a04a2c83f7b69 100644
--- a/src/content/docs/zh-cn/guides/middleware.mdx
+++ b/src/content/docs/zh-cn/guides/middleware.mdx
@@ -16,7 +16,7 @@ import Since from '~/components/Since.astro';
 <Steps>
 1. 创建 `src/middleware.js|ts`（或者，你也可以创建 `src/middleware/index.js|ts`）
 
-2. 在这个文件中，导出一个接收 [`context` 对象](#context-对象) 的 [`onRequest()`](/zh-cn/reference/api-reference/#onrequest) 函数。注意这里不能是默认导出。
+2. 在这个文件中，导出一个接收 [`context` 对象](#context-对象) 的 [`onRequest()`](/zh-cn/reference/modules/astro-middleware/#onrequest) 函数。注意这里不能是默认导出。
 
     ```js title="src/middleware.js"
     export function onRequest (context, next) {
@@ -158,7 +158,7 @@ declare namespace App {
 
 ## 中间件链式调用
 
-可以使用 [`sequence()`](/zh-cn/reference/api-reference/#sequence) 按指定顺序连接多个中间件：
+可以使用 [`sequence()`](/zh-cn/reference/modules/astro-middleware/#sequence) 按指定顺序连接多个中间件：
 
 ```js title="src/middleware.js"
 import { sequence } from "astro:middleware";
diff --git a/src/content/docs/zh-cn/reference/modules/astro-i18n.mdx b/src/content/docs/zh-cn/reference/modules/astro-i18n.mdx
new file mode 100644
index 0000000000000..ac59c747fb6f7
--- /dev/null
+++ b/src/content/docs/zh-cn/reference/modules/astro-i18n.mdx
@@ -0,0 +1,334 @@
+---
+title: 国际化 API 参考
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="3.5.0" /></p>
+
+此模块提供了一些函数，帮助你使用项目配置的语言环境设置创建 URL。
+
+使用 i18n 路由为你的项目创建路由将依赖于你设置的某些配置值，这些值会影响你的页面路由。使用这些函数创建路由时，请确保考虑到你的个人设置，包括：
+
+- [`base`](/zh-cn/reference/configuration-reference/#base)
+- [`trailingSlash`](/zh-cn/reference/configuration-reference/#trailingslash)
+- [`build.format`](/zh-cn/reference/configuration-reference/#buildformat)
+- [`site`](/zh-cn/reference/configuration-reference/#site)
+
+另外，请注意，这些函数为你的 `defaultLocale` 创建的返回 URL 将反映你的 `i18n.routing` 配置。
+
+有关功能和使用示例，请参阅[我们的 i18n 路由指南](/zh-cn/guides/internationalization/)。
+
+## 从 `astro:i18n` 导入
+
+```js
+import { 
+  getRelativeLocaleUrl,
+  getAbsoluteLocaleUrl,
+  getRelativeLocaleUrlList,
+  getAbsoluteLocaleUrlList,
+  getPathByLocale,
+  getLocaleByPath,
+  redirectToDefaultLocale,
+  redirectToFallback,
+  notFound,
+  middleware,
+  requestHasLocale,
+ } from 'astro:i18n';
+```
+
+### `getRelativeLocaleUrl()` 
+
+<p>
+
+**类型：**`(locale: string, path?: string,  options?: GetLocaleOptions) => string`
+</p>
+
+`getRelativeLocaleUrl(locale: string, path?: string,  options?: GetLocaleOptions): string`
+
+使用此函数来检索一个语言环境的相对路径。如果该语言环境不存在，Astro 会抛出一个错误。
+
+```astro
+---
+getRelativeLocaleUrl("fr");
+// 返回 /fr
+
+getRelativeLocaleUrl("fr", "");
+// 返回 /fr
+
+getRelativeLocaleUrl("fr", "getting-started");
+// 返回 /fr/getting-started
+
+getRelativeLocaleUrl("fr_CA", "getting-started", {
+  prependWith: "blog"
+}); 
+// 返回 /blog/fr-ca/getting-started
+
+getRelativeLocaleUrl("fr_CA", "getting-started", {
+  prependWith: "blog",
+  normalizeLocale: false
+}); 
+// 返回 /blog/fr_CA/getting-started
+---
+```
+
+### `getAbsoluteLocaleUrl()` 
+
+<p>
+
+**类型：**`(locale: string, path: string, options?: GetLocaleOptions) => string`
+</p>
+
+当 [`site`] 配置了值时，使用这个函数来检索一个语言环境的绝对路径。如果 [`site`] 没有被配置，该函数将返回一个相对 URL。如果语言环境不存在，Astro 会抛出一个错误。
+
+
+```astro title="src/pages/index.astro"
+---
+// 如果 `site` 被设置为 `https://example.com`
+
+getAbsoluteLocaleUrl("fr"); 
+// 返回 https://example.com/fr
+
+getAbsoluteLocaleUrl("fr", ""); 
+// 返回 https://example.com/fr
+
+getAbsoluteLocaleUrl("fr", "getting-started"); 
+// 返回 https://example.com/fr/getting-started
+
+getAbsoluteLocaleUrl("fr_CA", "getting-started", {
+  prependWith: "blog"
+}); 
+// 返回 https://example.com/blog/fr-ca/getting-started
+
+getAbsoluteLocaleUrl("fr_CA", "getting-started", {
+  prependWith: "blog",
+  normalizeLocale: false
+}); 
+// 返回 https://example.com/blog/fr_CA/getting-started
+---
+```
+ 
+### `getRelativeLocaleUrlList()` 
+
+<p>
+
+**类型：**`(path?: string, options?: GetLocaleOptions) => string[]`
+</p>
+
+像使用 [`getAbsoluteLocaleUrl`](#getrelativelocaleurl) 那样使用此函数，返回所有语言环境的绝对路径列表。
+
+### `getAbsoluteLocaleUrlList()` 
+
+<p>
+
+**类型：**`(path?: string, options?: GetLocaleOptions) => string[]`
+</p>
+
+像使用 [`getAbsoluteLocaleUrl`](/zh-cn/guides/internationalization/#自定义语言环境路径) 那样使用此函数，返回所有语言环境的绝对路径列表。
+
+### `getPathByLocale()` 
+
+<p>
+
+**类型：**`(locale: string) => string`
+</p>
+
+当配置了[自定义语言环境路径](/zh-cn/guides/internationalization/#自定义语言环境路径)时，此函数返回与一个或多个 `codes` 关联的 `path`。
+
+```js title="astro.config.mjs"
+export default defineConfig({
+  i18n: {
+    locales: ["es", "en", {
+      path: "french",
+      codes: ["fr", "fr-BR", "fr-CA"]
+    }]
+  }
+})
+```
+
+```astro title="src/pages/index.astro"
+---
+import { getPathByLocale } from 'astro:i18n';
+
+getPathByLocale("fr"); // 返回 "french"
+getPathByLocale("fr-CA"); // 返回 "french"
+---
+```
+
+### `getLocaleByPath()`
+
+<p>
+
+**类型：**`(path: string) => string`
+</p>
+
+此函数返回与语言环境 `path` 关联的 `code`。
+
+```js title="astro.config.mjs"
+export default defineConfig({
+  i18n: {
+    locales: ["es", "en", {
+      path: "french",
+      codes: ["fr", "fr-BR", "fr-CA"]
+    }]
+  }
+})
+```
+
+```astro title="src/pages/index.astro"
+---
+import { getLocaleByPath } from 'astro:i18n';
+
+getLocaleByPath("french"); // 返回 "fr"，因为这是首个配置的代码
+---
+```
+
+### `redirectToDefaultLocale()`
+
+<p>
+
+**类型：**`(context: APIContext, statusCode?: ValidRedirectStatus) => Promise<Response>`<br />
+<Since v="4.6.0" />
+</p>
+
+:::note
+仅当 `i18n.routing` 设置为 `"manual"` 时可用。
+:::
+
+此函数返回一个 `Response`，将重定向到配置的 `defaultLocale`。它接受一个可选的有效重定向状态码。
+
+```js title="middleware.js"
+import { defineMiddleware } from "astro:middleware";
+import { redirectToDefaultLocale } from "astro:i18n";
+
+export const onRequest = defineMiddleware((context, next) => {
+  if (context.url.pathname.startsWith("/about")) {
+    return next();
+  } else {
+    return redirectToDefaultLocale(context, 302);
+  }
+})
+```
+
+### `redirectToFallback()`
+
+<p>
+
+**类型：**`(context: APIContext, response: Response) => Promise<Response>`<br />
+<Since v="4.6.0" />
+</p>
+
+:::note
+仅当 `i18n.routing` 设置为 `"manual"` 时可用。
+:::
+
+此函数允许你在自己的中间件中使用你的 [`i18n.fallback` 配置](/zh-cn/reference/configuration-reference/#i18nfallback)。
+
+```js title="middleware.js"
+import { defineMiddleware } from "astro:middleware";
+import { redirectToFallback } from "astro:i18n";
+
+export const onRequest = defineMiddleware(async (context, next) => {
+  const response = await next();
+  if (response.status >= 300) {
+    return redirectToFallback(context, response)
+  }
+  return response;
+})
+```
+
+### `notFound()`
+
+<p>
+
+**类型：**`(context: APIContext, response?: Response) => Promise<Response> | undefined`<br />
+<Since v="4.6.0" />
+</p>
+
+:::note
+仅当 `i18n.routing` 设置为 `"manual"` 时可用。
+:::
+
+当以下情况发生时，在你的路由中间件中使用此函数来返回一个 404 错误：
+- 当前路径不是根路径。例如：`/` 或 `/<base>`
+- URL 中不包含语言环境代码
+
+当传递了一个 `Response`，由此函数发出的新 `Response` 将包含原始响应的相同头信息。
+
+```js title="middleware.js"
+import { defineMiddleware } from "astro:middleware";
+import { notFound } from "astro:i18n";
+
+export const onRequest = defineMiddleware((context, next) => {
+  const pathNotFound = notFound(context);
+  if (pathNotFound) {
+    return pathNotFound;
+  }
+  return next();
+})
+```
+
+### `middleware()`
+
+<p>
+
+**类型：**`(options: { prefixDefaultLocale: boolean, redirectToDefaultLocale: boolean }) => MiddlewareHandler`<br />
+<Since v="4.6.0" />
+</p>
+
+:::note
+仅当 `i18n.routing` 设置为 `"manual"` 时可用。
+:::
+
+此函数允许你以编程方式创建 Astro i18n 中间件。
+
+当你仍然想要使用默认的 i18n 逻辑，但只在你的网站添加少数例外时，这个功能非常有用。
+
+```js title="middleware.js"
+import { middleware } from "astro:i18n";
+import { sequence, defineMiddleware } from "astro:middleware";
+
+const customLogic = defineMiddleware(async (context, next) => {
+  const response = await next();
+
+  // 在这里解析响应后的自定义逻辑。
+  // 可以捕获来自 Astro i18n 中间件的响应。
+
+  return response;
+});
+
+export const onRequest = sequence(customLogic, middleware({
+	prefixDefaultLocale: true,
+	redirectToDefaultLocale: false
+}))
+```
+
+### `requestHasLocale()`
+
+<p>
+
+**类型：**`(context: APIContext) => boolean`<br />
+<Since v="4.6.0" />
+</p>
+
+:::note
+仅当 `i18n.routing` 设置为 `"manual"` 时可用。
+:::
+
+检查当前 URL 是否包含已配置的语言环境代码。在内部，此函数将使用 `APIContext#url.pathname`。
+
+```js title="middleware.js"
+import { defineMiddleware } from "astro:middleware";
+import { requestHasLocale } from "astro:i18n";
+
+export const onRequest = defineMiddleware(async (context, next) => {
+  if (requestHasLocale(context)) {
+    return next();
+  }
+  return new Response("Not found", { status: 404 });
+})
+```
diff --git a/src/content/docs/zh-cn/reference/modules/astro-middleware.mdx b/src/content/docs/zh-cn/reference/modules/astro-middleware.mdx
new file mode 100644
index 0000000000000..5c0ecd3837ef2
--- /dev/null
+++ b/src/content/docs/zh-cn/reference/modules/astro-middleware.mdx
@@ -0,0 +1,122 @@
+---
+title: 中间件 API 参考
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="2.6.0" /></p>
+
+中间件使你能拦截请求和响应，并在每次渲染页面或端点时动态注入行为。有关功能和用法示例，请参考 [中间件指南](/zh-cn/guides/middleware/)。
+
+## 从 `astro:middleware` 导入
+
+```js
+import { 
+  sequence,
+  createContext,
+  trySerializeLocals,
+  defineMiddleware,
+ } from 'astro:middleware';
+```
+
+### `defineMiddleware()`
+
+你可以导入并使用 `defineMiddleware()` 实用函数来提供类型安全：
+
+```ts
+// src/middleware.ts
+import { defineMiddleware } from "astro:middleware";
+
+// `context` 和 `next` 会自动被类型化
+export const onRequest = defineMiddleware((context, next) => {
+
+});
+```
+
+### `sequence()`
+
+<p>
+
+**类型：**`(...handlers: MiddlewareHandler[]) => MiddlewareHandler`
+</p>
+
+一个接受中间件函数作为参数的函数，它将按照它们传递的顺序执行它们。
+
+```js title="src/middleware.js"
+import { sequence } from "astro:middleware";
+
+async function validation(_, next) {...}
+async function auth(_, next) {...}
+async function greeting(_, next) {...}
+
+export const onRequest = sequence(validation, auth, greeting);
+```
+
+### `createContext()`
+
+<p>
+
+**类型：**`(context: CreateContext) => APIContext`<br />
+<Since v="2.8.0" />
+</p>
+
+一个底层 API，用于创建一个 [`APIContext`](/zh-cn/reference/api-reference/#端点上下文) 以传递给 Astro 中间件的 `onRequest()` 函数。
+
+此函数可以由集成/适配器用于执行 Astro 中间件。
+
+### `trySerializeLocals()`
+
+<p>
+
+**类型：**`(value: unknown) => string`<br />
+<Since v="2.8.0" />
+</p>
+
+一个底层 API，它接受任何值并尝试返回它的序列化版本（一个字符串）。如果该值无法序列化，该函数将抛出一个运行时错误。
+
+## 中间件导出
+
+在 `src/middleware.js` 中定义项目的中间件时，导出以下用户定义的函数：
+
+### `onRequest()`
+
+**类型：**`(context: APIContext, next: MiddlewareNext) => Promise<Response> | Response | Promise<void> | void`
+
+一个在 `src/middleware.js` 里的必须导出的函数，它将在每次渲染页面或端点时被调用。它接受两个参数：[context](#context) 和 [next()](#next)。`onRequest()` 必须返回一个 `Response`：要么直接返回，要么通过调用 `next()` 返回。
+
+```js title="src/middleware.js"
+export function onRequest (context, next) {
+    // 拦截一个请求的响应数据
+    // 可选修改响应
+    // 直接返回一个 Response 对象，或者调用 `next()` 的结果
+    return next();
+};
+```
+
+你的 `onRequest()` 函数将使用以下参数调用：
+
+#### `context`
+
+<p>
+
+**类型：**`APIContext`
+</p>
+
+`onRequest()` 的第一个参数是一个上下文对象。它反映了许多 `Astro` 全局属性。
+
+<ReadMore>有关更多信息，请参阅 [端点上下文](/zh-cn/reference/api-reference/#端点上下文)。</ReadMore>
+
+#### `next()`
+
+<p>
+
+**类型：**`(rewritePayload?: string | URL | Request) => Promise<Response>`<br />
+</p>
+
+`onRequest()` 的第二个参数是一个调用链中的所有后续中间件，并返回一个 `Response` 的函数。例如，其他中间件可以修改响应的 HTML 主体，等待 `next()` 的结果将允许你的中间件响应这些更改。
+
+自从 Astro v4.13.0，`next()` 接受一个可选的 URL 路径参数，形式为字符串、`URL` 或 `Request`，用于[重写](/zh-cn/guides/routing/#重写)当前请求而不重新触发新的渲染阶段。

From 9093f9f17c317f8ce9deb32838492f0fe74d6994 Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 15:50:43 +0800
Subject: [PATCH 26/43] i18n(zh-cn): add `astro-transitions.mdx` (#9848)

* i18n(zh-cn): add `astro-transitions.mdx`

* fix: keep it in English

Co-authored-by: liruifengv <liruifeng1024@gmail.com>

* fix: keep it in English

---------

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 .../reference/modules/astro-transitions.mdx   | 456 ++++++++++++++++++
 1 file changed, 456 insertions(+)
 create mode 100644 src/content/docs/zh-cn/reference/modules/astro-transitions.mdx

diff --git a/src/content/docs/zh-cn/reference/modules/astro-transitions.mdx b/src/content/docs/zh-cn/reference/modules/astro-transitions.mdx
new file mode 100644
index 0000000000000..57c6432da53b4
--- /dev/null
+++ b/src/content/docs/zh-cn/reference/modules/astro-transitions.mdx
@@ -0,0 +1,456 @@
+---
+title: 视图过渡动画 API 参考
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="3.0.0" /></p>
+
+此模块提供了一些函数，用于控制和与视图过渡 API 和客户端路由进行交互。
+
+对于功能和使用示例，[请参阅我们的视图过渡指南](/zh-cn/guides/view-transitions/)。
+
+## 从 `astro:transitions` 导入
+
+```ts
+import { ViewTransitions, fade, slide } from 'astro:transitions';
+```
+
+### `<ViewTransitions />`
+
+<p><Since v="3.0.0" /></p>
+
+通过将 `<ViewTransitions />` 路由组件导入并添加到每个所需页面的 `<head>` 部分，以选择在各个页面上使用视图过渡动画。
+
+```astro title="src/pages/index.astro" ins={2,7}
+---
+import { ViewTransitions } from 'astro:transitions';
+---
+<html lang="en">
+  <head>
+    <title>我的首页</title>
+    <ViewTransitions />
+  </head>
+  <body>
+    <h1>欢迎来到我的网站！</h1>
+  </body>
+</html>
+```
+
+查看有关如何 [控制路由器](/zh-cn/guides/view-transitions/#路由器控制)以及 [添加过渡指令](/zh-cn/guides/view-transitions/#过渡动画指令) 到页面元素和组件的更多信息。
+
+### `fade`
+
+<p>
+
+**类型：** `(opts: { duration?: string | number }) => TransitionDirectionalAnimations`
+<Since v="3.0.0" />
+</p>
+
+支持自定义内置 `fade` 动画持续时间的实用函数。
+
+```astro {2} /fade\\(.+\\)/
+---
+import { fade } from 'astro:transitions';
+---
+
+<!-- 使用默认持续时间的淡入淡出过渡 -->
+<div transition:animate="fade" />
+
+<!-- 持续时间为 400 毫秒的淡入淡出过渡 -->
+<div transition:animate={fade({ duration: '0.4s' })} />
+```
+
+### `slide`
+
+<p>
+
+**类型：** `(opts: { duration?: string | number }) => TransitionDirectionalAnimations`
+<Since v="3.0.0" />
+</p>
+
+支持自定义内置 `slide` 动画持续时间的实用函数。
+
+```astro {2} /slide\\(.+\\)/
+---
+import { slide } from 'astro:transitions';
+---
+
+<!-- 使用默认持续时间的滑动过渡 -->
+<div transition:animate="slide" />
+
+<!-- 持续时间为 400 毫秒的滑动过渡 -->
+<div transition:animate={slide({ duration: '0.4s' })} />
+```
+
+## 从 `astro:transitions/client` 导入
+
+```astro
+<script>
+  import { 
+    navigate,
+    supportsViewTransitions,
+    transitionEnabledOnThisPage,
+    getFallback,
+    swapFunctions,
+  } from 'astro:transitions/client';
+</script>
+```
+
+### `navigate()`
+
+<p>
+
+**类型：**`(href: string, options?: Options) => void`<br />
+<Since v="3.2.0" />
+</p>
+
+一个使用视图过渡 API 导航到给定 `href` 的函数。
+
+此函数签名基于 [浏览器 Navigation API 中的 `navigate` 函数](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate)。虽然基于 Navigation API，但此函数是在 [History API](https://developer.mozilla.org/zh-CN/docs/Web/API/History_API) 之上实现的，以允许在不重新加载页面的情况下进行导航。
+
+#### `history` 选项
+
+<p>
+
+**类型：**`'auto' | 'push' | 'replace'`<br />
+**默认值：**`'auto'`<br />
+<Since v="3.2.0" />
+</p>
+
+定义了如何将此导航添加到浏览器历史记录中。
+
+- `'push'`：路由将使用 `history.pushState` 在浏览器历史记录中创建一个新条目。
+- `'replace'`：路由将使用 `history.replaceState` 更新 URL，而不会在导航中添加新条目。
+- `'auto'`（默认）：路由将尝试 `history.pushState`，但如果无法进行过渡，则当前 URL 将保持不变，浏览器历史记录不会发生变化。
+
+此选项遵循浏览器 Navigation API 中的 [`history` 选项](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#history)，但简化了在 Astro 项目中可能发生的情况。
+
+#### `formData` 选项
+
+<p>
+
+**类型：**`FormData`<br />
+<Since v="3.5.0" />
+</p>
+
+一个 `FormData` 对象，用于 `POST` 请求。
+
+当提供此选项时，导航目标页面的请求将以 `POST` 请求的形式发送，内容为表单数据对象。
+
+当提交一个带有视图过渡的 HTML 表单时，将使用此方法代替默认的页面重新加载导航。调用此方法允许以编程方式触发相同的行为。
+
+#### `info` 选项
+
+<p>
+
+**类型：**`any`<br />
+<Since v="3.6.0" />
+</p>
+
+与导航相关的 `astro:before-preparation` 和 `astro:before-swap` 事件中包含的任意数据。
+
+此选项模仿了浏览器 Navigation API 中的 [`info` 选项](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#info)。
+
+#### `state` 选项
+
+<p>
+
+**类型：**`any`<br />
+<Since v="3.6.0" />
+</p>
+
+与导航相关的 `NavitationHistoryEntry` 对象中关联的任意数据。此数据可以通过 [`history.getState` 函数](https://developer.mozilla.org/en-US/docs/Web/API/NavigationHistoryEntry/getState) 从 History API 中检索。
+
+此选项模仿了浏览器 Navigation API 中的 [`state` 选项](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#state)。
+
+#### `sourceElement` 选项
+
+<p>
+
+**类型：**`Element`<br />
+<Since v="3.6.0" />
+</p>
+
+此导航的触发元素，如果有的话。此元素将在以下事件中可用：
+- `astro:before-preparation`
+- `astro:before-swap`
+
+### `supportsViewTransitions`
+
+<p>
+
+**类型：**`boolean`<br />
+<Since v="3.2.0" />
+</p>
+
+当前浏览器是否支持并启用视图过渡。
+
+### `transitionEnabledOnThisPage`
+
+<p>
+
+**类型：**`boolean`<br />
+<Since v="3.2.0" />
+</p>
+
+当前页面是否启用了视图过渡以进行客户端导航。这可以用于使组件在视图过渡页面上的行为有所不同。
+
+### `getFallback`
+
+<p>
+
+**类型：**`() => 'none' | 'animate' | 'swap'`<br />
+<Since v="3.6.0" />
+</p>
+
+返回在浏览器不支持视图过渡时使用的回退策略。
+
+有关如何选择和配置回退行为的详细信息，请参阅 [回退控制](/zh-cn/guides/view-transitions/#回退控制) 指南。
+
+### `swapFunctions`
+
+<p>
+
+<Since v="4.15.0" />
+</p>
+
+一个对象，其中包含了用于构建 Astro 默认交换函数的工具类函数。
+这些函数在 [构建自定义交换函数](/zh-cn/guides/view-transitions/#构建自定义交换函数) 时非常有用。
+
+`swapFunctions` 提供了以下方法：
+
+#### `deselectScripts()`
+
+<p>
+
+**类型：** `(newDocument: Document) => void`
+</p>
+
+标记在新的 document 中不应执行的脚本。这些脚本已经在当前 document 中，并且没有使用 [`data-astro-rerun`](/zh-cn/guides/view-transitions/#data-astro-rerun) 标记为重新执行。
+
+#### `swapRootAttributes()`
+
+<p>
+
+**类型：**`(newDocument: Document) => void`
+</p>
+
+在 document 根节点之间交换属性，如 `lang` 属性。这也包括 Astro 注入的内部属性，如 `data-astro-transition`，这使得过渡方向可用于 Astro 生成的 CSS 规则。
+
+在构建自定义交换函数时，重要的是调用此函数，以避免破坏视图过渡的动画。
+
+#### `swapHeadElements()`
+
+<p>
+
+**类型：**`(newDocument: Document) => void`
+</p>
+
+从当前 document 的 `<head>` 中删除所有未持久化到新 document 的元素。然后将新 document 的 `<head>` 中的所有新元素附加到当前 document 的 `<head>`。
+
+#### `saveFocus()`
+
+<p>
+
+**类型：**`() => () => void`
+</p>
+
+在当前页面上存储聚焦的元素，并返回一个函数，当调用时，如果聚焦的元素被持久化，则将焦点返回给该元素。
+
+#### `swapBodyElement()`
+
+<p>
+
+**类型：**`(newBody: Element, oldBody: Element) => void`
+</p>
+
+用新 document 的 body 替换旧的 body。然后，遍历旧 body 中应持久化的每个元素，并在新 body 中找到匹配的元素，将旧元素交换回原位。
+
+## 生命周期事件
+
+### `astro:before-preparation` 事件
+
+在视图过渡中导航开始时触发的事件。此事件发生在任何请求之前，并且不会更改任何浏览器状态。
+
+此事件具有以下属性：
+- [`info`](#info)
+- [`sourceElement`](#sourceelement)
+- [`navigationType`](#navigationtype)
+- [`direction`](#direction)
+- [`from`](#from)
+- [`to`](#to)
+- [`formData`](#formdata)
+- [`loader()`](#loader)
+
+有关如何使用此事件的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#astrobefore-preparation)。
+
+### `astro:after-preparation` 事件
+
+使用视图过渡加载导航中的下一个页面后触发的事件。
+
+此事件没有属性。
+
+有关如何使用此事件的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#astroafter-preparation)。
+
+### `astro:before-swap` 事件
+
+在视图过渡中导航的下一个页面解析、准备并链接到 document 后，但在任何内容在 document 之间交换之前触发的事件。
+
+此事件不能取消。调用 `preventDefault()` 是无效的。
+
+此事件具有以下属性：
+- [`info`](#info)
+- [`sourceElement`](#sourceelement)
+- [`navigationType`](#navigationtype)
+- [`direction`](#direction)
+- [`from`](#from)
+- [`to`](#to)
+- [`viewTransition`](#viewtransition)
+- [`swap`](#swap)
+
+有关如何使用此事件的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#astrobefore-swap)。
+
+### `astro:after-swap` 事件
+
+在视图过渡中导航的下一个页面内容交换后，但在视图过渡结束之前触发的事件。
+
+在触发此事件时，历史记录条目和滚动位置已经更新。
+
+### `astro:page-load` 事件
+
+在页面完成加载后触发的事件，无论是通过视图过渡导航还是浏览器原生导航。
+
+当视图过渡在页面上启用时，通常在 `DOMContentLoaded` 上执行的代码应更改为在此事件上执行。
+
+### 生命周期事件属性
+
+<p><Since v="3.6.0" /></p>
+
+#### `info`
+
+<p>
+
+**类型：**`URL`
+</p>
+
+在导航期间定义的任意数据。
+
+这是在 [`navigate()` 函数](#navigate) 的 [`info` 选项](#info-选项) 中传递的文字值。
+
+#### `sourceElement`
+
+<p>
+
+**类型：**`Element | undefined`
+</p>
+
+触发导航的元素。例如，这可以是点击的 `<a>` 元素。
+
+当使用 [`navigate()` 函数](#navigate) 时，这将是调用中指定的元素。
+
+#### `newDocument`
+
+<p>
+
+**类型：**`Document`
+</p>
+
+导航中下一个页面的 document。此 document 的内容将替换当前 document 的内容。
+
+#### `navigationType`
+
+<p>
+
+**类型：**`'push' | 'replace' | 'traverse'`
+</p>
+
+正在发生的导航类型。
+- `push`: 正在为新页面创建一个新的 `NavigationHistoryEntry`。
+- `replace`: 当前的 `NavigationHistoryEntry` 正在被新页面的条目替换。
+- `traverse`: 没有创建 `NavigationHistoryEntry`。历史记录中的位置正在改变。
+  遍历的方向由 [`direction` 属性](#direction) 给出
+
+#### `direction`
+
+<p>
+
+**类型：**`Direction`
+</p>
+
+过渡的方向。
+- `forward`: 在历史记录中导航到下一个页面或新页面。
+- `back`: 在历史记录中导航到前一个页面。
+- 其他监听器可能设置的任何其他内容。
+
+#### `from`
+
+<p>
+
+**类型：**`URL`
+</p>
+
+正在导航的页面的 URL。
+
+#### `to`
+
+<p>
+
+**类型：**`URL`
+</p>
+
+正在导航的页面的 URL。此属性可以修改，在生命周期结束时使用的值将是下一个页面的 `NavigationHistoryEntry` 的值。
+
+#### `formData`
+
+<p>
+
+**类型：**`FormData | undefined`
+</p>
+
+一个用于 `POST` 请求的 `FormData` 对象。
+
+当此属性设置时，将使用给定的表单数据对象作为内容发送 `POST` 请求到 [`to` URL](#to)，而不是正常的 `GET` 请求。
+
+当提交一个带有视图过渡的 HTML 表单时，此字段会自动设置为表单中的数据。当使用 [`navigate()` 函数](#navigate) 时，此值与给定的选项相同。
+
+#### `loader`
+
+<p>
+
+**类型：**`() => Promise<void>`
+</p>
+
+在导航过程中下个阶段的实现（加载下一个页面）。此实现可以覆盖以添加额外的行为。
+
+#### `viewTransition`
+
+<p>
+
+**类型：**[`ViewTransition`](https://developer.mozilla.org/zh-CN/docs/Web/API/ViewTransition)
+</p>
+
+在导航过程中使用的视图过渡对象。在浏览器不支持 [视图过渡 API](https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API) 的情况下，这是一个对象，实现了相同的 API 以方便使用，但没有 DOM 集成。
+
+#### `swap`
+
+<p>
+
+**类型：**`() => void`
+</p>
+
+document 交换逻辑的实现。
+
+有关如何构建自定义交换函数的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#构建自定义交换函数).
+
+默认情况下，此实现将按顺序调用以下函数：
+
+1. [`deselectScripts()`](#deselectscripts)
+2. [`swapRootAttributes()`](#swaprootattributes)
+3. [`swapHeadElements()`](#swapheadelements)
+4. [`saveFocus()`](#savefocus)
+5. [`swapBodyElement()`](#swapbodyelement)

From ac61ebe58b6a5b1c6d935de5985f0989e1a4e9b3 Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Mon, 28 Oct 2024 16:14:51 +0800
Subject: [PATCH 27/43] i18n(zh-cn): Update `api-reference.mdx` (#9849)

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 .../docs/zh-cn/reference/api-reference.mdx    | 1283 +----------------
 1 file changed, 5 insertions(+), 1278 deletions(-)

diff --git a/src/content/docs/zh-cn/reference/api-reference.mdx b/src/content/docs/zh-cn/reference/api-reference.mdx
index c356917a685bc..2c0cc9417d4ec 100644
--- a/src/content/docs/zh-cn/reference/api-reference.mdx
+++ b/src/content/docs/zh-cn/reference/api-reference.mdx
@@ -1,5 +1,9 @@
 ---
-title: API 参考
+title: Astro 运行时 API
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 4
 ---
 import Since from '~/components/Since.astro';
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
@@ -1390,1280 +1394,3 @@ export default function () {
   return import.meta.env.SSR ? <div class="spinner"></div> : <FancyComponent />;
 }
 ```
-
-## 图像（`astro:assets`）
-
-### `getImage()`
-
-<p>
-
-**类型：**`(options: UnresolvedImageTransform) => Promise<GetImageResult>`
-</p>
-
-:::caution
-`getImage()` 依赖于仅在服务器上可用的 API，当在客户端使用时会导致构建失败。
-:::
-
-`getImage()`函数旨在生成用于在 HTML 之外的其他地方所使用的图像，例如在 [API 路由](/zh-cn/guides/endpoints/#服务器端点api-路由) 中。它还允许你创建自定义的 `<Image />` 组件。
-
-`getImage()` 函数接受一个选项对象，其中包含与 [Image 组件相同的属性](/zh-cn/reference/components-reference/#属性)（除了 `alt`）。
-
-```astro
----
-import { getImage } from "astro:assets";
-import myBackground from "../background.png"
-const optimizedBackground = await getImage({src: myBackground, format: 'avif'})
----
-<div style={`background-image: url(${optimizedBackground.src});`}></div>
-```
-
-它返回了一个具有以下类型的对象：
-
-```js
-type GetImageResult = {
-  /* 渲染图像所需的附加 HTML 属性（宽度、高度、样式等） */
-  attributes: Record<string, any>;
-  /* 已通过校验的参数 */
-  options: ImageTransform;
-  /* 传递的原始参数 */
-  rawOptions: ImageTransform;
-  /* 生成图像的路径 */
-  src: string;
-  srcSet: {
-    /* 为 srcset 生成值，每个条目都有一个 url 和一个 size */
-    values: SrcSetValue[];
-    /* 准备在`srcset`属性中使用的值 */
-    attribute: string;
-  };
-}
-```
-
-## 内容集合（`astro:content`）
-
-<p><Since v="2.0.0" /></p>
-
-内容集合提供了 API 来配置和查询 `src/content/` 中的 Markdown 或 MDX 文档。有关功能和用法示例，请参考[内容集合指南](/zh-cn/guides/content-collections/)。
-
-### `defineCollection()`
-
-<p>
-
-**类型：**`(input: CollectionConfig) => CollectionConfig`
-</p>
-
-`defineCollection()` 是一个用于在 `src/content/config.*` 文件中配置集合的工具函数。
-
-```ts
-// src/content/config.ts
-import { z, defineCollection } from 'astro:content';
-const blog = defineCollection({
-  type: 'content',
-  schema: z.object({
-    title: z.string(),
-    permalink: z.string().optional(),
-  }),
-});
-
-// 将定义的集合公开给 Astro
-// 通过 `collections` 导出
-export const collections = { blog };
-```
-
-这个函数接受以下属性：
-#### `type`
-
-<p>
-
-**类型：**`'content' | 'data'`<br />
-**默认：**`'content'`<br />
-<Since v="2.5.0" />
-</p>
-
-`type` 是一个字符串，用于定义存储在集合中的条目的类型：
-
-- `'content'` - 用于内容创作格式，如 Markdown (`.md`)、MDX (`.mdx`) 或 Markdoc (`.mdoc`)
-- `'data'` - 用于 JSON (`.json`) 或 YAML (`.yaml`) 等纯数据格式
-
-:::tip
-这意味着集合**不能**存储内容和数据格式的混合。你必须按类型将这些条目分割成单独的集合。
-:::
-
-#### `schema`
-
-**类型：**<code>ZodType | (context: <a href="#schemacontext">SchemaContext</a>) => ZodType</code>
-
-`schema` 是一个可选的 Zod 对象，用于配置集合的文档 frontmatter 的类型和形状。每个值必须使用 [Zod 验证器](https://github.com/colinhacks/zod)
-
-有关示例请[参考 `内容集合`指南](/zh-cn/guides/content-collections/#定义集合模式) 
-
-### `reference()`
-
-<p>
-
-**类型：**`(collection: string) => ZodEffects<ZodString, { collection, id: string } | { collection, slug: string }>`<br />
-<Since v="2.5.0" />
-</p>
-
-在内容配置中使用 `reference()` 函数来定义从一个集合到另一个集合的关系或 "引用"。该函数接受一个集合名称，并验证内容前置事项或数据文件中指定的条目标识符。
-
-此示例定义了从博客作者到 "作者 "集合的引用，以及到同一 "博客 "集合的相关文章数组的引用：
-
-```ts
-import { defineCollection, reference, z } from 'astro:content';
-
-const blog = defineCollection({
-  type: 'content',
-  schema: z.object({
-    // 通过 "id "从 "作者 "集合中引用单个作者
-    author: reference('authors'),
-    // 按 "slug "从 "blog "集合中引用相关帖子数组
-    relatedPosts: z.array(reference('blog')),
-  })
-});
-
-const authors = defineCollection({
-  type: 'data',
-  schema: z.object({ /* ... */ })
-});
-
-export const collections = { blog, authors };
-```
-
-有关示例请[参考 `内容集合`指南](/zh-cn/guides/content-collections/#定义集合引用).
-
-### `getCollection()`
-
-<p>
-
-**类型：** `(collection: string, filter?: (entry: CollectionEntry<TCollectionName>) => boolean) => CollectionEntry<TCollectionName>[]`
-</p>
-
-`getCollection()` 是一个函数，用于通过集合名称检索内容集合条目列表。
-
-默认情况下，它返回集合中的所有项目，并接受可选的 `filter` 函数来缩小条目属性。这允许你根据 `id`、`slug` 或 frontmatter 值（通过 `data` 对象）查询集合中的某些项目。
-
-```astro
----
-import { getCollection } from 'astro:content';
-
-// 获取 `src/content/blog/` 中的所有条目
-const allBlogPosts = await getCollection('blog');
-
-// 仅返回 frontmatter 中 `draft: true` 的条目
-const draftBlogPosts = await getCollection('blog', ({ data }) => {
-  return data.draft === true;
-});
----
-```
-
-有关示例请[参考 `内容集合`指南](/zh-cn/guides/content-collections/#查询集合) 以获取示例用法。
-
-### `getEntry()`
-
-<p><Since v="2.5.0" /></p>
-
-**类型：**
-
-- `(collection: string, contentSlugOrDataId: string) => CollectionEntry<TCollectionName>`
-- `({ collection: string, id: string }) => CollectionEntry<TCollectionName>`
-- `({ collection: string, slug: string }) => CollectionEntry<TCollectionName>`
-
-`getEntry()` 是一个函数，可通过集合名称和条目 `id` （对于 `type: 'data'` 集合）或条目 `slug` （对于 `type: 'content'` 集合）检索单个集合条目。`getEntry()`也可用于获取引用条目，以访问`data`、`body`或`render()`属性：
-
-```astro
----
-import { getEntry } from 'astro:content';
-
-// 得到 `src/content/blog/enterprise.md`
-const enterprisePost = await getEntry('blog', 'enterprise');
-
-// 得到 `src/content/captains/picard.yaml`
-const picardProfile = await getEntry('captains', 'picard');
-
-// 得到 the profile referenced by `data.captain`
-const enterpriseCaptainProfile = await getEntry(enterprisePost.data.captain);
----
-```
-
-有关`内容集合`的示例，请参考 [查询集合条目](/zh-cn/guides/content-collections/#查询集合).
-
-### `getEntries()`
-
-<p><Since v="2.5.0" /></p>
-
-**类型：**
-
-- `(Array<{ collection: string, id: string }>) => CollectionEntry<TCollectionName>[]`
-- `(Array<{ collection: string, slug: string }>) => CollectionEntry<TCollectionName>[]`
-
-`getEntries()` 是一个从同一集合中检索多个集合条目的函数。这对于[返回引用条目的数组](/zh-cn/guides/content-collections/#定义集合引用)访问其关联的`data`、`body`和`render()`属性非常有用。
-
-```astro
----
-import { getEntries } from 'astro:content';
-
-const enterprisePost = await getEntry('blog', 'enterprise');
-
-// 获取由 `data.relatedPosts` 引用的相关帖子
-const enterpriseRelatedPosts = await getEntries(enterprisePost.data.relatedPosts);
----
-```
-
-### `getEntryBySlug()`
-
-<p>
-
-**类型：** `(collection: string, slug: string) => Promise<CollectionEntry<TCollectionName>>`
-</p>
-
-:::caution[已废弃]
-使用 [`getEntry()`函数](#getentry) 查询内容条目。该函数接受与 `getEntryBySlug()` 相同的参数，并支持通过 `id` 查询 JSON 或 YAML 集合。
-:::
-
-`getEntryBySlug()` 是一个函数，用于通过集合名称和条目 `slug` 检索单个集合条目。
-
-```astro
----
-import { getEntryBySlug } from 'astro:content';
-
-const enterprise = await getEntryBySlug('blog', 'enterprise');
----
-```
-有关示例请[参考 `内容集合`指南](/zh-cn/guides/content-collections/#查询集合) 以获取示例用法。
-
-### `getDataEntryById()`
-
-<p>
-
-**类型：** `(collection: string, id: string) => Promise<CollectionEntry<TCollectionName>>`<br />
-<Since v="2.5.0" />
-</p>
-
-:::caution[已废弃]
-使用 [`getEntry()`函数](#getentry) 查询数据条目。该函数接受与 `getDataEntryById()` 相同的参数，并支持通过 `slug` 查询 Markdown 等内容创作格式的条目。
-:::
-
-`getDataEntryById()` 是一个用于通过集合名称和条目 `id` 检索单个集合条目的函数。
-
-```astro
----
-import { getDataEntryById } from 'astro:content';
-const picardProfile = await getDataEntryById('captains', 'picard');
----
-```
-
-### 集合条目类型
-
-[`getCollection()`](#getcollection)和 [`getEntryBySlug()`](#getentrybyslug) 函数都会返回 `CollectionEntry` 类型的条目。这个类型可以从 `astro:content` 中获取：
-
-```ts
-import type { CollectionEntry } from 'astro:content';
-```
-
-`CollectionEntry<TCollectionName>` 类型是一个对象，具有以下值。 `TCollectionName` 是你正在查询的集合的名称（例如 `CollectionEntry<'blog'>`）。
-
-#### `id`
-
-**适用于：** `type: 'content'` and `type: 'data'` 集合
-
-**示例类型：**
-  - 内容集合: `'entry-1.md' | 'entry-2.md' | ...`
-  - 数据集合: `'author-1' | 'author-2' | ...`
-
-一个使用相对于 `src/content/[collection]` 的文件路径的唯一 ID。根据集合条目文件路径枚举所有可能的字符串值。请注意，[`类型: 'content'`](#type) 的集合在其 ID 中包含文件扩展名，而定义为 `type: 'data'` 的集合则不包含。
-
-#### `collection`
-
-**适用于：** `type: 'content'` and `type: 'data'` 集合 
-
-**示例类型：** `'blog' | 'authors' | ...`
-
-`src/content/` 下顶级文件夹的名称，条目位于该文件夹中。该名称用于在模式和查询函数中引用集合。
-
-
-#### `data`
-**适用于：** `type: 'content'` and `type: 'data'` 集合 
-
-**类型：**`CollectionSchema<TCollectionName>`
-
-一个从集合模式推断出的 frontmatter 属性对象（[参考 `defineCollection()`](#definecollection)）。如果没有配置模式，则默认为 `any`。
-
-#### `slug`
-
-**适用于：** 仅仅 `type: 'content'` 集合
-
-**示例类型：** `'entry-1' | 'entry-2' | ...`
-
-可用于 Markdown 或 MDX 文档的 URL 标头。默认为不含文件扩展名的 "id"，但可以通过在文件的 frontmatter 中设置[`slug`属性](/zh-cn/guides/content-collections/#定义自定义-slugs)来覆盖。
-
-#### `body`
-**适用于：** 仅 `type: 'content'` 集合
-
-**类型：**`string`
-
-一个包含 Markdown 或 MDX 文档原始未编译的 body 的字符串。
-
-#### `render()`
-
-**适用于：** 仅 `type: 'content'` 集合
-
-**类型：**`() => Promise<RenderedEntry>`
-
-一个用于编译给定的 Markdown 或 MDX 文档以进行渲染的函数。它返回以下属性：
-
-- `<Content />` - 用于在 Astro 文件中渲染文档内容的组件。
-- `headings` - 生成的标题列表，[与 Astro 的 `getHeadings()` 工具函数相同](/zh-cn/guides/markdown-content/#可用属性) 在 Markdown 和 MDX 导入中。
-- `remarkPluginFrontmatter ` - 在应用 [remark 或 rehype 插件](/zh-cn/guides/markdown-content/#以编程方式修改-frontmatter)后修改后的 frontmatter 对象。设置为类型 `any`。
-
-```astro
----
-import { getEntryBySlug } from 'astro:content';
-const entry = await getEntryBySlug('blog', 'entry-1');
-
-const { Content, headings, remarkPluginFrontmatter } = await entry.render();
----
-```
-
-有关示例请[参考 `内容集合`指南](/zh-cn/guides/content-collections/#将内容渲染成-html) 以获取示例用法。
-
-### 其他内容集合类型
-
-`astro:content` 模块也导出了以下类型，供你在 Astro 项目中使用：
-
-#### `CollectionKey`
-
-<p><Since v="3.1.0" /></p>
-
-这是一个在 `src/content/config.*` 文件中定义的所有集合名称的字符串联合类型。当定义一个可以接受任何集合名称的通用函数时，这个类型很有用。
-
-```ts
-import type { CollectionKey, getCollection } from 'astro:content';
-
-async function getCollection(collection: CollectionKey) {
-  return getCollection(collection);
-}
-```
-
-#### `ContentCollectionKey`
-
-<p><Since v="3.1.0" /></p>
-
-一个在 `src/content/config.*` 文件中定义的所有 `type: 'content'` 集合名称的字符串联合类型。
-
-#### `DataCollectionKey`
-
-<p><Since v="3.1.0" /></p>
-
-一个在 `src/content/config.*` 文件中定义的所有 `type: 'data'` 集合名称的字符串联合类型。
-
-#### `SchemaContext`
-
-即 `defineCollection` 在 `schema` 函数形状中所使用的 `context` 对象。当为多个集合构建可重用的模式时，这个类型很有用。
-
-它包括了以下属性：
-
-- `image()` 模式辅助工具允许你 [在内容集合中使用本地图片](/zh-cn/guides/images/#内容集合中的图像)。
-
-```ts
-import type { SchemaContext } from 'astro:content';
-
-export const imageSchema = ({ image }: SchemaContext) =>
-    z.object({
-        image: image(),
-        description: z.string().optional(),
-    });
-
-const blog = defineCollection({
-  type: 'content',
-  schema: ({ image }) => z.object({
-    title: z.string(),
-    permalink: z.string().optional(),
-    image: imageSchema({ image })
-  }),
-});
-```
-
-## 中间件（`astro:middleware`）
-
-<p><Since v="2.6.0" /></p>
-
-中间件使你能拦截请求和响应，并在每次渲染页面或端点时动态注入行为。有关功能和用法示例，请参考[中间件指南](/zh-cn/guides/middleware/)。
-
-### `onRequest()`
-
-<p>
-
-**类型：**`(context: APIContext, next: MiddlewareNext) => Promise<Response> | Response | Promise<void> | void`
-</p>
-
-一个在 `src/middleware.js` 里的必须导出的函数，它将在每次渲染页面或端点时被调用。它接受两个参数：[context](#context) 和 [next()](#next)。`onRequest()` 必须返回一个 `Response`：要么直接返回，要么通过调用 `next()` 返回。
-
-    ```js title="src/middleware.js"
-    export function onRequest (context, next) {
-        // 拦截一个请求的响应数据
-        // 可选修改响应
-        // 直接返回一个 Response 对象，或者调用 `next()` 的结果
-        return next();
-    };
-    ```
-
-#### `context`
-
-<p>
-
-**类型：**`APIContext`
-</p>
-
-`onRequest()` 的第一个参数是一个上下文对象。它反映了许多 `Astro` 全局属性。
-
-<ReadMore>有关更多信息，请参阅 [端点上下文](#端点上下文)。</ReadMore>
-
-#### `next()`
-
-<p>
-
-**类型：**`(rewritePayload?: string | URL | Request) => Promise<Response>`<br />
-</p>
-
-`onRequest()` 的第二个参数是一个调用链中的所有后续中间件，并返回一个 `Response` 的函数。例如，其他中间件可以修改响应的 HTML 主体，等待 `next()` 的结果将允许你的中间件响应这些更改。
-
-自从 Astro v4.13.0，`next()` 接受一个可选的 URL 路径参数，形式为字符串、`URL` 或 `Request`，用于[重写](/zh-cn/guides/routing/#重写)当前请求而不重新触发新的渲染阶段。
-
-### `sequence()`
-
-<p>
-
-**类型：**`(...handlers: MiddlewareHandler[]) => MiddlewareHandler`
-</p>
-
-一个接受中间件函数作为参数的函数，它将按照它们传递的顺序执行它们。
-
-```js title="src/middleware.js"
-import { sequence } from "astro:middleware";
-
-async function validation(_, next) {...}
-async function auth(_, next) {...}
-async function greeting(_, next) {...}
-
-export const onRequest = sequence(validation, auth, greeting);
-```
-
-### `createContext()`
-
-<p>
-
-**类型：**`(context: CreateContext) => APIContext`<br />
-<Since v="2.8.0" />
-</p>
-
-一个底层 API，用于创建一个 [`APIContext`](#端点上下文) 以传递给 Astro 中间件的 `onRequest()` 函数。
-
-此函数可以由集成/适配器用于执行 Astro 中间件。
-
-### `trySerializeLocals()`
-
-<p>
-
-**类型：**`(value: unknown) => string`<br />
-<Since v="2.8.0" />
-</p>
-
-一个底层 API，它接受任何值并尝试返回它的序列化版本（一个字符串）。如果该值无法序列化，该函数将抛出一个运行时错误。
-
-## 国际化（`astro:i18n`）
-
-<p><Since v="3.5.0" /></p>
-
-此模块提供了一些函数，帮助你使用项目配置的语言环境设置创建 URL。
-
-使用 i18n 路由为你的项目创建路由将依赖于你设置的某些配置值，这些值会影响你的页面路由。使用这些函数创建路由时，请确保考虑到你的个人设置，包括：
-
-- [`base`](/zh-cn/reference/configuration-reference/#base)
-- [`trailingSlash`](/zh-cn/reference/configuration-reference/#trailingslash)
-- [`build.format`](/zh-cn/reference/configuration-reference/#buildformat)
-- [`site`](/zh-cn/reference/configuration-reference/#site)
-
-另外，请注意，这些函数为你的 `defaultLocale` 创建的返回 URL 将反映你的 `i18n.routing` 配置。
-
-有关功能和使用示例，请参阅[我们的 i18n 路由指南](/zh-cn/guides/internationalization/)。
-
-### `getRelativeLocaleUrl()` 
-
-<p>
-
-**类型：**`(locale: string, path?: string,  options?: GetLocaleOptions) => string`
-</p>
-
-`getRelativeLocaleUrl(locale: string, path?: string,  options?: GetLocaleOptions): string`
-
-使用此函数来检索一个语言环境的相对路径。如果该语言环境不存在，Astro 会抛出一个错误。
-
-```astro
----
-getRelativeLocaleUrl("fr");
-// 返回 /fr
-getRelativeLocaleUrl("fr", "");
-// 返回 /fr
-getRelativeLocaleUrl("fr", "getting-started");
-// 返回 /fr/getting-started
-getRelativeLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog"
-}); 
-// 返回 /blog/fr-ca/getting-started
-getRelativeLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog",
-  normalizeLocale: false
-}); 
-// 返回 /blog/fr_CA/getting-started
----
-```
-
-### `getAbsoluteLocaleUrl()`
-
-<p>
-
-**类型：**`(locale: string, path: string, options?: GetLocaleOptions) => string`
-</p>
-
-当 [`site`] 配置了值时，使用这个函数来检索一个语言环境的绝对路径。如果 [`site`] 没有被配置，该函数将返回一个相对 URL。如果语言环境不存在，Astro 会抛出一个错误。
-
-
-```astro title="src/pages/index.astro"
----
-// 如果 `site` 被设置为 `https://example.com`
-getAbsoluteLocaleUrl("fr"); 
-// 返回 https://example.com/fr
-getAbsoluteLocaleUrl("fr", ""); 
-// 返回 https://example.com/fr
-getAbsoluteLocaleUrl("fr", "getting-started"); 
-// 返回 https://example.com/fr/getting-started
-getAbsoluteLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog"
-}); 
-// 返回 https://example.com/blog/fr-ca/getting-started
-getAbsoluteLocaleUrl("fr_CA", "getting-started", {
-  prependWith: "blog",
-  normalizeLocale: false
-}); 
-// 返回 https://example.com/blog/fr_CA/getting-started
----
-```
-
-### `getRelativeLocaleUrlList()`
-
-<p>
-
-**类型：**`(path?: string, options?: GetLocaleOptions) => string[]`
-</p>
-
-像使用 [`getRelativeLocaleUrl`](#getrelativelocaleurl) 那样使用此函数，返回所有语言环境的相对路径列表。
-
-### `getAbsoluteLocaleUrlList()` 
-
-<p>
-
-**类型：**`(path?: string, options?: GetLocaleOptions) => string[]`
-</p>
-
-像使用 [`getAbsoluteLocaleUrl`](/zh-cn/guides/internationalization/#自定义语言环境路径) 那样使用此函数，返回所有语言环境的绝对路径列表。
-
-### `getPathByLocale()` 
-
-<p>
-
-**类型：**`(locale: string) => string`
-</p>
-
-当配置了[自定义语言环境路径](/zh-cn/guides/internationalization/#自定义语言环境路径)时，此函数返回与一个或多个 `codes` 关联的 `path`。
-
-```js title="astro.config.mjs"
-export default defineConfig({
-  i18n: {
-    locales: ["es", "en", {
-      path: "french",
-      codes: ["fr", "fr-BR", "fr-CA"]
-    }]
-  }
-})
-```
-
-```astro title="src/pages/index.astro"
----
-getPathByLocale("fr"); // 返回 "french"
-getPathByLocale("fr-CA"); // 返回 "french"
----
-```
-
-### `getLocaleByPath()`
-
-<p>
-
-**类型：**`(path: string) => string`
-</p>
-
-此函数返回与语言环境 `path` 关联的 `code`。
-
-```js title="astro.config.mjs"
-export default defineConfig({
-  i18n: {
-    locales: ["es", "en", {
-      path: "french",
-      codes: ["fr", "fr-BR", "fr-CA"]
-    }]
-  }
-})
-```
-
-```astro title="src/pages/index.astro"
----
-getLocaleByPath("french"); // 返回 "fr"，因为这是首个配置的代码
----
-```
-
-### `redirectToDefaultLocale()`
-
-<p>
-
-**类型：**`(context: APIContext, statusCode?: ValidRedirectStatus) => Promise<Response>`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-仅当 `i18n.routing` 设置为 `"manual"` 时可用。
-:::
-
-此函数返回一个 `Response`，将重定向到配置的 `defaultLocale`。它接受一个可选的有效重定向状态码。
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { redirectToDefaultLocale } from "astro:i18n";
-
-export const onRequest = defineMiddleware((context, next) => {
-  if (context.url.pathname.startsWith("/about")) {
-    return next();
-  } else {
-    return redirectToDefaultLocale(context, 302);
-  }
-})
-```
-
-### `redirectToFallback()`
-
-<p>
-
-**类型：**`(context: APIContext, response: Response) => Promise<Response>`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-仅当 `i18n.routing` 设置为 `"manual"` 时可用。
-:::
-
-此函数允许你在自己的中间件中使用你的 [`i18n.fallback` 配置](/zh-cn/reference/configuration-reference/#i18nfallback)。
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { redirectToFallback } from "astro:i18n";
-
-export const onRequest = defineMiddleware(async (context, next) => {
-  const response = await next();
-  if (response.status >= 300) {
-    return redirectToFallback(context, response)
-  }
-  return response;
-})
-```
-
-### `notFound()`
-
-<p>
-
-**类型：**`(context: APIContext, response?: Response) => Promise<Response> | undefined`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-仅当 `i18n.routing` 设置为 `"manual"` 时可用。
-:::
-
-当以下情况发生时，在你的路由中间件中使用此函数来返回一个 404 错误：
-- 当前路径不是根路径。例如：`/` 或 `/<base>`
-- URL 中不包含语言环境代码
-
-当传递了一个 `Response`，由此函数发出的新 `Response` 将包含原始响应的相同头信息。
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { notFound } from "astro:i18n";
-
-export const onRequest = defineMiddleware((context, next) => {
-  const pathNotFound = notFound(context);
-  if (pathNotFound) {
-    return pathNotFound;
-  }
-  return next();
-})
-```
-
-### `middleware()`
-
-<p>
-
-**类型：**`(options: { prefixDefaultLocale: boolean, redirectToDefaultLocale: boolean }) => MiddlewareHandler`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-仅当 `i18n.routing` 设置为 `"manual"` 时可用。
-:::
-
-此函数允许你以编程方式创建 Astro i18n 中间件。
-
-当你仍然想要使用默认的 i18n 逻辑，但只在你的网站添加少数例外时，这个功能非常有用。
-
-```js title="middleware.js"
-import { middleware } from "astro:i18n";
-import { sequence, defineMiddleware } from "astro:middleware";
-
-const customLogic = defineMiddleware(async (context, next) => {
-  const response = await next();
-  // 在这里解析响应后的自定义逻辑。
-  // 可以捕获来自 Astro i18n 中间件的响应。
-
-  return response;
-});
-
-export const onRequest = sequence(customLogic, middleware({
-	prefixDefaultLocale: true,
-	redirectToDefaultLocale: false
-}))
-```
-
-### `requestHasLocale()`
-
-<p>
-
-**类型：**`(context: APIContext) => boolean`<br />
-<Since v="4.6.0" />
-</p>
-
-:::note
-仅当 `i18n.routing` 设置为 `"manual"` 时可用。
-:::
-
-检查当前 URL 是否包含已配置的语言环境代码。在内部，此函数将使用 `APIContext#url.pathname`。
-
-```js title="middleware.js"
-import { defineMiddleware } from "astro:middleware";
-import { requestHasLocale } from "astro:i18n";
-
-export const onRequest = defineMiddleware(async (context, next) => {
-  if (requestHasLocale(context)) {
-    return next();
-  }
-  return new Response("Not found", { status: 404 });
-})
-```
-
-## 视图过渡客户端 API (`astro:transitions/client`)
-
-<p><Since v="3.2.0" /></p>
-
-此模块提供了一些函数，用于控制和与视图过渡 API 和客户端路由进行交互。
-
-对于功能和使用示例，[请参阅我们的视图过渡指南](/zh-cn/guides/view-transitions/)。
-
-### `navigate()`
-
-<p>
-
-**类型：**`(href: string, options?: Options) => void`<br />
-<Since v="3.2.0" />
-</p>
-
-一个使用视图过渡 API 导航到给定 `href` 的函数。
-
-此函数签名基于 [浏览器 Navigation API 中的 `navigate` 函数](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate)。虽然基于 Navigation API，但此函数是在 [History API](https://developer.mozilla.org/zh-CN/docs/Web/API/History_API) 之上实现的，以允许在不重新加载页面的情况下进行导航。
-
-#### `history` 选项
-
-<p>
-
-**类型：**`'auto' | 'push' | 'replace'`<br />
-**默认值：**`'auto'`<br />
-<Since v="3.2.0" />
-</p>
-
-定义了如何将此导航添加到浏览器历史记录中。
-
-- `'push'`：路由将使用 `history.pushState` 在浏览器历史记录中创建一个新条目。
-- `'replace'`：路由将使用 `history.replaceState` 更新 URL，而不会在导航中添加新条目。
-- `'auto'`（默认）：路由将尝试 `history.pushState`，但如果无法进行过渡，则当前 URL 将保持不变，浏览器历史记录不会发生变化。
-
-此选项遵循浏览器 Navigation API 中的 [`history` 选项](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#history)，但简化了在 Astro 项目中可能发生的情况。
-
-#### `formData` 选项
-
-<p>
-
-**类型：**`FormData`<br />
-<Since v="3.5.0" />
-</p>
-
-一个 `FormData` 对象，用于 `POST` 请求。
-
-当提供此选项时，导航目标页面的请求将以 `POST` 请求的形式发送，内容为表单数据对象。
-
-当提交一个带有视图过渡的 HTML 表单时，将使用此方法代替默认的页面重新加载导航。调用此方法允许以编程方式触发相同的行为。
-
-#### `info` 选项
-
-<p>
-
-**类型：**`any`<br />
-<Since v="3.6.0" />
-</p>
-
-与导航相关的 `astro:before-preparation` 和 `astro:before-swap` 事件中包含的任意数据。
-
-此选项模仿了浏览器 Navigation API 中的 [`info` 选项](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#info)。
-
-#### `state` 选项
-
-<p>
-
-**类型：**`any`<br />
-<Since v="3.6.0" />
-</p>
-
-与导航相关的 `NavitationHistoryEntry` 对象中关联的任意数据。此数据可以通过 [`history.getState` 函数](https://developer.mozilla.org/en-US/docs/Web/API/NavigationHistoryEntry/getState) 从 History API 中检索。
-
-此选项模仿了浏览器 Navigation API 中的 [`state` 选项](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#state)。
-
-#### `sourceElement` 选项
-
-<p>
-
-**类型：**`Element`<br />
-<Since v="3.6.0" />
-</p>
-
-此导航的触发元素，如果有的话。此元素将在以下事件中可用：
-- `astro:before-preparation`
-- `astro:before-swap`
-
-### `supportsViewTransitions`
-
-<p>
-
-**类型：**`boolean`<br />
-<Since v="3.2.0" />
-</p>
-
-当前浏览器是否支持并启用视图过渡。
-
-### `transitionEnabledOnThisPage`
-
-<p>
-
-**类型：**`boolean`<br />
-<Since v="3.2.0" />
-</p>
-
-当前页面是否启用了视图过渡以进行客户端导航。这可以用于使组件在视图过渡页面上的行为有所不同。
-
-### `getFallback`
-
-<p>
-
-**类型：**`() => 'none' | 'animate' | 'swap'`<br />
-<Since v="3.6.0" />
-</p>
-
-返回在浏览器不支持视图过渡时使用的回退策略。
-
-有关如何选择和配置回退行为的详细信息，请参阅 [回退控制](/zh-cn/guides/view-transitions/#回退控制) 指南。
-
-
-### `astro:before-preparation` 事件
-
-在视图过渡中导航开始时触发的事件。此事件发生在任何请求之前，并且不会更改任何浏览器状态。
-
-此事件具有以下属性：
-- [`info`](#info)
-- [`sourceElement`](#sourceelement)
-- [`navigationType`](#navigationtype)
-- [`direction`](#direction)
-- [`from`](#from)
-- [`to`](#to)
-- [`formData`](#formdata)
-- [`loader`](#loader)
-
-有关如何使用此事件的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#astrobefore-preparation).
-
-### `astro:after-preparation` 事件
-
-使用视图过渡加载导航中的下一个页面后触发的事件。
-
-此事件没有属性。
-
-有关如何使用此事件的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#astroafter-preparation).
-
-### `astro:before-swap` 事件
-
-在视图过渡中导航的下一个页面解析、准备并链接到 document 后，但在任何内容在 document 之间交换之前触发的事件。
-
-此事件不能取消。调用 `preventDefault()` 是无效的。
-
-此事件具有以下属性：
-- [`info`](#info)
-- [`sourceElement`](#sourceelement)
-- [`navigationType`](#navigationtype)
-- [`direction`](#direction)
-- [`from`](#from)
-- [`to`](#to)
-- [`viewTransition`](#viewtransition)
-- [`swap`](#swap)
-
-有关如何使用此事件的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#astrobefore-swap).
-
-### `astro:after-swap` 事件
-
-在视图过渡中导航的下一个页面内容交换后，但在视图过渡结束之前触发的事件。
-
-在触发此事件时，历史记录条目和滚动位置已经更新。
-
-### `astro:page-load` 事件
-
-在页面完成加载后触发的事件，无论是通过视图过渡导航还是浏览器原生导航。
-
-当视图过渡在页面上启用时，通常在 `DOMContentLoaded` 上执行的代码应更改为在此事件上执行。
-
-### 视图过渡事件属性
-
-<p><Since v="3.6.0" /></p>
-
-#### `info`
-
-<p>
-
-**类型：**`URL`
-</p>
-
-在导航期间定义的任意数据。
-
-这是在 [`navigate()` 函数](#navigate) 的 [`info` 选项](#info-选项) 中传递的文字值。
-
-#### `sourceElement`
-
-<p>
-
-**类型：**`Element | undefined`
-</p>
-
-触发导航的元素。例如，这可以是点击的 `<a>` 元素。
-
-当使用 [`navigate()` 函数](#navigate) 时，这将是调用中指定的元素。
-
-#### `newDocument`
-
-<p>
-
-**类型：**`Document`
-</p>
-
-导航中下一个页面的 document。此 document 的内容将替换当前 document 的内容。
-
-#### `navigationType`
-
-<p>
-
-**类型：**`'push' | 'replace' | 'traverse'`
-</p>
-
-正在发生的导航类型。
-- `push`: 正在为新页面创建一个新的 `NavigationHistoryEntry`。
-- `replace`: 当前的 `NavigationHistoryEntry` 正在被新页面的条目替换。
-- `traverse`: 没有创建 `NavigationHistoryEntry`。历史记录中的位置正在改变。
-  遍历的方向由 [`direction` 属性](#direction) 给出
-
-#### `direction`
-
-<p>
-
-**类型：**`Direction`
-</p>
-
-过渡的方向。
-- `forward`: 在历史记录中导航到下一个页面或新页面。
-- `back`: 在历史记录中导航到前一个页面。
-- 其他监听器可能设置的任何其他内容。
-
-#### `from`
-
-<p>
-
-**类型：**`URL`
-</p>
-
-正在导航的页面的 URL。
-
-#### `to`
-
-<p>
-
-**类型：**`URL`
-</p>
-
-正在导航的页面的 URL。此属性可以修改，在生命周期结束时使用的值将是下一个页面的 `NavigationHistoryEntry` 的值。
-
-#### `formData`
-
-<p>
-
-**类型：**`FormData | undefined`
-</p>
-
-一个用于 `POST` 请求的 `FormData` 对象。
-
-当此属性设置时，将使用给定的表单数据对象作为内容发送 `POST` 请求到 [`to` URL](#to)，而不是正常的 `GET` 请求。
-
-当提交一个带有视图过渡的 HTML 表单时，此字段会自动设置为表单中的数据。当使用 [`navigate()` 函数](#navigate) 时，此值与给定的选项相同。
-
-#### `loader`
-
-<p>
-
-**类型：**`() => Promise<void>`
-</p>
-
-在导航过程中下个阶段的实现（加载下一个页面）。此实现可以覆盖以添加额外的行为。
-
-#### `viewTransition`
-
-<p>
-
-**类型：**[`ViewTransition`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransition)
-</p>
-
-在导航过程中使用的视图过渡对象。在浏览器不支持 [视图过渡 API](https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API) 的情况下，这是一个对象，实现了相同的 API 以方便使用，但没有 DOM 集成。
-
-#### `swap`
-
-<p>
-
-**类型：**`() => void`
-</p>
-
-document 交换逻辑的实现。
-
-有关如何构建自定义交换函数的详细信息，请参阅 [视图过渡指南](/zh-cn/guides/view-transitions/#构建自定义交换函数).
-
-默认情况下，此实现将按顺序调用以下函数：
-
-##### `deselectScripts()`
-
-<p>
-
-**类型：**`(newDocument: Document) => void`
-</p>
-
-标记在新的 document 中不应执行的脚本。这些脚本已经在当前 document 中，并且没有使用 [`data-astro-rerun`](/zh-cn/guides/view-transitions/#data-astro-rerun) 标记为重新执行。
-
-##### `swapRootAttributes()`
-
-<p>
-
-**类型：**`(newDocument: Document) => void`
-</p>
-
-在 document 根节点之间交换属性，如 `lang` 属性。这也包括 Astro 注入的内部属性，如 `data-astro-transition`，这使得过渡方向可用于 Astro 生成的 CSS 规则。
-
-在构建自定义交换函数时，重要的是调用此函数，以避免破坏视图过渡的动画。
-
-##### `swapHeadElements()`
-
-<p>
-
-**类型：**`(newDocument: Document) => void`
-</p>
-
-从当前 document 的 `<head>` 中删除所有未持久化到新 document 的元素。然后将新 document 的 `<head>` 中的所有新元素附加到当前 document 的 `<head>`。
-
-##### `saveFocus()`
-
-<p>
-
-**类型：**`() => () => void`
-</p>
-
-在当前页面上存储聚焦的元素，并返回一个函数，当调用时，如果聚焦的元素被持久化，则将焦点返回给该元素。
-
-
-##### `swapBodyElements()`
-
-<p>
-
-**类型：**`(newBody: Element, oldBody: Element) => void`
-</p>
-
-用新 document 的 body 替换旧的 body。然后，遍历旧 body 中应持久化的每个元素，并在新 body 中找到匹配的元素，将旧元素交换回原位。
-
-## Actions (`astro:actions`)
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-Action 帮助你构建一个类型安全的后端，你可以从客户端代码和 HTML 表单中调用它。所有用于定义和调用 Action 的工具函数都由 `astro:actions` 模块暴露。有关示例和使用说明，请参阅 [Actions 指南](/zh-cn/guides/actions/)。
-
-### `defineAction()`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-`defineAction()` 函数接受一个 [`handler()`](#handler-属性) 函数，其中包含在调用 Action 时要运行的服务器逻辑，以及一个可选的 [`input`](#input-验证器) 属性，用于在运行时验证输入参数。
-
-```ts
-export const server = {
-    getGreeting: defineAction({
-    input: z.object({
-      name: z.string(),
-    }),
-    handler: async (input, context) => {
-      return `Hello, ${input.name}!`
-    }
-  })
-}
-```
-
-#### `handler()` 属性
-
-<p>
-
-**类型：**`(input, context) => any`
-</p>
-
-`defineAction()` 函数接受一个 `handler()` 函数，其中包含在调用 Action 时要运行的服务器逻辑。此函数可以返回数据，这些数据将自动序列化并发送给调用者。
-
-`handler()` 函数被调用时，接受用户输入作为其第一个参数。如果设置了 [`input`](#input-验证器) 验证器，那么用户输入将在传递给 `handler()` 前进行验证。第二个参数是一个 `context` 对象，包含大多数 Astro 的 [标准端点上下文](#端点上下文)，不包括 `getActionResult()`, `callAction()`, 和 `redirect()`。
-
-返回值使用 [devalue 库](https://github.com/Rich-Harris/devalue) 进行解析。它支持 JSON 值，以及 `Date()`, `Map()`, `Set()`, 或 `URL()` 的实例。
-
-#### `input` 验证器
-
-<p>
-
-**类型：**`ZodType | undefined`
-</p>
-
-可选的 `input` 属性接受一个 Zod 验证器，用于在运行时验证处理程序的输入。如果 action 验证失败，将返回 [`BAD_REQUEST` 错误](#actionerror) 并跳过 `handler`。
-
-如果省略 `input`，则 `handler` 将接收 JSON 请求的 `unknown` 类型的输入，以及表单请求的 `FormData` 类型。
-
-##### 与 `accept: 'form'` 一起使用
-
-如果你的 action 接受表单输入，请使用 `z.object()` 验证器将表单数据自动解析为类型化对象。表单数据字段支持以下验证器：
-
-- 使用 `z.number()` 验证类型为 `number` 的输入
-- 使用 `z.boolean()` 验证类型为 `checkbox` 的输入
-- 使用 `z.instanceof(File)` 验证类型为 `file` 的输入
-- 使用 `z.array(/* validator */)` 验证相同 `name` 的多个输入
-- 使用 `z.string()` 验证所有其他输入
-
-`z.object()` 验证器还支持包括 `.refine()`, `.transform()`, 和 `.pipe()` 在内的扩展函数。
-
-要搭配应用不同验证器的组合，请使用 `z.discriminatedUnion()` 包装器，它根据表单的特定字段以缩小类型范围。此示例通过接受表单提交以判断是 “创建(create)” 或是 “更新(update)” 了一名用户信息，判断时使用表单域的 `type` 属性字段来确定要验证的对象：
-
-```ts
-import { defineAction } from 'astro:actions';
-import { z } from 'astro:schema';
-
-export const server = {
-  changeUser: defineAction({
-    accept: 'form',
-    input: z.discriminatedUnion('type', [
-      z.object({
-        // 当 `type` 字段中的值含有 `create` 时匹配
-        type: z.literal('create'),
-        name: z.string(),
-        email: z.string().email(),
-      }),
-      z.object({
-        // 当 `type` 字段中的值含有 `update` 时匹配
-        type: z.literal('update'),
-        id: z.number(),
-        name: z.string(),
-        email: z.string().email(),
-      }),
-    ]),
-    async handler(input) {
-      if (input.type === 'create') {
-        // input 为 { type: 'create', name: string, email: string }
-      } else {
-        // input 为 { type: 'update', id: number, name: string, email: string }
-      }
-    },
-  }),
-};
-```
-
-### `isInputError()`
-
-<p>
-
-**类型：**<code>(error?: unknown | <a href="#actionerror">ActionError</a>) => boolean</code><br/>
-<Since v="4.15.0" />
-</p>
-
-`isInputError()` 函数常用于检查 `ActionError` 是否是输入验证错误。当 `input` 验证器是 `z.object()` 时，输入错误包括一个 `fields` 对象，其中错误消息按名称分组。
-
-<ReadMore> 
-更多关于使用 `isInputError()` 的信息，请参见 [表单输入错误指南](/zh-cn/guides/actions/#展示表单输入错误)。
-</ReadMore>
-
-### `ActionError`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-`ActionError` 构造函数常用于在 `handler()` 函数中抛出错误。它接受一个 `code` 属性，描述发生的错误（例如：`"UNAUTHORIZED"`），以及一个可选的 `message` 属性，提供进一步的细节。
-
-#### `code`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-`code` 属性接受所有 HTTP 状态码的人类可读版本。以下是支持的 code：
-
-- `BAD_REQUEST` (400): 客户端发送了无效的输入。当 action `input` 验证器验证失败时会抛出此错误。
-- `UNAUTHORIZED` (401): 客户端缺乏有效的身份验证凭据。
-- `FORBIDDEN` (403): 客户端无权访问资源。
-- `NOT_FOUND` (404): 服务器找不到请求的资源。
-- `METHOD_NOT_SUPPORTED` (405): 服务器不支持请求的方法。
-- `TIMEOUT` (408): 服务器在处理请求时超时。
-- `CONFLICT` (409): 服务器无法更新资源，因为存在冲突。
-- `PRECONDITION_FAILED` (412): 服务器不满足请求的前提条件。
-- `PAYLOAD_TOO_LARGE` (413): 服务器无法处理请求，因为负载过大。
-- `UNSUPPORTED_MEDIA_TYPE` (415): 服务器不支持请求的媒体类型。注意：Actions 已经检查了 JSON 和表单请求的 [`Content-Type` 标头](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Content-Type)，所以你可能不需要手动引发此代码。
-- `UNPROCESSABLE_CONTENT` (422): 服务器无法处理请求，因为存在语义错误。
-- `TOO_MANY_REQUESTS` (429): 服务器已超出指定的速率限制。
-- `CLIENT_CLOSED_REQUEST` (499): 客户端在服务器响应之前关闭了请求。
-- `INTERNAL_SERVER_ERROR` (500): 服务器意外失败。
-- `NOT_IMPLEMENTED` (501): 服务器不支持请求的功能。
-- `BAD_GATEWAY` (502): 服务器从上游服务器接收到无效响应。
-- `SERVICE_UNAVAILABLE` (503): 服务器暂时不可用。
-- `GATEWAY_TIMEOUT` (504): 服务器从上游服务器接收到超时。
-
-#### `message`
-
-<p>
-<Since v="4.15.0" />
-</p>
-
-`message` 属性接受一个字符串。（例如："用户必须登录。"）
-
-[canonical]: https://en.wikipedia.org/wiki/Canonical_link_element

From d732d5efbfc26c7886404200619c4c29edd4ce00 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Mon, 28 Oct 2024 11:53:30 +0100
Subject: [PATCH 28/43] i18n(fr): create `reference/modules/astro-actions.mdx`
 (#9823)

See #9687 and #9819

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 .../fr/reference/modules/astro-actions.mdx    | 176 ++++++++++++++++++
 1 file changed, 176 insertions(+)
 create mode 100644 src/content/docs/fr/reference/modules/astro-actions.mdx

diff --git a/src/content/docs/fr/reference/modules/astro-actions.mdx b/src/content/docs/fr/reference/modules/astro-actions.mdx
new file mode 100644
index 0000000000000..1ef57e4583696
--- /dev/null
+++ b/src/content/docs/fr/reference/modules/astro-actions.mdx
@@ -0,0 +1,176 @@
+---
+title: Référence de l'API Actions
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+Les actions vous aident à créer un backend incluant la sûreté du typage que vous pouvez appeler à partir du code client et des formulaires HTML. Tous les utilitaires permettant de définir et d'appeler des actions sont exposés par le module `astro:actions`. Pour des exemples et des instructions d'utilisation, [consultez le guide Actions](/fr/guides/actions/).
+
+## Importations depuis `astro:actions`
+
+```js
+import { 
+  actions,
+  defineAction,
+  isInputError,
+  ActionError,
+ } from 'astro:actions';
+```
+
+### `defineAction()`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+L'utilitaire `defineAction()` est utilisé pour définir de nouvelles actions à partir du fichier `src/actions/index.ts`. Il accepte une fonction [`handler()`](#propriété-handler) contenant la logique du serveur à exécuter et une propriété facultative [`input`](#validateur-de-saisie-input) pour valider les paramètres d'entrée lors de l'exécution.
+
+```ts title="src/actions/index.ts"
+import { defineAction } from 'astro:actions';
+import { z } from 'astro:schema';
+
+export const server = {
+  getGreeting: defineAction({
+    input: z.object({
+      name: z.string(),
+    }),
+    handler: async (input, context) => {
+      return `Bonjour, ${input.name}!`
+    }
+  })
+}
+```
+
+#### Propriété `handler()`
+
+<p>
+
+**Type :** `(input, context) => any`
+</p>
+
+`defineAction()` nécessite une fonction `handler()` contenant la logique du serveur à exécuter lorsque l'action est appelée. Les données renvoyées par le gestionnaire sont automatiquement sérialisées et envoyées à l'appelant.
+
+Le `handler()` est appelé avec la saisie de l'utilisateur comme premier argument. Si un validateur [`input`](#validateur-de-saisie-input) est défini, la saisie de l'utilisateur sera validée avant d'être transmise au gestionnaire. Le deuxième argument est un objet `context` contenant la plupart du [contexte de point de terminaison standard](/fr/reference/api-reference/#contexte-du-point-de-terminaison) d'Astro, à l'exception de `getActionResult()`, `callAction()` et `redirect()`.
+
+Les valeurs de retour sont analysées à l'aide de la [bibliothèque devalue](https://github.com/Rich-Harris/devalue). Celle-ci prend en charge les valeurs JSON, ainsi que les instances de `Date()`, `Map()`, `Set()` ou `URL()`.
+
+#### Validateur de saisie (`input`)
+
+<p>
+
+**Type :** `ZodType | undefined`
+</p>
+
+La propriété facultative `input` accepte un validateur Zod pour vérifier les entrées du gestionnaire lors de l'exécution. Si l'action échoue à la validation, [une erreur `BAD_REQUEST`](#actionerror) est renvoyée et la fonction `handler` n'est pas appelée.
+
+Si `input` est omis, le `handler` recevra une entrée de type `unknown` pour les requêtes JSON et de type `FormData` pour les requêtes de formulaire.
+
+##### Utiliser avec `accept: 'form'`
+
+Si votre action accepte les entrées de formulaire, utilisez le validateur `z.object()` pour analyser automatiquement les données du formulaire en un objet typé. Les validateurs suivants sont pris en charge pour les champs de données de formulaire :
+
+- Les entrées de type `number` peuvent être validées à l'aide de `z.number()`
+- Les entrées de type `checkbox` peuvent être validées à l'aide de `z.boolean()`
+- Les entrées de type `file` peuvent être validées à l'aide de `z.instanceof(File)`
+- Plusieurs entrées du même nom (`name`) peuvent être validées à l'aide de `z.array(/* validateur */)`
+- Toutes les autres entrées peuvent être validées à l'aide de `z.string()`
+
+Les fonctions d'extension, notamment `.refine()`, `.transform()` et `.pipe()`, sont également prises en charge sur cet objet. Les validateurs suivants sont pris en charge pour les champs de données de formulaire :
+
+Pour appliquer une union de différents validateurs, utilisez le wrapper `z.discriminatedUnion()` pour affiner le type en fonction d'un champ de formulaire spécifique. Cet exemple accepte une soumission de formulaire pour créer (`create`) ou mettre à jour (`update`) un utilisateur, en utilisant le champ de formulaire avec le nom `type` pour déterminer l'objet à valider :
+
+```ts
+import { defineAction } from 'astro:actions';
+import { z } from 'astro:schema';
+
+export const server = {
+  changeUser: defineAction({
+    accept: 'form',
+    input: z.discriminatedUnion('type', [
+      z.object({
+        // Correspond lorsque le champ `type` est défini sur la valeur `create`
+        type: z.literal('create'),
+        name: z.string(),
+        email: z.string().email(),
+      }),
+      z.object({
+        // Correspond lorsque le champ `type` est défini sur la valeur `update`
+        type: z.literal('update'),
+        id: z.number(),
+        name: z.string(),
+        email: z.string().email(),
+      }),
+    ]),
+    async handler(input) {
+      if (input.type === 'create') {
+        // l'entrée correspond à { type: 'create', name: string, email: string }
+      } else {
+        // l'entrée correspond à { type: 'update', id: number, name: string, email: string }
+      }
+    },
+  }),
+};
+```
+
+### `isInputError()`
+
+<p>
+
+**Type :** <code>(error?: unknown | <a href="#actionerror">ActionError</a>) => boolean</code><br/>
+<Since v="4.15.0" />
+</p>
+
+L'utilitaire `isInputError()` permet de vérifier si une `ActionError` est une erreur de validation d'entrée. Lorsque le validateur utilisé pour `input` correspond à `z.object()`, les erreurs d'entrée incluent un objet `fields` avec des messages d'erreur regroupés par nom.
+
+<ReadMore>Consultez le [guide des erreurs de saisie de formulaire](/fr/guides/actions/#affichage-des-erreurs-de-saisie-du-formulaire) pour en savoir plus sur l'utilisation de `isInputError()`.</ReadMore>
+
+### `ActionError`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+Le constructeur `ActionError()` est utilisé pour créer des erreurs générées par un gestionnaire d'action (`handler`). Il accepte une propriété `code` décrivant l'erreur qui s'est produite (par exemple : `"UNAUTHORIZED"`), et une propriété facultative `message` contenant plus de détails.
+
+#### `code`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+La propriété `code` accepte les versions lisibles par l'homme de tous les codes d'état HTTP. Les codes suivants sont pris en charge :
+
+- `BAD_REQUEST` (400) : Le client a envoyé une entrée non valide. Cette erreur est générée lorsqu'un validateur d'entrée d'action (`input`) ne parvient pas à valider.
+- `UNAUTHORIZED` (401) : Le client ne dispose pas d’informations d’authentification valides.
+- `FORBIDDEN` (403) : Le client n'est pas autorisé à accéder à une ressource.
+- `NOT_FOUND` (404) : Le serveur ne trouve pas la ressource demandée.
+- `METHOD_NOT_SUPPORTED` (405) : Le serveur ne prend pas en charge la méthode demandée.
+- `TIMEOUT` (408) : Le serveur a expiré lors du traitement de la demande.
+- `CONFLICT` (409) : Le serveur ne peut pas mettre à jour une ressource en raison d'un conflit.
+- `PRECONDITION_FAILED` (412) : Le serveur ne répond pas à une condition préalable de la requête.
+- `PAYLOAD_TOO_LARGE` (413) : Le serveur ne peut pas traiter la demande car la charge utile est trop importante.
+- `UNSUPPORTED_MEDIA_TYPE` (415) : Le serveur ne prend pas en charge le type de média de la requête. Remarque : les actions vérifient déjà [l'en-tête `Content-Type`](https://developer.mozilla.org/fr/docs/Web/HTTP/Headers/Content-Type) pour les requêtes JSON et de formulaire. Vous n'aurez donc probablement pas besoin de générer ce code manuellement.
+- `UNPROCESSABLE_CONTENT` (422) : Le serveur ne peut pas traiter la demande en raison d'erreurs sémantiques.
+- `TOO_MANY_REQUESTS` (429) : Le serveur a dépassé une limite de débit spécifiée.
+- `CLIENT_CLOSED_REQUEST` (499) : Le client a fermé la demande avant que le serveur puisse répondre.
+- `INTERNAL_SERVER_ERROR` (500) : Le serveur est tombé en panne de manière inattendue.
+- `NOT_IMPLEMENTED` (501) : Le serveur ne prend pas en charge la fonctionnalité demandée.
+- `BAD_GATEWAY` (502) : Le serveur a reçu une réponse non valide d’un serveur en amont.
+- `SERVICE_UNAVAILABLE` (503) : Le serveur est temporairement indisponible.
+- `GATEWAY_TIMEOUT` (504) : Le serveur a reçu un délai d'attente d'un serveur en amont.
+
+#### `message`
+
+<p>
+<Since v="4.15.0" />
+</p>
+
+La propriété `message` accepte une chaîne de caractères. (par exemple, « L'utilisateur doit être connecté. »)

From 544662f970ee51c07ba9ac46ec422d4e21ee2647 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Mon, 28 Oct 2024 12:03:46 +0100
Subject: [PATCH 29/43] i18n(fr): update `guides/actions.mdx` (#9838)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 src/content/docs/fr/guides/actions.mdx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/content/docs/fr/guides/actions.mdx b/src/content/docs/fr/guides/actions.mdx
index 791b9fd8bb19c..56f56f68a33d0 100644
--- a/src/content/docs/fr/guides/actions.mdx
+++ b/src/content/docs/fr/guides/actions.mdx
@@ -16,7 +16,7 @@ Utilisez des actions à la place de points de terminaison d'API pour une communi
 
 - Valider automatiquement les entrées de données JSON et de formulaire à l'aide de la [validation Zod](https://zod.dev/?id=primitives).
 - Générer des fonctions avec sûreté du typage pour appeler votre backend à partir du client et même [à partir des actions de formulaire HTML](#appeler-des-actions-depuis-une-action-de-formulaire-html). Pas besoin d'appels manuels à `fetch()`.
-- Standardiser les erreurs du backend avec l'objet [`ActionError`](/fr/reference/api-reference/#actionerror).
+- Standardiser les erreurs du backend avec l'objet [`ActionError`](/fr/reference/modules/astro-actions/#actionerror).
 
 ## Utilisation de base
 
@@ -129,7 +129,7 @@ Suivez ces étapes pour définir une action et pour l'appeler dans une balise `s
 
 </Steps>
 
-<ReadMore>Consultez la documentation complète de l'API Actions pour plus de détails sur [`defineAction()`](/fr/reference/api-reference/#defineaction) et ses propriétés.</ReadMore>
+<ReadMore>Consultez la documentation complète de l'API Actions pour plus de détails sur [`defineAction()`](/fr/reference/modules/astro-actions/#defineaction) et ses propriétés.</ReadMore>
 
 ## Organiser les actions
 
@@ -340,7 +340,7 @@ L'exemple suivant montre un formulaire d'inscription à une newsletter validé q
     }
     ```
 
-    <ReadMore>Consultez la [référence de l'API `input`](/fr/reference/api-reference/#validateur-de-saisie-input) pour tous les validateurs de formulaire disponibles.</ReadMore>
+    <ReadMore>Consultez la [référence de l'API `input`](/fr/reference/modules/astro-actions/#validateur-de-saisie-input) pour tous les validateurs de formulaire disponibles.</ReadMore>
 
 3. Ajoutez un `<script>` au formulaire HTML pour soumettre la saisie de l'utilisateur. Cet exemple remplace le comportement de soumission par défaut du formulaire pour appeler `actions.newsletter()` et redirige vers `/confirmation` à l'aide de la fonction `navigate()` :
 
@@ -375,7 +375,7 @@ L'exemple suivant montre un formulaire d'inscription à une newsletter validé q
 
 ### Affichage des erreurs de saisie du formulaire
 
-Vous pouvez valider les entrées du formulaire avant la soumission à l'aide des [attributs natifs de validation de formulaire HTML](https://developer.mozilla.org/fr/docs/Learn/Forms/Form_validation#utiliser_la_validation_intégrée_au_formulaire) tels que `required`, `type="email"` et `pattern`. Pour une validation plus complexe d'`input` depuis le backend, vous pouvez utiliser la fonction utilitaire [`isInputError()`](/fr/reference/api-reference/#isinputerror).
+Vous pouvez valider les entrées du formulaire avant la soumission à l'aide des [attributs natifs de validation de formulaire HTML](https://developer.mozilla.org/fr/docs/Learn/Forms/Form_validation#utiliser_la_validation_intégrée_au_formulaire) tels que `required`, `type="email"` et `pattern`. Pour une validation plus complexe d'`input` depuis le backend, vous pouvez utiliser la fonction utilitaire [`isInputError()`](/fr/reference/modules/astro-actions/#isinputerror).
 
 Pour récupérer les erreurs de saisie, utilisez l'utilitaire `isInputError()` pour vérifier si une erreur a été provoquée par une entrée non valide. Les erreurs de saisie contiennent un objet `fields` avec des messages pour chaque nom d'entrée qui n'a pas pu être validé. Vous pouvez utiliser ces messages pour demander à votre utilisateur de corriger sa soumission.
 

From 1dbe70b5246a1dc72fbd3de2aaf614c3f55ddbc1 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Mon, 28 Oct 2024 13:13:30 +0100
Subject: [PATCH 30/43] i18n(fr): create
 `reference/modules/astro-transitions.mdx` (#9829)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 .../reference/modules/astro-transitions.mdx   | 457 ++++++++++++++++++
 1 file changed, 457 insertions(+)
 create mode 100644 src/content/docs/fr/reference/modules/astro-transitions.mdx

diff --git a/src/content/docs/fr/reference/modules/astro-transitions.mdx b/src/content/docs/fr/reference/modules/astro-transitions.mdx
new file mode 100644
index 0000000000000..eff866e1afce8
--- /dev/null
+++ b/src/content/docs/fr/reference/modules/astro-transitions.mdx
@@ -0,0 +1,457 @@
+---
+title: Référence de l'API de transitions de vue
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="3.0.0" /></p>
+
+Ce module fournit des fonctions pour contrôler et interagir avec l'API Transitions de Vue et le routeur côté client.
+
+Pour des fonctionnalités et des exemples d'utilisation, [consultez notre guide sur les Transitions de Vue](/fr/guides/view-transitions/).
+
+## Importations depuis `astro:transitions`
+
+```ts
+import { ViewTransitions, fade, slide } from 'astro:transitions';
+```
+
+### `<ViewTransitions />`
+
+<p><Since v="3.0.0" /></p>
+
+Choisissez d'utiliser les transitions de vue sur des pages individuelles en important et en ajoutant le composant de routage `<ViewTransitions />` dans la balise `<head>` sur chaque page souhaitée.
+
+```astro title="src/pages/index.astro" ins={2,7}
+---
+import { ViewTransitions } from 'astro:transitions';
+---
+<html lang="fr">
+  <head>
+    <title>Ma page d'accueil</title>
+    <ViewTransitions />
+  </head>
+  <body>
+    <h1>Bienvenue sur mon site web !</h1>
+  </body>
+</html>
+```
+
+Découvrez comment [contrôler le routeur](/fr/guides/view-transitions/#contrôle-du-routeur) et [ajouter des directives de transition](/fr/guides/view-transitions/#directives-de-transition) aux éléments et composants de la page.
+
+### `fade`
+
+<p>
+
+**Type :** `(opts: { duration?: string | number }) => TransitionDirectionalAnimations`
+<Since v="3.0.0" />
+</p>
+
+Fonction utilitaire permettant de prendre en charge la personnalisation de la durée de l'animation `fade` intégrée.
+
+```astro {2} /fade\\(.+\\)/
+---
+import { fade } from 'astro:transitions';
+---
+
+<!-- Transition en fondu avec la durée par défaut -->
+<div transition:animate="fade" />
+
+<!-- Transition en fondu d'une durée de 400 millisecondes -->
+<div transition:animate={fade({ duration: '0.4s' })} />
+```
+
+### `slide`
+
+<p>
+
+**Type :** `(opts: { duration?: string | number }) => TransitionDirectionalAnimations`
+<Since v="3.0.0" />
+</p>
+
+Fonction utilitaire permettant de prendre en charge la personnalisation de la durée de l'animation `slide` intégrée.
+
+```astro {2} /slide\\(.+\\)/
+---
+import { slide } from 'astro:transitions';
+---
+
+<!-- Transition de glissement avec la durée par défaut -->
+<div transition:animate="slide" />
+
+<!-- Transition de glissement d'une durée de 400 millisecondes -->
+<div transition:animate={slide({ duration: '0.4s' })} />
+```
+
+## Importations depuis `astro:transitions/client`
+
+```astro
+<script>
+  import { 
+    navigate,
+    supportsViewTransitions,
+    transitionEnabledOnThisPage,
+    getFallback,
+    swapFunctions,
+  } from 'astro:transitions/client';
+</script>
+```
+
+### `navigate()`
+
+<p>
+
+**Type :** `(href: string, options?: Options) => void`<br />
+<Since v="3.2.0" />
+</p>
+
+Une fonction qui exécute une navigation vers le `href` donné à l'aide de l'API Transitions de Vue.
+
+Cette signature de fonction est basée sur la fonction [`navigate` de l'API Navigation du navigateur](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate). Bien que basée sur l'API Navigation, cette fonction est implémentée sur l'[API History](https://developer.mozilla.org/fr/docs/Web/API/History_API) pour permettre la navigation sans recharger la page.
+
+#### Option `history`
+
+<p>
+
+**Type :** `'auto' | 'push' | 'replace'`<br />
+**Par défaut :** `'auto'`<br />
+<Since v="3.2.0" />
+</p>
+
+Définit la manière dont cette navigation doit être ajoutée à l'historique du navigateur.
+
+- `'push'` : le routeur utilisera `history.pushState` pour créer une nouvelle entrée dans l'historique du navigateur.
+- `'replace'` : le routeur utilisera `history.replaceState` pour mettre à jour l'URL sans ajouter de nouvelle entrée dans la navigation.
+- `'auto'` (par défaut) : le routeur tentera `history.pushState`, mais si l'URL ne peut pas être transférée, l'URL actuelle restera sans modification de l'historique du navigateur.
+
+Cette option suit l'[option `history`](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#history) de l'API Navigation du navigateur mais simplifiée pour les cas qui peuvent survenir sur un projet Astro.
+
+#### Option `formData`
+
+<p>
+
+**Type :** `FormData`<br />
+<Since v="3.5.0" />
+</p>
+
+Un objet `FormData` pour les requêtes `POST`.
+
+Lorsque cette option est transmise, les requêtes vers la page cible de navigation seront envoyées sous forme de requête `POST` avec l'objet de données du formulaire comme contenu.
+
+L'envoi d'un formulaire HTML avec les transitions de vue activées utilisera cette méthode au lieu de la navigation par défaut avec rechargement de page. L'appel de cette méthode permet de déclencher le même comportement par programmation.
+
+#### Option `info`
+
+<p>
+
+**Type :** `any`<br />
+<Since v="3.6.0" />
+</p>
+
+Données arbitraires à inclure dans les événements `astro:before-preparation` et `astro:before-swap` provoqués par cette navigation.
+
+Cette option imite l'[option `info`](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#info) de l'API Navigation du navigateur.
+
+#### Option `state`
+
+<p>
+
+**Type :** `any`<br />
+<Since v="3.6.0" />
+</p>
+
+Données arbitraires à associer à l'objet `NavitationHistoryEntry` créé par cette navigation. Ces données peuvent ensuite être récupérées à l'aide de la fonction [`history.getState`](https://developer.mozilla.org/en-US/docs/Web/API/NavigationHistoryEntry/getState) de l'API History.
+
+Cette option imite l'[option `state`](https://developer.mozilla.org/en-US/docs/Web/API/Navigation/navigate#state) de l'API Navigation du navigateur.
+
+#### Option `sourceElement`
+
+<p>
+
+**Type :** `Element`<br />
+<Since v="3.6.0" />
+</p>
+
+L'élément qui a déclenché cette navigation, le cas échéant. Cet élément sera disponible dans les événements suivants :
+- `astro:before-preparation`
+- `astro:before-swap`
+
+### `supportsViewTransitions`
+
+<p>
+
+**Type :** `boolean`<br />
+<Since v="3.2.0" />
+</p>
+
+Indique si les transitions de vue sont prises en charge et activées dans le navigateur actuel.
+
+### `transitionEnabledOnThisPage`
+
+<p>
+
+**Type :** `boolean`<br />
+<Since v="3.2.0" />
+</p>
+
+Indique si la page actuelle comporte ou non des transitions d'affichage activées pour la navigation côté client. Cela peut être utilisé pour créer des composants qui se comportent différemment lorsqu'ils sont utilisés sur des pages avec des transitions de vue.
+
+### `getFallback()`
+
+<p>
+
+**Type :** `() => 'none' | 'animate' | 'swap'`<br />
+<Since v="3.6.0" />
+</p>
+
+Renvoie la stratégie de secours à utiliser dans les navigateurs qui ne prennent pas en charge les transitions de vue.
+
+Voir le guide sur la [Gestion de solution de secours](/fr/guides/view-transitions/#gestion-de-solution-de-secours) pour savoir comment choisir et configurer le comportement de repli.
+
+### `swapFunctions`
+
+<p>
+
+<Since v="4.15.0" />
+</p>
+
+Un objet contenant les fonctions utilitaires utilisées pour créer la fonction d’échange par défaut d’Astro.
+Celles-ci peuvent être utiles lors de la [création d'une fonction d'échange personnalisée](/fr/guides/view-transitions/#créer-une-fonction-déchange-personnalisée).
+
+`swapFunctions` fournit les méthodes suivantes :
+
+#### `deselectScripts()`
+
+<p>
+
+**Type :** `(newDocument: Document) => void`
+</p>
+
+Marque les scripts du nouveau document qui ne doivent pas être exécutés. Ces scripts sont déjà présents dans le document actuel et ne sont pas signalés pour une réexécution à l'aide de [`data-astro-rerun`](/fr/guides/view-transitions/#data-astro-rerun).
+
+#### `swapRootAttributes()`
+
+<p>
+
+**Type :** `(newDocument: Document) => void`
+</p>
+
+Échange les attributs entre les racines du document, comme l'attribut `lang`. Cela inclut également les attributs internes injectés par Astro comme `data-astro-transition`, qui rendent la direction de transition disponible pour les règles CSS générées par Astro.
+
+Lors de la création d'une fonction d'échange personnalisée, il est important d'appeler cette fonction afin de ne pas interrompre les animations de transition de vue.
+
+#### `swapHeadElements()`
+
+<p>
+
+**Type :** `(newDocument: Document) => void`
+</p>
+
+Supprime tous les éléments présents dans la balise `<head>` du document actuel qui ne sont pas conservés dans le nouveau document. Ajoute ensuite tous les nouveaux éléments présents dans la balise `<head>` du nouveau document dans celle du document courant.
+
+#### `saveFocus()`
+
+<p>
+
+**Type :** `() => () => void`
+</p>
+
+Stocke l'élément focalisé sur la page actuelle et renvoie une fonction qui, lorsqu'elle est appelée, si l'élément focalisé a été conservé, renvoie le focus sur celui-ci.
+
+
+#### `swapBodyElement()`
+
+<p>
+
+**Type :** `(newBody: Element, oldBody: Element) => void`
+</p>
+
+Remplace l'ancien corps par le nouveau. Ensuite, il passe en revue chaque élément de l'ancien corps qui doit être conservé et qui possède un élément correspondant dans le nouveau corps avant de remplacer l'ancien élément en place.
+
+## Événements du cycle de vie
+
+### Événement `astro:before-preparation`
+
+Un événement déclenché au début d'une navigation à l'aide de Transitions de Vue. Cet événement se produit avant toute demande et tout changement d'état du navigateur.
+
+Cet événement possède les attributs suivants :
+- [`info`](#info)
+- [`sourceElement`](#sourceelement)
+- [`navigationType`](#navigationtype)
+- [`direction`](#direction)
+- [`from`](#from)
+- [`to`](#to)
+- [`formData`](#formdata)
+- [`loader`](#loader)
+
+Pour en savoir plus sur l'utilisation de cet événement, consultez le [Guide des Transitions de Vue](/fr/guides/view-transitions/#astrobefore-preparation).
+
+### Événement `astro:after-preparation`
+
+Un événement envoyé après le chargement de la page suivante dans une navigation utilisant des Transitions de Vue.
+
+Cet événement n'a aucun attribut.
+
+Pour en savoir plus sur l'utilisation de cet événement, consultez le [Guide des Transitions de Vue](/fr/guides/view-transitions/#astroafter-preparation).
+
+### Événement `astro:before-swap`
+
+Un événement envoyé après que la page suivante est analysée, préparée et liée à un document en prévision de la transition, mais avant que tout contenu ne soit échangé entre les documents.
+
+Cet événement ne peut pas être annulé. L'appel de `preventDefault()` est une opération interdite.
+
+Cet événement possède les attributs suivants :
+- [`info`](#info)
+- [`sourceElement`](#sourceelement)
+- [`navigationType`](#navigationtype)
+- [`direction`](#direction)
+- [`from`](#from)
+- [`to`](#to)
+- [`viewTransition`](#viewtransition)
+- [`swap`](#swap)
+
+Pour en savoir plus sur l'utilisation de cet événement, consultez le [Guide des Transitions de Vue](/fr/guides/view-transitions/#astrobefore-swap).
+
+### Événement `astro:after-swap`
+
+Un événement envoyé après que le contenu de la page a été échangé mais avant la fin de la transition de vue.
+
+L'entrée de l'historique et la position de défilement ont déjà été mises à jour lorsque cet événement est déclenché.
+
+### Événement `astro:page-load`
+
+Un événement envoyé une fois le chargement d'une page terminé, qu'il s'agisse d'une navigation utilisant des transitions de vue ou native du navigateur.
+
+Lorsque les transitions de vue sont activées sur la page, le code qui s'exécuterait normalement sur `DOMContentLoaded` doit être modifié pour s'exécuter sur cet événement.
+
+### Attributs des événements du cycle de vie
+
+<p><Since v="3.6.0" /></p>
+
+#### `info`
+
+<p>
+
+**Type :** `URL`
+</p>
+
+Données arbitraires définies lors de la navigation.
+
+Il s'agit de la valeur littérale transmise à l'[option `info`](#option-info) de la [fonction `navigate()`](#navigate).
+
+#### `sourceElement`
+
+<p>
+
+**Type :** `Element | undefined`
+</p>
+
+L'élément qui a déclenché la navigation. Il peut s'agir, par exemple, d'un élément `<a>` sur lequel on a cliqué.
+
+Lors de l'utilisation de la [fonction `navigate()`](#navigate), ce sera l'élément spécifié dans l'appel.
+
+#### `newDocument`
+
+<p>
+
+**Type :** `Document`
+</p>
+
+Le document de la page suivante dans la navigation. Le contenu de ce document sera échangé à la place du contenu du document actuel.
+
+#### `navigationType`
+
+<p>
+
+**Type :** `'push' | 'replace' | 'traverse'`
+</p>
+
+Quel type de navigation dans l'historique est en cours.
+- `push` : une nouvelle `NavigationHistoryEntry` est en cours de création pour la nouvelle page.
+- `replace` : l'actuelle `NavigationHistoryEntry` est remplacée par une entrée pour la nouvelle page.
+- `traverse` : aucune `NavigationHistoryEntry` n'est créée. La position dans l'historique change.
+  La direction du parcours est donnée sur l'[attribut `direction`](#direction)
+
+#### `direction`
+
+<p>
+
+**Type :** `Direction`
+</p>
+
+La direction de la transition.
+- `forward` : naviguer vers la page suivante de l'historique ou vers une nouvelle page.
+- `back` : naviguer vers la page précédente de l'historique.
+- Tout ce qu’un autre écouteur d'événement aurait pu définir.
+
+#### `from`
+
+<p>
+
+**Type :** `URL`
+</p>
+
+L'URL de la page initiant la navigation.
+
+#### `to`
+
+<p>
+
+**Type :** `URL`
+</p>
+
+L'URL de la page vers laquelle on navigue. Cette propriété peut être modifiée, la valeur à la fin du cycle de vie sera utilisée dans le `NavigationHistoryEntry` pour la page suivante.
+
+#### `formData`
+
+<p>
+
+**Type :** `FormData | undefined`
+</p>
+
+Un objet `FormData` pour les requêtes `POST`.
+
+Lorsque cet attribut est défini, une requête `POST` sera envoyée à l'[URL`to`](#to) avec l'objet de données de formulaire donné comme contenu au lieu de la requête `GET` normale.
+
+Lors de la soumission d'un formulaire HTML avec les transitions de vue activées, ce champ est automatiquement défini sur les données du formulaire. Lorsque vous utilisez la [fonction `navigate()`](#navigate), cette valeur est la même que celle donnée dans les options.
+
+#### `loader()`
+
+<p>
+
+**Type :** `() => Promise<void>`
+</p>
+
+Implémentation de la phase suivante dans la navigation (chargement de la page suivante). Cette implémentation peut être surchargée pour ajouter un comportement supplémentaire.
+
+#### `viewTransition`
+
+<p>
+
+**Type :** [`ViewTransition`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransition)
+</p>
+
+L'objet de transition de vue utilisé dans cette navigation. Sur les navigateurs qui ne prennent pas en charge l'[API de Transitions de Vue](https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API), il s'agit d'un objet implémentant la même API pour plus de commodité, mais sans l'intégration DOM.
+
+#### `swap()`
+
+<p>
+
+**Type :** `() => void`
+</p>
+
+Mise en place de la logique d'échange de documents.
+
+Apprenez-en davantage sur la façon de [créer votre propre fonction d'échange personnalisée](/fr/guides/view-transitions/#créer-une-fonction-déchange-personnalisée) dans le guide Transitions de Vue.
+
+Par défaut, cette implémentation appellera les fonctions suivantes dans l’ordre :
+
+1. [`deselectScripts()`](#deselectscripts)
+2. [`swapRootAttributes()`](#swaprootattributes)
+3. [`swapHeadElements()`](#swapheadelements)
+4. [`saveFocus()`](#savefocus)
+5. [`swapBodyElement()`](#swapbodyelement)

From ebb91313fc193079dcb45c6193ba3c1a3b607c68 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Mon, 28 Oct 2024 13:25:17 +0100
Subject: [PATCH 31/43] i18n(fr): create `reference/modules/astro-content.mdx`
 (#9825)

See #9687 and #9821

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 .../fr/reference/modules/astro-content.mdx    | 376 ++++++++++++++++++
 1 file changed, 376 insertions(+)
 create mode 100644 src/content/docs/fr/reference/modules/astro-content.mdx

diff --git a/src/content/docs/fr/reference/modules/astro-content.mdx b/src/content/docs/fr/reference/modules/astro-content.mdx
new file mode 100644
index 0000000000000..59c90d06611fb
--- /dev/null
+++ b/src/content/docs/fr/reference/modules/astro-content.mdx
@@ -0,0 +1,376 @@
+---
+title: Référence de l'API des collections de contenu
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="2.0.0" /></p>
+
+Les collections de contenu proposent des API pour configurer et interroger vos documents Markdown ou MDX dans `src/content/`. Pour connaître les fonctionnalités et les exemples d'utilisation, [consultez notre guide sur les collections de contenu](/fr/guides/content-collections/).
+
+## Importations depuis `astro:content`
+
+```js
+import { 
+  z,
+  defineCollection,
+  getCollection,
+  getEntry,
+  getEntries,
+  reference,
+ } from 'astro:content';
+```
+### `defineCollection()`
+
+<p>
+
+**Type :** `(input: CollectionConfig) => CollectionConfig`
+</p>
+
+`defineCollection()` est un utilitaire pour configurer une collection dans un fichier `src/content/config.*`.
+
+```ts
+// src/content/config.ts
+import { z, defineCollection } from 'astro:content';
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    title: z.string(),
+    permalink: z.string().optional(),
+  }),
+});
+
+// Exposez votre collection définie à Astro
+// avec l'exportation `collections`
+export const collections = { blog };
+```
+
+Cette fonction accepte les propriétés suivantes :
+
+#### `type`
+
+<p>
+
+**Type :** `'content' | 'data'`<br />
+**Par défaut :** `'content'`<br />
+<Since v="2.5.0" />
+</p>
+
+`type` est une chaîne de caractères qui définit le type d'entrées stockées dans une collection :
+
+- `'content'` - pour les formats de création de contenu comme Markdown (`.md`), MDX (`.mdx`) ou Markdoc (`.mdoc`)
+- `'data'` - pour les formats de données uniquement comme JSON (`.json`) ou YAML (`.yaml`)
+
+:::tip
+Cela signifie que les collections **ne peuvent pas** stocker un mélange de contenus et de formats de données. Vous devez diviser ces entrées en collections distinctes par type.
+:::
+
+#### `schema`
+
+<p>
+
+**Type :** <code>ZodType | (context: <a href="#schemacontext">SchemaContext</a>) => ZodType</code>
+</p>
+
+`schema` est un objet Zod facultatif pour configurer le type et la forme du document pour une collection. Chaque valeur doit utiliser [un validateur Zod](https://github.com/colinhacks/zod).
+
+[Consultez le guide Collections de contenu](/fr/guides/content-collections/#définition-dun-schéma-de-collection) pour un exemple d'utilisation.
+
+### `reference()`
+
+<p>
+
+**Type :** `(collection: string) => ZodEffects<ZodString, { collection, id: string } | { collection, slug: string }>`<br />
+<Since v="2.5.0" />
+</p>
+
+La fonction `reference()` est utilisée dans la configuration du contenu pour définir une relation, ou une « référence », entre une collection et une autre. Elle accepte un nom de collection et valide le ou les identifiants d'entrée spécifiés dans le frontmatter de votre contenu ou dans votre fichier de données.
+
+Cet exemple définit les références d'un auteur de blog à la collection `authors` et un tableau d'articles associés à la même collection `blog` :
+
+```ts
+import { defineCollection, reference, z } from 'astro:content';
+
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    // Référence un seul auteur de la collection `authors` par `id`
+    author: reference('authors'),
+    // Référence un tableau d'articles connexes de la collection `blog` par `slug`
+    relatedPosts: z.array(reference('blog')),
+  })
+});
+
+const authors = defineCollection({
+  type: 'data',
+  schema: z.object({ /* ... */ })
+});
+
+export const collections = { blog, authors };
+```
+
+[Consultez le guide Collections de contenu](/fr/guides/content-collections/#définition-des-références-de-collection) pour un exemple d'utilisation.
+
+### `getCollection()`
+
+<p>
+
+**Type :** `(collection: string, filter?: (entry: CollectionEntry<TCollectionName>) => boolean) => CollectionEntry<TCollectionName>[]`
+</p>
+
+`getCollection()` est une fonction qui récupère une liste d'entrées de collection de contenu par nom de collection.
+
+Il renvoie tous les éléments de la collection par défaut et accepte une fonction facultative `filter` pour affiner les propriétés d'entrée. Cela vous permet d'interroger uniquement certains éléments d'une collection en fonction de `id`, `slug` ou des valeurs du frontmatter via l'objet `data`.
+
+```astro
+---
+import { getCollection } from 'astro:content';
+
+// Récupère toutes les entrées `src/content/blog/`
+const allBlogPosts = await getCollection('blog');
+
+// Ne renvoie que les messages avec `draft: true` dans le frontmatter
+const draftBlogPosts = await getCollection('blog', ({ data }) => {
+  return data.draft === true;
+});
+---
+```
+
+[Consultez le guide Collections de contenu](/fr/guides/content-collections/#interroger-les-collections) pour un exemple d'utilisation.
+
+### `getEntry()`
+
+<p><Since v="2.5.0" /></p>
+
+**Types :**
+- `(collection: string, contentSlugOrDataId: string) => CollectionEntry<TCollectionName>`
+- `({ collection: string, id: string }) => CollectionEntry<TCollectionName>`
+- `({ collection: string, slug: string }) => CollectionEntry<TCollectionName>`
+
+`getEntry()` est une fonction qui récupère une seule entrée de collection en utilisant le nom de la collection et soit l'entrée `id` (pour les collections utilisant `type: 'data'`) soit l'entrée `slug` (pour les collections utilisant `type: 'content'`). `getEntry()` peut également être utilisée pour obtenir des entrées référencées pour accéder aux propriétés `data`, `body` ou `render()` :
+
+```astro
+---
+import { getEntry } from 'astro:content';
+
+// Récupère `src/content/blog/enterprise.md`
+const enterprisePost = await getEntry('blog', 'enterprise');
+
+// Récupère `src/content/captains/picard.yaml`
+const picardProfile = await getEntry('captains', 'picard');
+
+// Récupère le profil référencé par `data.captain`
+const enterpriseCaptainProfile = await getEntry(enterprisePost.data.captain);
+---
+```
+
+Consultez le guide Collections de contenu pour des exemples d'[interrogation des entrées de collection](/fr/guides/content-collections/#interroger-les-collections).
+
+### `getEntries()`
+
+<p><Since v="2.5.0" /></p>
+
+**Types :**
+- `(Array<{ collection: string, id: string }>) => CollectionEntry<TCollectionName>[]`
+- `(Array<{ collection: string, slug: string }>) => CollectionEntry<TCollectionName>[]`
+
+`getEntries()` est une fonction qui récupère plusieurs entrées dans une même collection. Ceci est utile pour [renvoyer un tableau d'entrées référencées](/fr/guides/content-collections/#définition-des-références-de-collection) pour accéder à leurs propriétés `data`, `body` et `render()` associées.
+
+```astro
+---
+import { getEntries } from 'astro:content';
+
+const enterprisePost = await getEntry('blog', 'enterprise');
+
+// Récupère les articles associés référencés par `data.ratedPosts`
+const enterpriseRelatedPosts = await getEntries(enterprisePost.data.relatedPosts);
+---
+```
+
+### `getEntryBySlug()`
+
+<p>
+
+**Type :** `(collection: string, slug: string) => Promise<CollectionEntry<TCollectionName>>`
+</p>
+
+:::caution[Obsolète]
+Utilisez la fonction [`getEntry()`](#getentry) pour interroger les entrées de contenu. Elle accepte les mêmes arguments que `getEntryBySlug()` et prend en charge les requêtes par `id` pour les collections JSON ou YAML.
+:::
+
+`getEntryBySlug()` est une fonction qui récupère une seule entrée de collection en utilisant le nom de la collection et le `slug` d'une entrée.
+
+
+```astro
+---
+import { getEntryBySlug } from 'astro:content';
+
+const enterprise = await getEntryBySlug('blog', 'enterprise');
+---
+```
+
+[Consultez le guide Collections de contenu](/fr/guides/content-collections/#interroger-les-collections) pour un exemple d'utilisation.
+
+### `getDataEntryById()`
+
+<p>
+
+**Type :** `(collection: string, id: string) => Promise<CollectionEntry<TCollectionName>>`<br />
+<Since v="2.5.0" />
+</p>
+
+:::caution[Obsolète]
+Utilisez la [fonction `getEntry()`](#getentry) pour interroger les entrées de données. Cela accepte les mêmes arguments que `getDataEntryById()` et prend en charge l'interrogation par `slug` pour les formats de création de contenu comme Markdown.
+:::
+
+`getDataEntryById()` est une fonction qui récupère une seule entrée de collection par nom de collection et par `id` d'entrée.
+
+
+```astro
+---
+import { getDataEntryById } from 'astro:content';
+
+const picardProfile = await getDataEntryById('captains', 'picard');
+---
+```
+
+## Types d'`astro:content`
+
+```ts
+import type {
+  CollectionEntry,
+  CollectionKey,
+  ContentCollectionKey,
+  DataCollectionKey,
+  SchemaContext,
+ } from 'astro:content';
+```
+
+### `CollectionEntry`
+
+Les fonctions de requête, notamment [`getCollection()`](#getcollection), [`getEntry()`](#getentry) et [`getEntries()`](#getentries) renvoient chacune des entrées avec le type `CollectionEntry`. Ce type est disponible en tant qu'utilitaire depuis `astro:content` :
+
+```ts
+import type { CollectionEntry } from 'astro:content';
+```
+
+`CollectionEntry` est un type générique. Utilisez-le avec le nom de la collection que vous interrogez.
+Par exemple, une entrée de votre collection `blog` aurait le type `CollectionEntry<'blog'>`.
+
+Chaque `CollectionEntry` est un objet avec les valeurs suivantes :
+
+#### `id`
+
+**Disponible pour :** les collections utilisant `type: 'content'` ou `type: 'data'`  
+**Exemple de types :**
+  - collections de contenu : `'entry-1.md' | 'entry-2.md' | ...`
+  - collections de données : `'author-1' | 'author-2' | ...`
+
+Un identifiant unique utilisant le chemin du fichier relatif à `src/content/[collection]`. Énumère toutes les valeurs de chaîne de caractères possibles en fonction des chemins d’accès au fichier d’entrée de collection. Notez que les collections [définies comme `type: 'content'`](#type) incluent l'extension de fichier dans leur identifiant, contrairement aux collections définies comme `type: 'data'`.
+
+#### `collection`
+
+**Disponible pour :** les collections utilisant `type: 'content'` ou `type: 'data'`  
+**Exemple de type :** `'blog' | 'authors' | ...`
+
+Le nom d'un dossier placé à la racine de `src/content/` et dans lequel se trouvent les entrées. Il s'agit du nom utilisé pour référencer la collection dans votre schéma et dans les fonctions de requête.
+
+#### `data`
+
+**Disponible pour :** les collections utilisant `type: 'content'` ou `type: 'data'`  
+**Type :** `CollectionSchema<TCollectionName>`
+
+Un objet de propriétés provenant du frontmatter et déduit de votre schéma de collection ([voir la référence `defineCollection()`](#definecollection)). La valeur par défaut est `any` si aucun schéma n'est configuré.
+
+#### `slug`
+
+**Disponible pour :** les collections utilisant `type: 'content'` seulement  
+**Exemple de type :** `'entry-1' | 'entry-2' | ...`
+
+Un slug d'URL préparé pour les documents Markdown ou MDX. La valeur par défaut est `id` sans l'extension de fichier, mais peut être remplacée en définissant [la propriété `slug`](/fr/guides/content-collections/#définition-dun-slug-personnalisé) dans le frontmatter d'un fichier.
+
+#### `body`
+
+**Disponible pour :** les collections utilisant `type: 'content'` seulement  
+**Type :** `string`
+
+Une chaîne de caractères contenant le corps brut et non compilé du document Markdown ou MDX.
+
+#### `render()`
+
+**Disponible pour :** les collections utilisant `type: 'content'` seulement  
+**Type :** `() => Promise<RenderedEntry>`
+
+Une fonction pour compiler un document Markdown ou MDX donné à afficher. Cela renvoie les propriétés suivantes :
+
+- `<Content />` - Un composant utilisé pour restituer le contenu du document dans un fichier Astro.
+- `headings` - Une liste générée de titres, [reflétant l'utilitaire `getHeadings()` d'Astro](/fr/guides/markdown-content/#propriétés-disponibles) sur les importations Markdown et MDX.
+- `remarkPluginFrontmatter` - L'objet frontmatter modifié après [l'application de plugins Remark or Rehype](/fr/guides/markdown-content/#modification-programmatique-du-frontmatter). Définit sur le type `any`.
+
+```astro
+---
+import { getEntryBySlug } from 'astro:content';
+const entry = await getEntryBySlug('blog', 'entry-1');
+
+const { Content, headings, remarkPluginFrontmatter } = await entry.render();
+---
+```
+
+[Consultez le guide Collections de contenu](/fr/guides/content-collections/#rendre-le-contenu-en-html) pour un exemple d'utilisation.
+
+### `CollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+Une union de chaînes de caractères de tous les noms de collections définis dans votre fichier `src/content/config.*`. Ce type peut être utile lors de la définition d'une fonction générique qui accepte n'importe quel nom de collection.
+
+```ts
+import { type CollectionKey, getCollection } from 'astro:content';
+
+async function getCollection(collection: CollectionKey) {
+  return getCollection(collection);
+}
+```
+
+### `ContentCollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+Une union de chaînes de caractères de tous les noms des collections `type: 'content'` définies dans votre fichier `src/content/config.*`.
+
+### `DataCollectionKey`
+
+<p><Since v="3.1.0" /></p>
+
+Une union de chaînes de caractères de tous les noms de la collection `type: 'data'` définie dans votre fichier `src/content/config.*`.
+
+### `SchemaContext`
+
+L'objet `context` que `defineCollection` utilise pour la forme de fonction du `schema`. Ce type peut être utile lors de la création de schémas réutilisables pour plusieurs collections.
+
+Il inclut la propriété suivante :
+
+- `image` - L'assistant de schéma `image()` qui vous permet [d'utiliser des images locales dans les collections de contenu](/fr/guides/images/#images-dans-les-collections-de-contenus)
+
+```ts
+import type { SchemaContext } from 'astro:content';
+
+export const imageSchema = ({ image }: SchemaContext) =>
+    z.object({
+        image: image(),
+        description: z.string().optional(),
+    });
+
+const blog = defineCollection({
+  type: 'content',
+  schema: ({ image }) => z.object({
+    title: z.string(),
+    permalink: z.string().optional(),
+    image: imageSchema({ image })
+  }),
+});
+```

From 2583076f837e83f6402874334a0b85753d9f5d80 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Mon, 28 Oct 2024 13:38:42 +0100
Subject: [PATCH 32/43] i18n(fr): create `reference/modules/astro-assets.mdx`
 (#9824)

* i18n(fr): create `reference/modules/astro-assets.mdx`

See #9687 and #9820

* remove extra space

Co-authored-by: Thomas Bonnet <thomasbnt@protonmail.com>

---------

Co-authored-by: Thomas Bonnet <thomasbnt@protonmail.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../fr/reference/modules/astro-assets.mdx     | 159 ++++++++++++++++++
 1 file changed, 159 insertions(+)
 create mode 100644 src/content/docs/fr/reference/modules/astro-assets.mdx

diff --git a/src/content/docs/fr/reference/modules/astro-assets.mdx b/src/content/docs/fr/reference/modules/astro-assets.mdx
new file mode 100644
index 0000000000000..ef8915473c995
--- /dev/null
+++ b/src/content/docs/fr/reference/modules/astro-assets.mdx
@@ -0,0 +1,159 @@
+---
+title: Référence de l'API des ressources
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="3.0.0" /></p>
+
+Astro fournit des composants intégrés et des fonctions d'aide pour optimiser et afficher vos images. Pour des fonctionnalités et des exemples d'utilisation, [consultez notre guide d'images](/fr/guides/images/).
+
+## Importations depuis `astro:assets`
+
+```js
+import { 
+  Image,
+  Picture,
+  getImage,
+ } from 'astro:assets';
+```
+
+### `<Image />`
+
+```astro title="src/components/MyComponent.astro"
+---
+// importe le composant Image et l'image
+import { Image } from 'astro:assets';
+import myImage from "../assets/mon_image.png"; // Image a une résolution de 1600x900
+---
+
+<!-- `alt` est obligatoire sur le composant Image -->
+<Image src={myImage} alt="Une description de mon image." />
+```
+
+```html
+<!-- Sortie -->
+<!-- L'image est optimisée, les attributs appropriés sont appliqués -->
+<img
+  src="/_astro/mon_image.hash.webp"
+  width="1600"
+  height="900"
+  decoding="async"
+  loading="lazy"
+  alt="Une description de mon image."
+/>
+```
+#### Propriétés
+
+- src (requis)
+- alt (requis)
+- width et height (requis pour les images dans `public/` et celles distantes)
+- format
+- quality
+- densities
+- widths
+
+En plus des propriétés ci-dessus, le composant `<Image />` accepte toutes les propriétés acceptées par la balise HTML `<img>`.
+
+Pour en savoir plus, consultez le [Guide des images](/fr/guides/images/#image--astroassets).
+
+### `<Picture />`
+
+<p><Since v="3.3.0" /></p>
+
+Utilisez le composant Astro intégré `<Picture />` pour afficher une image réactive avec plusieurs formats et/ou tailles.
+
+```astro title="src/pages/index.astro"
+---
+import { Picture } from 'astro:assets';
+import myImage from "../assets/mon_image.png"; // La résolution de l'image est de 1600x900
+---
+
+<!-- `alt` est obligatoire sur le composant Picture -->
+<Picture src={myImage} formats={['avif', 'webp']} alt="Une description de mon image." />
+```
+
+```html
+<!-- Sortie -->
+<picture>
+  <source srcset="/_astro/mon_image.hash.avif" type="image/avif" />
+  <source srcset="/_astro/mon_image.hash.webp" type="image/webp" />
+  <img
+    src="/_astro/mon_image.hash.png"
+    width="1600"
+    height="900"
+    decoding="async"
+    loading="lazy"
+    alt="Une description de mon image."
+  />
+</picture>
+```
+
+Pour en savoir plus, consultez le [Guide des images](/fr/guides/images/#picture-).
+
+#### Propriétés
+
+`<Picture />` accepte toutes les propriétés du composant `<Image />` en plus des suivantes :
+
+##### `formats`
+
+Un tableau de formats d'image à utiliser pour les balises `<source>`. Par défaut, il est défini sur `['webp']`.
+
+##### `fallbackFormat`
+
+Format à utiliser comme valeur de repli pour la balise `<img>`. La valeur par défaut est `.png` pour les images statiques, `.gif` pour les images animées et `.svg` pour les fichiers SVG.
+
+##### `pictureAttributes`
+
+Un objet d'attributs à ajouter à la balise `<picture>`. Utilisez cette propriété pour appliquer des attributs à l'élément externe `<picture>` lui-même. Les attributs appliqués directement au composant `<Picture />` s'appliqueront à l'élément interne `<img>`, à l'exception de ceux utilisés pour la transformation d'image.
+
+### `getImage()`
+
+<p>
+
+**Type :** `(options: UnresolvedImageTransform) => Promise<GetImageResult>`
+</p>
+
+:::caution
+`getImage()` s'appuie sur des API serveur uniquement et interrompt la construction lorsqu'il est utilisé sur le client.
+:::
+
+La fonction `getImage()` est prévue pour générer des images destinées à être utilisées ailleurs que directement en HTML, par exemple dans une [route d'API](/fr/guides/endpoints/#points-de-terminaison-du-serveur-routes-api). Elle vous permet également de créer votre propre composant `<Image />` personnalisé.
+
+`getImage()` prend un objet d'options avec les [mêmes propriétés que le composant Image](/fr/reference/components-reference/#propriétés) (à l'exception de `alt`).
+
+```astro
+---
+import { getImage } from "astro:assets";
+import myBackground from "../background.png"
+
+const optimizedBackground = await getImage({src: myBackground, format: 'avif'})
+---
+
+<div style={`background-image: url(${optimizedBackground.src});`}></div>
+```
+
+Elle renvoie un objet avec le type suivant :
+
+```ts
+type GetImageResult = {
+  /* Attributs HTML supplémentaires nécessaires au rendu de l'image (largeur, hauteur, style, etc.) */
+  attributes: Record<string, any>;
+  /* Paramètres passés validés */
+  options: ImageTransform;
+  /* Paramètres d'origine transmis */
+  rawOptions: ImageTransform;
+  /* Chemin d'accès à l'image générée */
+  src: string;
+  srcSet: {
+    /* Valeurs générées pour srcset, chaque entrée a une URL et un descripteur de taille */
+    values: SrcSetValue[];
+    /* Une valeur prête à être utilisée dans l'attribut `srcset` */
+    attribute: string;
+  };
+}
+```

From b32bde03a510fed4f3c055db9697ce3c2954bc11 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Mon, 28 Oct 2024 13:46:06 +0100
Subject: [PATCH 33/43] i18n(fr): update
 `actions-returned-invalid-data-error.mdx` (#9832)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 .../fr/reference/errors/actions-returned-invalid-data-error.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/fr/reference/errors/actions-returned-invalid-data-error.mdx b/src/content/docs/fr/reference/errors/actions-returned-invalid-data-error.mdx
index ea4bb9f5df695..c9c55fa73bd29 100644
--- a/src/content/docs/fr/reference/errors/actions-returned-invalid-data-error.mdx
+++ b/src/content/docs/fr/reference/errors/actions-returned-invalid-data-error.mdx
@@ -10,4 +10,4 @@ githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/
 Le gestionnaire d'actions a renvoyé des données non valides. Les gestionnaires doivent renvoyer des types de données sérialisables et ne peuvent pas renvoyer un objet Response.
 
 **Voir aussi :**
--  [Propriété `handler` dans la référence d'Actions](/fr/reference/api-reference/#propriété-handler)
+-  [Propriété `handler` dans la référence d'Actions](/fr/reference/modules/astro-actions/#propriété-handler)

From 5ea394d2958962135b07246e1e7f061a8aea6789 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Mon, 28 Oct 2024 13:55:43 +0100
Subject: [PATCH 34/43] i18n(fr): update
 `tutorials/add-content-collections.mdx` (#9831)

See #9687

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 src/content/docs/fr/tutorials/add-content-collections.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/fr/tutorials/add-content-collections.mdx b/src/content/docs/fr/tutorials/add-content-collections.mdx
index 63f89816b5394..3c3c0b437c9ef 100644
--- a/src/content/docs/fr/tutorials/add-content-collections.mdx
+++ b/src/content/docs/fr/tutorials/add-content-collections.mdx
@@ -246,7 +246,7 @@ Les étapes ci-dessous vous montrent comment étendre le produit final du tutori
 ### Remplacer `Astro.glob()` avec `getCollection()`
 
 <Steps>
-11. Partout où vous avez une liste d'articles de blog, comme la page Blog du tutoriel (`src/pages/blog.astro/`), vous devrez remplacer `Astro.glob()` par [`getCollection()`](/fr/reference/api-reference/#getcollection) comme moyen d'extraire le contenu et les métadonnées de vos fichiers Markdown.
+11. Partout où vous avez une liste d'articles de blog, comme la page Blog du tutoriel (`src/pages/blog.astro/`), vous devrez remplacer `Astro.glob()` par [`getCollection()`](/fr/reference/modules/astro-content/#getcollection) comme moyen d'extraire le contenu et les métadonnées de vos fichiers Markdown.
 
     ```astro title="src/pages/blog.astro" "post.data" "getCollection(\"posts\")" "/posts/${post.slug}/" del={7} ins={2,8}
     ---

From 62896be0e8b5235a006248466fa9cb561a0fdf50 Mon Sep 17 00:00:00 2001
From: Shinya Fujino <shf0811@gmail.com>
Date: Mon, 28 Oct 2024 22:04:52 +0900
Subject: [PATCH 35/43] i18n(ja): Update middleware.mdx (#9841)

* 0bad0edf9ee997a9be8ff4a4af3e4107a498a3e1

* 9052ff706e0b2eb6cfb1a2971fa53b05ebdd4156

* 58b9ed8bed27bd2f9e5decb9e4c3617f078d8b37

* 7cddce039c243322429462bf39f2599828ca6a26

* a47e02d6329e2ac5523ff5fa5098f031b8d7982a

* a4fee213c6c5add423d089db2616bf57e6595f0a

* Update src/content/docs/ja/guides/middleware.mdx

Co-authored-by: ryu <114303361+ryuapp@users.noreply.github.com>

---------

Co-authored-by: ryu <114303361+ryuapp@users.noreply.github.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 src/content/docs/ja/guides/middleware.mdx | 84 +++++++++++++++++++++--
 1 file changed, 77 insertions(+), 7 deletions(-)

diff --git a/src/content/docs/ja/guides/middleware.mdx b/src/content/docs/ja/guides/middleware.mdx
index d117b4d66bd55..1c187d5314115 100644
--- a/src/content/docs/ja/guides/middleware.mdx
+++ b/src/content/docs/ja/guides/middleware.mdx
@@ -4,22 +4,25 @@ description: Astroでのミドルウェアの使い方を学びます。
 i18nReady: true
 ---
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
+import { Steps } from '@astrojs/starlight/components';
+import Since from '~/components/Since.astro';
 
-**ミドルウェア**により、リクエストとレスポンスをインターセプトし、ページやエンドポイントがレンダリングされる直前に動的に振る舞いを注入できます。こうしたレンダリングは、ページが事前レンダリングされる場合にはビルド時におこなわれますが、オンデマンドにレンダリングされるページの場合は、ルートへのリクエスト時におこなわれます。
+**ミドルウェア**により、リクエストとレスポンスをインターセプトし、ページやエンドポイントがレンダリングされる直前に動的に振る舞いを注入できます。こうしたレンダリングは、ページが事前レンダリングされる場合にはビルド時におこなわれますが、オンデマンドにレンダリングされるページの場合はルートへのリクエスト時におこなわれ、[クッキーやヘッダーなどの追加のSSR機能](/ja/guides/server-side-rendering/#オンデマンドレンダリングの機能)が利用できます。
 
 また、ミドルウェアを使って、すべてのAstroコンポーネントとAPIエンドポイントで利用可能な`locals`オブジェクトを変更し、リクエスト固有の情報を各エンドポイントとページで設定・共有することもできます。このオブジェクトは、このミドルウェアがビルド時に実行される場合でも利用できます。
 
 ## 基本的な使い方
 
+<Steps>
 1. `src/middleware.js|ts` というファイルを作成します。（あるいは、`src/middleware/index.js|ts` を作成しても構いません。）
 
 2. このファイルの中で、[`context`オブジェクト](#contextオブジェクト)と`next()`関数を受け取る[`onRequest()`](/ja/reference/modules/astro-middleware/#onrequest)関数をエクスポートします。これをデフォルトエクスポートにしてはいけません。
 
     ```js title="src/middleware.js"
-    export function onRequest ({ locals, request }, next) {
+    export function onRequest (context, next) {
         // リクエストからデータをインターセプトします
         // 必要に応じて、`locals`内のプロパティを改変します
-        locals.title = "新しいタイトル";
+        context.locals.title = "新しいタイトル";
 
         // Responseか`next()`の結果を返します
         return next();
@@ -35,6 +38,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
     <h1>{data.title}</h1>
     <p>この{data.property}はミドルウェアで設定しました。</p>
     ```
+</Steps>
 
 ### `context`オブジェクト
 
@@ -55,11 +59,11 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
 `locals`には、文字列、数値、さらには関数やマップといった複雑なデータ型など、どんな型のデータでも格納できます。
 
 ```js title="src/middleware.js"
-export function onRequest ({ locals, request }, next) {
+export function onRequest (context, next) {
     // リクエストからデータをインターセプトします
     // 必要に応じて、`locals`内のプロパティを改変します
-    locals.user.name = "John Wick";
-    locals.welcomeTitle = () => {
+    context.locals.user.name = "John Wick";
+    context.locals.welcomeTitle = () => {
         return "おかえりなさい " + locals.user.name;
     };
 
@@ -137,7 +141,8 @@ export const onRequest = (context, next) => {
 `Astro.locals`内の情報に型を付け、`.astro`ファイルとミドルウェアの両コードで自動補完を有効化するには、`env.d.ts`ファイルでグローバル名前空間を宣言します。
 
 ```ts title="src/env.d.ts"
-/// <reference types="astro/client" />
+/// <reference path="../.astro/types.d.ts" />
+
 declare namespace App {
     interface Locals {
         user: {
@@ -193,6 +198,71 @@ authレスポンス
 validationレスポンス
 ```
 
+## リライト
+
+<p><Since v="4.13.0" /></p>
+
+{/* TODO: routing.mdx の修正時に #rewrites を追加する */}
+`APIContext`は、[Astro.rewrite](/ja/guides/routing/)と同じように動作する`rewrite()`メソッドを公開しています。
+
+ページ閲覧者を新しいページにリダイレクトすることなく異なるページコンテンツを表示するには、ミドルウェア内で`context.rewrite()`を使用します。これにより新しいレンダリングフェーズがトリガーされ、ミドルウェアが再実行されます。
+```js title="src/middleware.js"
+import { isLoggedIn } from "~/auth.js"
+export function onRequest (context, next) {
+  if (!isLoggedIn(context)) {
+    // ユーザーがログインしていない場合、`/login`ルートをレンダリングするようにRequestを更新し、
+    // ログイン成功後にユーザーをどこに送り返すかを示すヘッダーを追加します。
+    // ミドルウェアは再実行されます。
+    return context.rewrite(new Request("/login", {
+      headers: {
+        "x-redirect-to": context.url.pathname
+      }
+    }));
+  }
+  return next();
+};
+```
+また、`next()`関数にオプションのURLパスパラメータを渡すことで、新しいレンダリングフェーズを再トリガーすることなく、現在の`Request`を書き換えることができます。リライト先のパスは、文字列、URL、または`Request`として与えます。
+```js title="src/middleware.js"
+import { isLoggedIn } from "~/auth.js"
+export function onRequest (context, next) {
+  if (!isLoggedIn(context)) {
+    // ユーザーがログインしていない場合、`/login`ルートをレンダリングするようにRequestを更新し、
+    // ログイン成功後にユーザーをどこに送り返すかを示すヘッダーを追加します。
+    // 後続のミドルウェアに新しい`context`を返します。
+    return next(new Request("/login", {
+      headers: {
+        "x-redirect-to": context.url.pathname
+      }
+    }));
+  }
+  return next();
+};
+```
+`next()`関数には、[Astro.rewrite()関数](/ja/reference/api-reference/#astrorewrite)と同じペイロードを渡せます。リライト先のパスは、文字列、URL、または`Request`として与えます。[sequence()](#ミドルウェアを連結する)により複数のミドルウェア関数を連結している場合、`next()`にパスを渡すと`Request`はその場で書き換えられ、ミドルウェアは再実行されません。チェーン内の次のミドルウェア関数は、更新された`context`をもつ新しい`Request`を受け取ります。
+```js title="src/middleware.js"
+// 現在のURLは https://example.com/blog です
+
+// 最初のミドルウェア関数
+async function first(_, next) {
+  console.log(context.url.pathname) // これは"/blog"をログに出力します
+  // 新しいルートであるホームページにリライトします
+  // 次の関数に渡される、更新された`context`を返します
+  return next("/")
+}
+
+// 現在のURLはまだ https://example.com/blog です
+
+// 2番目のミドルウェア関数
+async function second(context, next) {
+  // 更新された`context`を受け取ります
+  console.log(context.url.pathname) // これは"/"をログに出力します
+  return next()
+}
+
+export const onRequest = sequence(first, second);
+```
+
 ## エラーページ
 
 ミドルウェアは、オンデマンドレンダリングされるすべてのページに対して実行を試みます。これにはAstroのデフォルト（空白）の404ページや、カスタムの404ページが含まれます。ただし、そのコードが実行されるかどうかは[アダプター](/ja/guides/server-side-rendering/)によって決定されます。一部のアダプターは、プラットフォーム固有のエラーページを代わりに提供する場合があります。

From e86c8cd782dbfaf476c16e6e31f7631d5f76e5e7 Mon Sep 17 00:00:00 2001
From: Nin3 <30520689+Nin3lee@users.noreply.github.com>
Date: Tue, 29 Oct 2024 11:14:14 +0800
Subject: [PATCH 36/43] i18n(zh-cn): Update `nav.ts` (#9862)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* i18n(zh-cn): Update `nav.ts`

* `API 参考` => `Astro API 参考`
---
 src/i18n/zh-cn/nav.ts | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/src/i18n/zh-cn/nav.ts b/src/i18n/zh-cn/nav.ts
index a9f2d82f16386..af0f54321cf7f 100644
--- a/src/i18n/zh-cn/nav.ts
+++ b/src/i18n/zh-cn/nav.ts
@@ -61,14 +61,26 @@ export default NavDictionary({
 	'guides/testing': '测试',
 	'guides/troubleshooting': '故障排除',
 
+	communityResources: '社区资源',
+	'community-resources/content': '课程、指南和方案',
+	'community-resources/talks': '演讲、访谈和直播',
+	
 	reference: '参考',
 	'reference/configuration-reference': '配置',
-	'reference/api-reference': 'Astro 运行时 API',
 	'reference/cli-reference': 'Astro 命令行',
 	'reference/directives-reference': '指令参考',
 	'reference/components-reference': '内置组件',
 	'guides/typescript': 'TypeScript 参考',
 	'reference/error-reference': '错误参考',
+	
+	'api-reference': 'Astro API 参考',
+	'reference/api-reference': 'Astro 运行时 API',
+	'reference/modules/astro-actions': 'astro:actions',
+	'reference/modules/astro-assets': 'astro:assets',
+	'reference/modules/astro-content': 'astro:content',
+	'reference/modules/astro-i18n': 'astro:i18n',
+	'reference/modules/astro-middleware': 'astro:middleware',
+	'reference/modules/astro-transitions': 'astro:transitions',
 
 	dev: '其他开发 API',
 	'reference/integrations-reference': '集成 API',
@@ -76,8 +88,4 @@ export default NavDictionary({
 	'reference/image-service-reference': '图像服务 API',
 	'reference/dev-toolbar-app-reference': '开发工具栏应用 API',
 	'reference/container-reference': '容器 API（实验性）',
-
-	communityResources: '社区资源',
-	'community-resources/content': '课程、指南和方案',
-	'community-resources/talks': '演讲、访谈和直播',
 });

From 8276ec8a5582f09f17f73e6f9eca5ceeff670a8e Mon Sep 17 00:00:00 2001
From: liruifengv <liruifengv@users.noreply.github.com>
Date: Tue, 29 Oct 2024 03:14:55 +0000
Subject: [PATCH 37/43] [ci] format

---
 src/i18n/zh-cn/nav.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/i18n/zh-cn/nav.ts b/src/i18n/zh-cn/nav.ts
index af0f54321cf7f..4201d0acef16e 100644
--- a/src/i18n/zh-cn/nav.ts
+++ b/src/i18n/zh-cn/nav.ts
@@ -64,7 +64,7 @@ export default NavDictionary({
 	communityResources: '社区资源',
 	'community-resources/content': '课程、指南和方案',
 	'community-resources/talks': '演讲、访谈和直播',
-	
+
 	reference: '参考',
 	'reference/configuration-reference': '配置',
 	'reference/cli-reference': 'Astro 命令行',
@@ -72,7 +72,7 @@ export default NavDictionary({
 	'reference/components-reference': '内置组件',
 	'guides/typescript': 'TypeScript 参考',
 	'reference/error-reference': '错误参考',
-	
+
 	'api-reference': 'Astro API 参考',
 	'reference/api-reference': 'Astro 运行时 API',
 	'reference/modules/astro-actions': 'astro:actions',

From ec0f6ba2dae3a0414aea97a2d61e9ca7e93bbd05 Mon Sep 17 00:00:00 2001
From: viniciusdeliz <vinicius.deliz@gmail.com>
Date: Tue, 29 Oct 2024 02:35:29 -0300
Subject: [PATCH 38/43] i18n(pt-BR): update link in `fleek.mdx` (#9861)

Co-authored-by: liruifengv <liruifeng1024@gmail.com>
---
 src/content/docs/pt-br/guides/deploy/fleek.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/pt-br/guides/deploy/fleek.mdx b/src/content/docs/pt-br/guides/deploy/fleek.mdx
index 8cd651b5646ee..620647fe10190 100644
--- a/src/content/docs/pt-br/guides/deploy/fleek.mdx
+++ b/src/content/docs/pt-br/guides/deploy/fleek.mdx
@@ -75,4 +75,4 @@ Você pode publicar na Fleek através da interface do website ou usando a CLI Fl
 ## Saiba mais
 
 <ReadMore>[Publique um site pela interface Fleek](https://fleek.xyz/docs/platform/deployments/)</ReadMore>
-<ReadMore>[Publique um site pela CLI Fleek](https://fleek.xyz/docs/cli/sites/)</ReadMore>
+<ReadMore>[Publique um site pela CLI Fleek](https://fleek.xyz/docs/cli/hosting/)</ReadMore>

From 754cbb6107dbf0ae2af10fe8ca4c841e8d3896ff Mon Sep 17 00:00:00 2001
From: Sarah Rainsberger <sarah@rainsberger.ca>
Date: Tue, 29 Oct 2024 12:51:24 -0300
Subject: [PATCH 39/43] reorg of images and assets guide and reference content
 (#9801)

@lunaria-track:src/content/docs/en/**/*.mdx

Co-authored-by: Fryuni <11063910+Fryuni@users.noreply.github.com>
Co-authored-by: ArmandPhilippot <59021693+ArmandPhilippot@users.noreply.github.com>
Co-authored-by: at-the-vr <88548999+at-the-vr@users.noreply.github.com>
Co-authored-by: delucis <357379+delucis@users.noreply.github.com>
---
 src/content/docs/en/guides/images.mdx         | 447 ++++--------------
 .../guides/migrate-to-astro/from-gatsby.mdx   |   4 +-
 .../guides/migrate-to-astro/from-nextjs.mdx   |   4 +-
 .../guides/migrate-to-astro/from-nuxtjs.mdx   |   4 +-
 src/content/docs/en/guides/upgrade-to/v3.mdx  |   2 +-
 .../en/reference/components-reference.mdx     | 131 +----
 .../en/reference/errors/image-missing-alt.mdx |   4 +-
 .../errors/missing-image-dimension.mdx        |   4 +-
 .../en/reference/errors/missing-sharp.mdx     |   1 -
 .../en/reference/modules/astro-assets.mdx     | 300 +++++++++++-
 .../docs/ru/reference/api-reference.mdx       |   4 -
 .../ru/reference/errors/image-missing-alt.mdx |   4 +-
 .../errors/missing-image-dimension.mdx        |   4 +-
 .../ru/reference/errors/missing-sharp.mdx     |   1 -
 14 files changed, 391 insertions(+), 523 deletions(-)

diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx
index 7b1b0da800199..a126d37c82164 100644
--- a/src/content/docs/en/guides/images.mdx
+++ b/src/content/docs/en/guides/images.mdx
@@ -7,9 +7,12 @@ import Since from '~/components/Since.astro';
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
 import RecipeLinks from "~/components/RecipeLinks.astro";
 import { Steps } from '@astrojs/starlight/components'
+import ReadMore from '~/components/ReadMore.astro';
 
 Astro provides several ways for you to use images on your site, whether they are stored locally inside your project, linked to from an external URL, or managed in a CMS or CDN!
 
+<ReadMore>See the full API reference for the [`<Image />`](/en/reference/modules/astro-assets/#image-) and [`<Picture />`](/en/reference/modules/astro-assets/#picture-) components.</ReadMore>
+
 ## Where to store images
 
 ### `src/` vs `public/`
@@ -22,18 +25,18 @@ Store your images in the `public/` folder if you want to avoid any processing or
 
 ### Remote images
 
-You can also choose to store your images remotely, in a content management system (CMS) or digital asset management (DAM) platform.
-
-For extra protection when dealing with external sources, remote images will only be processed from [authorized image sources](#authorizing-remote-images) specified in your configuration. However, any remote images can be displayed.
-
-Astro can fetch your data remotely using APIs or display images from their full URL path. See our [CMS guides](/en/guides/cms/) for examples of integrating common services.
+You can also choose to store your images remotely, in a [content management system (CMS)](/en/guides/cms/) or [digital asset management (DAM)](/en/guides/media/) platform.
+Astro can fetch your data remotely using APIs or display images from their full URL path.
 
+ For extra protection when dealing with external sources, Astro's image components and helper function will only process (e.g. optimize, transform) images from [authorized image sources specified in your configuration](#authorizing-remote-images). Remote images from other sources will be displayed with no processing.
 
 ## Images in `.astro` files
 
-In `.astro` files, **local images must be imported into the file in order to be used**. Remote and `public/` images do not require importing.
+In `.astro` files, a local image must be imported from its relative path. This import provides the `src` value for your image.
+
+Remote and `public/` images do not require importing, and instead require a URL (full, or relative path on your site) for `src`.
 
-Import and use Astro's built-in `<Image />` component for optimized images using `astro:assets`. Alternatively, Astro syntax supports writing an HTML `<img>` tag directly, which skips image processing.
+Import and use Astro's native [`<Image />`](#display-optimized-images-with-the-image--component) and [`<Picture />`](#create-responsive-images-with-the-picture--component) components for optimized images. Astro syntax also supports [writing an HTML `<img>` tag directly](#display-unprocessed-images-with-the-html-img-tag), which skips image processing.
 
 ```astro title="src/pages/blog/my-images.astro"
 ---
@@ -49,20 +52,21 @@ import localBirdImage from '../../images/subfolder/localBirdImage.png';
 <img src="https://example.com/remote-bird.jpg" alt="A bird.">
 ```
 
-To dynamically import images from the `src/` folder, see the following recipe:
+<ReadMore>See the full API reference for the [`<Image />`](/en/reference/modules/astro-assets/#image-) and [`<Picture />`](/en/reference/modules/astro-assets/#picture-) components.</ReadMore>
 
 <RecipeLinks slugs={["en/recipes/dynamically-importing-images" ]}/>
 
-### `<Image />` (`astro:assets`)
+### Display optimized images with the `<Image />` component
 
-Use the built-in `<Image />` Astro component to display optimized versions of your local images and [configured remote images](#authorizing-remote-images).
+Use the built-in `<Image />` Astro component to display optimized versions of:
 
-Images in the `public/` folder, as well as remote images not specifically configured in your project, can also be used with the Image component, but will not be processed.
+- your local images located within the `src/` folder
+- [configured remote images](#authorizing-remote-images) from authorized sources
 
-`<Image />` can transform a local or authorized remote image's dimensions, file type, and quality for control over your displayed image. The resulting `<img>` tag includes `alt`, `loading`, and `decoding` attributes and infers image dimensions to avoid **Cumulative Layout Shift (CLS)**.
+`<Image />` can transform a local or authorized remote image's dimensions, file type, and quality for control over your displayed image. The resulting `<img>` tag includes `alt`, `loading`, and `decoding` attributes and infers image dimensions to avoid Cumulative Layout Shift (CLS).
 
-:::tip[What is Cumulative Layout Shift?]
-[Cumulative Layout Shift (CLS)](https://web.dev/cls/) is a Core Web Vital metric for measuring how much content shifted on your page during loading. The `<Image />` component optimizes for CLS by automatically setting the correct `width` and `height` for your local images.
+:::note[What is Cumulative Layout Shift?]
+[Cumulative Layout Shift (CLS)](https://web.dev/cls/) is a Core Web Vital metric for measuring how much content shifted on your page during loading. The `<Image />` component optimizes for CLS by automatically setting the correct `width` and `height` for your images.
 :::
 
 ```astro title="src/components/MyComponent.astro"
@@ -89,201 +93,11 @@ import myImage from '../assets/my_image.png'; // Image is 1600x900
 />
 ```
 
-#### Properties
-
-##### src (required)
-
-The format of the `src` value of your image file depends on where your image file is located:
-
-- **Local images in `src/`** - you must **also import the image** using a relative file path or configure and use an [import alias](/en/guides/imports/#aliases). Then use the import name as the `src` value:
-
-  ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
-  ---
-  import { Image } from 'astro:assets';
-  import myImportedImage from '../assets/my-local-image.png';
-  ---
-  <Image src={myImportedImage} alt="descriptive text" />
-  ```
-
-- **Images in the `public/` folder** -  use the image's **file path relative to the public folder**:
-
-  ```astro title="src/pages/index.astro" '"/images/my-public-image.png"'
-  ---
-  import { Image } from 'astro:assets';
-  ---
-  <Image
-    src="/images/my-public-image.png"
-    alt="descriptive text"
-    width="200"
-    height="150"
-  />
-  ```
-
-- **Remote images** - use the image's **full URL** as the property value:
-
-  ```astro title="src/pages/index.astro" '"https://example.com/remote-image.jpg"'
-  ---
-  import { Image } from 'astro:assets';
-  ---
-  <Image
-    src="https://example.com/remote-image.jpg"
-    alt="descriptive text"
-    width="200"
-    height="150"
-  />
-  ```
-
-##### alt (required)
-
-Use the required `alt` attribute to provide a string of [descriptive alt text](https://www.w3.org/WAI/tutorials/images/) for images.
-
-If an image is merely decorative (i.e. doesn't contribute to the understanding of the page), set `alt=""` so that screen readers and other assistive technologies know to ignore the image.
+The `<Image />` component accepts [several component properties](/en/reference/modules/astro-assets/#image-properties) as well as any attributes accepted by the HTML `<img>` tag.
 
-##### width and height (required for images in `public/`)
+The following example provides a `class` to the image component which will apply to the final `<img>` element.
 
-These properties define the dimensions to use for the image.
-
-When using images in their original aspect ratio, `width` and `height` are optional. These dimensions can be automatically inferred from image files located in `src/`. For remote images, add [the `inferSize` attribute set to `true`](#infersize) on the `<Image />` or `<Picture />` component or use [`inferRemoteSize()` function](#inferremotesize).
-
-However, both of these properties are required for images stored in your `public/` folder as Astro is unable to analyze these files.
-
-##### densities
-
-<p><Since v="3.3.0" /></p>
-
-A list of pixel densities to generate for the image.
-
-If provided, this value will be used to generate a `srcset` attribute on the `<img>` tag. Do not provide a value for `widths` when using this value.
-
-Densities that are equal to widths larger than the original image will be ignored to avoid upscaling the image.
-
-```astro title="src/components/MyComponent.astro"
----
-import { Image } from 'astro:assets';
-import myImage from '../assets/my_image.png';
----
-<Image
-  src={myImage}
-  width={myImage.width / 2}
-  densities={[1.5, 2]}
-  alt="A description of my image."
-/>
-```
-
-```html
-<!-- Output -->
-<img
-  src="/_astro/my_image.hash.webp"
-  srcset="
-    /_astro/my_image.hash.webp 1.5x
-    /_astro/my_image.hash.webp 2x
-  "
-  alt="A description of my image."
-  width="800"
-  height="450"
-  loading="lazy"
-  decoding="async"
-/>
-```
-
-##### widths
-
-<p><Since v="3.3.0" /></p>
-
-A list of widths to generate for the image.
-
-If provided, this value will be used to generate a `srcset` attribute on the `<img>` tag. A [`sizes` property](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/sizes) must also be provided.
-
-Do not provide a value for `densities` when using this value. Only one of these two values can be used to generate a `srcset`.
-
-Widths that are larger than the original image will be ignored to avoid upscaling the image.
-
-```astro
----
-import { Image } from 'astro:assets';
-import myImage from '../assets/my_image.png'; // Image is 1600x900
----
-<Image
-  src={myImage}
-  widths={[240, 540, 720, myImage.width]}
-  sizes={`(max-width: 360px) 240px, (max-width: 720px) 540px, (max-width: 1600px) 720px, ${myImage.width}px`}
-  alt="A description of my image."
-/>
-```
-
-```html
-<!-- Output -->
-<img
-  src="/_astro/my_image.hash.webp"
-  srcset="
-    /_astro/my_image.hash.webp 240w,
-    /_astro/my_image.hash.webp 540w,
-    /_astro/my_image.hash.webp 720w,
-		/_astro/my_image.hash.webp 1600w
-  "
-  sizes="
-    (max-width: 360px) 240px,
-    (max-width: 720px) 540px,
-    (max-width: 1600px) 720px,
-    1600px
-  "
-  alt="A description of my image."
-  width="1600"
-  height="900"
-  loading="lazy"
-  decoding="async"
-/>
-```
-
-##### format
-
-You can optionally state the [image file type](https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types#common_image_file_types) output to be used.
-
-By default, the `<Image />` component will produce a `.webp` file.
-
-##### quality
-
-`quality` is an optional property that can either be:
-- a preset (`low`, `mid`, `high`, `max`) that is automatically normalized between formats.
-- a number from `0` to `100` (interpreted differently between formats).
-
-##### inferSize
-
-<p><Since v="4.4.0" /></p>
-
-Allows you to set the original `width` and `height` of a remote image automatically.
-
-By default, this value is set to `false` and you must manually specify both dimensions for your remote image.
-
-Add `inferSize` to the `<Image />` component (or `inferSize: true` to `getImage()`) to infer these values from the image content when fetched. This is helpful if you don't know the dimensions of the remote image, or if they might change:
-
-```astro mark="inferSize"
----
-import { Image } from 'astro:assets';
----
-<Image src="https://example.com/cat.png" inferSize alt="A cat sleeping in the sun." />
-```
-
-`inferSize` can fetch the dimensions of a [remote image from a domain that has not been authorized](#authorizing-remote-images), however the image itself will remain unprocessed.
-
-###### inferRemoteSize()
-
-<p><Since v="4.12.0" /></p>
-
-A function to infer the dimensions of remote images. This can be used as an alternative to passing the `inferSize` property.
-
-```ts
-import { inferRemoteSize } from 'astro:assets';
-const {width, height} = await inferRemoteSize("https://example.com/cat.png");
-```
-
-##### Additional properties
-
-In addition to the properties above, the `<Image />` component accepts all properties accepted by the HTML `<img>` tag.
-
-For example, you can provide a `class` to the final `<img>` element.
-
-```astro title="src/pages/index.astro"
+```astro title="src/pages/index.astro" 'class="my-class"'
 ---
 import { Image } from 'astro:assets';
 import myImage from '../assets/my_image.png';
@@ -293,7 +107,7 @@ import myImage from '../assets/my_image.png';
 <Image src={myImage} alt="" class="my-class" />
 ```
 
-```html
+```html 'class="my-class"'
 <!-- Output -->
 <img
   src="/_astro/my_image.hash.webp"
@@ -306,33 +120,16 @@ import myImage from '../assets/my_image.png';
 />
 ```
 
-#### Setting Default Values
-
-Currently, there is no way to specify default values for all `<Image />` components. Required attributes should be set on each individual component.
-
-As an alternative, you can wrap these components in another Astro component for reuse. For example, you could create a component for your blog post images:
-
-```astro title="src/components/BlogPostImage.astro"
----
-import { Image } from 'astro:assets';
-
-const { src, ...attrs } = Astro.props;
----
-<Image src={src} {...attrs} />
-
-<style>
-  img :global(img), svg {
-    margin-block: 2.5rem;
-    border-radius: 0.75rem;
-  }
-</style>
-```
+:::tip
+You can also use the `<Image />` component for images in the `public/` folder, or remote images not specifically configured in your project, even though these images will not be optimized or processed. The resulting image will be the same as using the HTML `<img>`.
 
-### `<Picture />`
+However, using the image component for all images provides a consistent authoring experience and prevents Cumulative Layout Shift (CLS) even for your unoptimized images.
+:::
+### Create responsive images with the `<Picture />` component
 
 <p><Since v="3.3.0" /></p>
 
-Use the built-in `<Picture />` Astro component to display a responsive image with multiple formats and/or sizes.
+Use the built-in `<Picture />` Astro component to display a responsive image with multiple formats and/or sizes. 
 
 ```astro title="src/pages/index.astro"
 ---
@@ -360,65 +157,27 @@ import myImage from '../assets/my_image.png'; // Image is 1600x900
 </picture>
 ```
 
-#### Properties
+<ReadMore>See details about [the `<Picture />` component properties](/en/reference/modules/astro-assets/#picture-properties) in the `astro:assets` reference.</ReadMore>
 
-`<Picture />` accepts all the properties of the `<Image />` component, plus the following:
 
-##### `formats`
+### Display unprocessed images with the HTML `<img>` tag
 
-An array of image formats to use for the `<source>` tags. Entries will be added as `<source>` elements in the order they are listed, and this order determines which format is displayed. For the best performance, list the most modern format first (e.g. `webp` or `avif`). By default, this is set to `['webp']`.
+The [Astro template syntax](/en/basics/astro-syntax/) also supports writing an `<img>` tag directly, with full control over its final output. These images will not be processed and optimized. It accepts all HTML `<img>` tag properties, and the only required property is `src`.
 
-##### `fallbackFormat`
+Local images must be imported from the relative path from the existing `.astro` file, or you can configure and use an [import alias](/en/guides/imports/#aliases). Then, you can access the image's `src` and other properties to use in the `<img>` tag.
 
-Format to use as a fallback value for the `<img>` tag.
-
-Defaults to `.png` for static images (or `.jpg` if the image is a JPG), `.gif` for animated images, and `.svg` for SVG files.
-
-##### `pictureAttributes`
-
-An object of attributes to be added to the `<picture>` tag. 
-
-Use this property to apply attributes to the outer `<picture>` element itself. Attributes applied to the `<Picture />` component directly will apply to the inner `<img>` element, except for those used for image transformation.
-
-```astro title="src/components/MyComponent.astro"
----
-import { Picture } from "astro:assets";
-import myImage from "../my_image.png"; // Image is 1600x900
----
-
-<Picture
-  src={myImage}
-  alt="A description of my image."
-  pictureAttributes={{ style: "background-color: red;" }}
-/>
-```
+Imported image assets match the following signature:
 
-```html
-<!-- Output -->
-<picture style="background-color: red;">
-  <source srcset="/_astro/my_image.hash.webp" type="image/webp" />
-  <img
-    src="/_astro/my_image.hash.png"
-    alt="A description of my image."
-    width="1600"
-    height="900"
-    loading="lazy"
-    decoding="async"
-  />
-</picture>
+```ts
+interface ImageMetadata {
+  src: string;
+  width: number;
+  height: number;
+  format: string;
+}
 ```
 
-### `<img>`
-
-The [Astro template syntax](/en/basics/astro-syntax/) also supports writing an `<img>` tag directly, with full control over its final output. These images will not be processed and optimized.
-
-It accepts all HTML `<img>` tag properties, and the only required property is `src`.
-
-#### Local images in `src/`
-
-Local images must be **imported from the relative path** from the existing `.astro` file, or configure and use an [import alias](/en/guides/imports/#aliases). Then, you can access the image's `src` and other properties to use in the `<img>` tag.
-
-For example, use the image's own `height` and `width` properties to avoid CLS and improve Core Web Vitals.
+The following example uses the image's own `height` and `width` properties to avoid Cumulative Layout Shift (CLS) and improve Core Web Vitals:
 
 ```astro title="src/pages/posts/post-1.astro" "myDog.width" "myDog.height"
 ---
@@ -429,19 +188,8 @@ import myDog from '../../images/pets/local-dog.jpg';
 <img src={myDog.src} width={myDog.width} height={myDog.height} alt="A barking dog." />
 ```
 
-Imported image assets match the following signature:
-
-```ts
-interface ImageMetadata {
-  src: string;
-  width: number;
-  height: number;
-  format: string;
-}
-```
-
 #### Images in `public/`
-For images located within `public/` use the image's **file path relative to the public folder** as the `src` value:
+For images located within `public/` use the image's file path relative to the public folder as the `src` value:
 
 ```astro '"/images/public-cat.jpg"'
 <img src="/images/public-cat.jpg" alt="A sleeping cat." >
@@ -449,7 +197,7 @@ For images located within `public/` use the image's **file path relative to the
 
 #### Remote images
 
-For remote images, use the image's **full URL** as the `src` value:
+For remote images, use the image's full URL as the `src` value:
 
 ```astro '"https://example.com/remote-cat.jpg"'
 <img src="https://example.com/remote-cat.jpg" alt="A sleeping cat." >
@@ -457,13 +205,34 @@ For remote images, use the image's **full URL** as the `src` value:
 
 ### Choosing `<Image />` vs `<img>`
 
-The `<Image />` component optimizes your image and infers width and height (of local images) based on the original aspect ratio to avoid CLS.
+The `<Image />` component optimizes your image and infers width and height (for images it can process) based on the original aspect ratio to avoid CLS. It is the preferred way to use images in `.astro` files whenever possible.
 
 Use the HTML `<img>` element when you cannot use the `<Image />` component, for example:
   - for unsupported image formats
   - when you do not want your image optimized by Astro
   - to access and change the `src` attribute dynamically client-side
 
+### Setting Default Values
+
+Currently, there is no way to specify default values for all `<Image />`  or `<Picture/>` components. Required attributes should be set on each individual component.
+
+As an alternative, you can wrap these components in another Astro component for reuse. For example, you could create a component for your blog post images that receives attributes as props and applies consistent styles to each image:
+
+```astro title="src/components/BlogPostImage.astro"
+---
+import { Image } from 'astro:assets';
+
+const { src, ...attrs } = Astro.props;
+---
+<Image src={src} {...attrs} />
+
+<style>
+  img {
+    margin-block: 2.5rem;
+    border-radius: 0.75rem;
+  }
+</style>
+```
 
 ### Authorizing remote images
 
@@ -495,10 +264,12 @@ export default defineConfig({
 
 ## Using Images from a CMS or CDN
 
-Image CDNs work with all Astro image options. Use an image's full URL as the `src` attribute in the `<Image />` component, an `<img>` tag, or in Markdown notation. For image optimization with remote images, also [configure your authorized domains or URL patterns](#authorizing-remote-images).
+Image CDNs work with [all Astro image options](#images-in-astro-files). Use an image's full URL as the `src` attribute in the `<Image />` component, an `<img>` tag, or in Markdown notation. For image optimization with remote images, also [configure your authorized domains or URL patterns](#authorizing-remote-images).
 
 Alternatively, the CDN may provide its own SDKs to more easily integrate in an Astro project. For example, Cloudinary supports an [Astro SDK](https://astro.cloudinary.dev/) which allows you to easily drop in images with their `CldImage` component or a [Node.js SDK](https://cloudinary.com/documentation/node_integration) that can generate URLs to use with an `<img>` tag in a Node.js environment.
 
+<ReadMore>See the full API reference for the [`<Image />`](/en/reference/modules/astro-assets/#image-) and [`<Picture />`](/en/reference/modules/astro-assets/#picture-) components.</ReadMore>
+
 ## Images in Markdown files
 
 Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax works with Astro's [Image Service API](/en/reference/image-service-reference/) to optimize your local images stored in `src/`. Remote images and images stored in the `public/` folder are not optimized.
@@ -521,13 +292,13 @@ Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax work
 ![Astro](https://example.com/images/remote-image.png)
 ```
 
-The `<img>` tag is not supported for local images,  and the `<Image />` component is unavailable in `.md` files.
+The `<img>` tag is not supported for local images, and the `<Image />` and `<Picture />` components are unavailable in `.md` files.
 
-If you require more control over your image attributes, we recommend using the `.mdx` file format, which allows you to include Astro's `<Image />` component or a JSX `<img />` tag in addition to the Markdown syntax. Use the [MDX integration](/en/guides/integrations-guide/mdx/) to add support for MDX to Astro.
+If you require more control over your image attributes, we recommend using [Astro's MDX integration](/en/guides/integrations-guide/mdx/) to add support for`.mdx` file format. MDX allows adding components to Markdown and there are additional [image options available in MDX](#images-in-mdx-files).
 
 ## Images in MDX files
 
-You can use Astro's `<Image />` component and JSX `<img />` tags in your `.mdx` files by importing both the component and your image. Use them just as they are [used in `.astro` files](#images-in-astro-files).
+You can use Astro's `<Image />` and `<Picture />` components in your `.mdx` files by importing both the component and your image. Use them just as they are [used in `.astro` files](#images-in-astro-files). The JSX `<img />` tag is also supported for unprocessed images and [uses the same image import as the HTML `<img>` tag](#display-unprocessed-images-with-the-html-img-tag).
 
 Additionally, there is support for [standard Markdown `![alt](src)` syntax](#images-in-markdown-files) with no import required.
 
@@ -560,6 +331,8 @@ import rocket from '../assets/rocket.png';
 
 ```
 
+<ReadMore>See the full API reference for the [`<Image />`](/en/reference/modules/astro-assets/#image-) and [`<Picture />`](/en/reference/modules/astro-assets/#picture-) components.</ReadMore>
+
 ## Images in content collections
 
 Images in content collections will be processed the same way they are in [Markdown](#images-in-markdown-files) and [MDX](#images-in-mdx-files) depending on which file type you are using.
@@ -621,9 +394,26 @@ const allBlogPosts = await getCollection("blog");
 
 ## Images in UI framework components
 
-When adding images in a UI framework component, use the framework's own image syntax to render an image (e.g. `<img />` in JSX, `<img>` in Svelte).
+The `<Image />` component, like any other Astro component, is unavailable inside UI framework components.
+
+But, you can pass the static content generated by `<Image />` to a framework component inside a `.astro` file as children or using a [named `<slot/>`](/en/guides/framework-components/#can-i-use-astro-components-inside-my-framework-components):
 
-Local images must **first be imported** to access their [image properties](#local-images-in-src) such as `src`.
+
+```astro title="src/components/ImageWrapper.astro"
+---
+import ReactComponent from './ReactComponent.jsx';
+import { Image } from 'astro:assets';
+import stars from '~/stars/docline.png';
+---
+
+<ReactComponent>
+  <Image src={stars} alt="A starry night sky." />
+</ReactComponent>
+```
+
+You can also use the framework's own image syntax to render an image (e.g. `<img />` in JSX, `<img>` in Svelte).
+
+[Local images must first be imported](#display-unprocessed-images-with-the-html-img-tag) to access their image properties such as `src`.
 
 ```jsx title="src/components/ReactImage.jsx"
 import stars from "../assets/stars.png";
@@ -644,63 +434,14 @@ export default function ReactImage() {
 
 ```
 
-#### Passing the Image component
-
-The `<Image />` component, like any other Astro component, **is unavailable to UI framework components**.
-
-But, you can pass the static content generated by `<Image />` to a framework component inside a `.astro` file as children or using a [named `<slot/>`](/en/guides/framework-components/#can-i-use-astro-components-inside-my-framework-components):
-
-
-```astro title="src/components/ImageWrapper.astro"
----
-import ReactComponent from './ReactComponent.jsx';
-import { Image } from 'astro:assets';
-import stars from '~/stars/docline.png';
----
-
-<ReactComponent>
-  <Image src={stars} alt="A starry night sky." />
-</ReactComponent>
-```
-
 ## Generating images with `getImage()`
 
-:::caution
-`getImage()` relies on server-only APIs and breaks the build when used on the client.
-:::
+The `getImage()` function is intended for generating images destined to be used somewhere else than directly in HTML, for example in an [API Route](/en/guides/endpoints/#server-endpoints-api-routes). When you need options that the `<Picture>` and `<Image>` components do not currently support, you can use the `getImage()` function to create your own custom `<Image />` component.
 
-The `getImage()` function is intended for generating images destined to be used somewhere else than directly in HTML, for example in an [API Route](/en/guides/endpoints/#server-endpoints-api-routes). It also allows you to create your own custom `<Image />` component.
+<ReadMore>See more in the [`getImage()` reference](/en/reference/modules/astro-assets/#getimage).</ReadMore>
 
 <RecipeLinks slugs={["en/recipes/build-custom-img-component" ]}/>
 
-`getImage()` takes an options object with the [same properties as the Image component](#properties) (except `alt`).
-
-```astro
----
-import { getImage } from "astro:assets";
-import myBackground from "../background.png";
-
-const optimizedBackground = await getImage({src: myBackground, format: 'webp'});
----
-
-<div style={`background-image: url(${optimizedBackground.src});`}></div>
-```
-
-It returns an object with the following properties:
-
-```js
-{
-  rawOptions: {...}, // Original parameters passed
-  options: {...}, // Validated parameters passed
-  src: "...", // Path to the generated image
-  srcSet: {
-    values: [...], // Generated values for srcset, every entry has a url and a size descriptor
-    attribute: "", // Generated srcset attribute from the values
-  }
-  attributes: {...} // Additional HTML attributes needed to render the image (width, height, style, etc..)
-}
-```
-
 ## Alt Text
 
 Not all users can see images in the same way, so accessibility is an especially important concern when using images. Use the `alt` attribute to provide [descriptive alt text](https://www.w3.org/WAI/tutorials/images/) for images.
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx b/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx
index dc49d20ef5b59..1bdff9eef0436 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-gatsby.mdx
@@ -320,7 +320,7 @@ See more about [Styling in Astro](/en/guides/styling/).
 
 ### Gatsby Image Plugin to Astro
 
-Convert Gatsby's `<StaticImage />` and `<GatsbyImage />` components to [Astro's own image integration components](/en/guides/images/#image--astroassets), or to a [standard HTML `<img>` / JSX `<img />`](/en/guides/images/#images-in-ui-framework-components) tag as appropriate in your React components.
+Convert Gatsby's `<StaticImage />` and `<GatsbyImage />` components to [Astro's own image integration components](/en/guides/images/), or to a [standard HTML `<img>` / JSX `<img />`](/en/guides/images/#images-in-ui-framework-components) tag as appropriate in your React components.
 
 ```astro title="src/pages/index.astro"
 ---
@@ -331,7 +331,7 @@ import rocket from '../assets/rocket.png';
 <img src={rocket.src} alt="A rocketship in space.">
 ```
 
-Astro's `<Image />` component works in `.astro` and `.mdx` files only. See a [full list of its component attributes](/en/guides/images/#properties) and note that several will differ from Gatsby's attributes.
+Astro's `<Image />` component works in `.astro` and `.mdx` files only. See a [full list of its component attributes](/en/reference/modules/astro-assets/#image-properties) and note that several will differ from Gatsby's attributes.
 
 To continue using [images in Markdown (`.md`) files](/en/guides/images/#images-in-markdown-files) using standard Markdown syntax (`![]()`), you may need to update the link. Using the HTML `<img>` tag directly is not supported in `.md` files for local images, and must be converted to Markdown syntax.
 
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx b/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx
index 8fb638762a952..d1a962804d74a 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-nextjs.mdx
@@ -422,9 +422,9 @@ See more about [Styling in Astro](/en/guides/styling/).
 
 ### Next Image Plugin to Astro
 
-Convert any Next `<Image />` components to [Astro's own image component](/en/guides/images/#image--astroassets) in `.astro` or `.mdx` files, or to a [standard HTML `<img>` / JSX `<img />`](/en/guides/images/#images-in-ui-framework-components) tag as appropriate in your React components. 
+Convert any Next `<Image />` components to [Astro's own image component](/en/guides/images/) in `.astro` or `.mdx` files, or to a [standard HTML `<img>` / JSX `<img />`](/en/guides/images/#images-in-ui-framework-components) tag as appropriate in your React components. 
 
-Astro's `<Image />` component works in `.astro` and `.mdx` files only. See a [full list of its component attributes](/en/guides/images/#properties) and note that several will differ from Next's attributes. 
+Astro's `<Image />` component works in `.astro` and `.mdx` files only. See a [full list of its component attributes](/en/reference/modules/astro-assets/#image-properties) and note that several will differ from Next's attributes. 
 
 ```astro title="src/pages/index.astro"
 ---
diff --git a/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx b/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx
index b1396a9e9d385..a399b433b6f23 100644
--- a/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx
+++ b/src/content/docs/en/guides/migrate-to-astro/from-nuxtjs.mdx
@@ -487,9 +487,9 @@ See more about [Styling in Astro](/en/guides/styling/).
 
 ### Nuxt Image Plugin to Astro
 
-Convert any [Nuxt `<nuxt-img/>` or `<nuxt-picture/>` components](https://image.nuxtjs.org/components/nuxt-img) to [Astro's own image component](/en/guides/images/#image--astroassets) in `.astro` or `.mdx` files, or to a [standard HTML `<img>`](/en/guides/images/#images-in-ui-framework-components) or `<picture>` tag as appropriate in your Vue components.
+Convert any [Nuxt `<nuxt-img/>` or `<nuxt-picture/>` components](https://image.nuxtjs.org/components/nuxt-img) to [Astro's own image component](/en/guides/images/) in `.astro` or `.mdx` files, or to a [standard HTML `<img>`](/en/guides/images/#images-in-ui-framework-components) or `<picture>` tag as appropriate in your Vue components.
 
-Astro's `<Image />` component works in `.astro` and `.mdx` files only. See a [full list of its component attributes](/en/guides/images/#properties) and note that several will differ from Nuxt's attributes. 
+Astro's `<Image />` component works in `.astro` and `.mdx` files only. See a [full list of its component attributes](/en/reference/modules/astro-assets/#image-properties) and note that several will differ from Nuxt's attributes. 
 
 ```astro title="src/pages/index.astro"
 ---
diff --git a/src/content/docs/en/guides/upgrade-to/v3.mdx b/src/content/docs/en/guides/upgrade-to/v3.mdx
index 55fe269426ead..a2eeda10821aa 100644
--- a/src/content/docs/en/guides/upgrade-to/v3.mdx
+++ b/src/content/docs/en/guides/upgrade-to/v3.mdx
@@ -827,7 +827,7 @@ If you were using the image integration in Astro v2.x, complete the following st
 
     Change all `import` statements from `@astrojs/image/components` to `astro:assets` in order to use the new built-in `<Image />` component.
 
-    Remove any component attributes that are not [currently supported image asset properties](/en/guides/images/#properties).
+    Remove any component attributes that are not [currently supported image asset properties](/en/reference/modules/astro-assets/#image-properties).
 
     For example, `aspectRatio` is no longer supported, as it is now automatically inferred from the `width` and `height` attributes.
 
diff --git a/src/content/docs/en/reference/components-reference.mdx b/src/content/docs/en/reference/components-reference.mdx
index 20fae00a095f9..7e3e2322cad51 100644
--- a/src/content/docs/en/reference/components-reference.mdx
+++ b/src/content/docs/en/reference/components-reference.mdx
@@ -115,136 +115,7 @@ import { Prism } from '@astrojs/prism';
 
 This component provides language-specific syntax highlighting for code blocks by applying Prism's CSS classes. Note that **you need to provide a Prism CSS stylesheet** (or bring your own) for syntax highlighting to appear! See the [Prism configuration section](/en/guides/markdown-content/#prism-configuration) for more details.
 
-See the [list of languages supported by Prism](https://prismjs.com/#supported-languages) where you can find a language’s corresponding alias. And, you can also display your Astro code blocks with `lang="astro"`!
-
-## `<Image />`
-
-```astro title="src/components/MyComponent.astro"
----
-// import the Image component and the image
-import { Image } from 'astro:assets';
-import myImage from "../assets/my_image.png"; // Image is 1600x900
----
-
-<!-- `alt` is mandatory on the Image component -->
-<Image src={myImage} alt="A description of my image." />
-```
-
-```html
-<!-- Output -->
-<!-- Image is optimized, proper attributes are enforced -->
-<img
-  src="/_astro/my_image.hash.webp"
-  width="1600"
-  height="900"
-  decoding="async"
-  loading="lazy"
-  alt="A description of my image."
-/>
-```
-### Properties
-
-- src (required)
-- alt (required)
-- width and height (required for `public/` and remote images)
-- format
-- quality
-- densities
-- widths
-
-In addition to the properties above, the `<Image />` component accepts all properties accepted by the HTML `<img>` tag.
-
-See more in the [Images Guide](/en/guides/images/#image--astroassets).
-
-## `<Picture />`
-
-<p><Since v="3.3.0" /></p>
-
-Use the built-in `<Picture />` Astro component to display a responsive image with multiple formats and/or sizes.
-
-```astro title="src/pages/index.astro"
----
-import { Picture } from 'astro:assets';
-import myImage from "../assets/my_image.png"; // Image is 1600x900
----
-
-<!-- `alt` is mandatory on the Picture component -->
-<Picture src={myImage} formats={['avif', 'webp']} alt="A description of my image." />
-```
-
-```html
-<!-- Output -->
-<picture>
-  <source srcset="/_astro/my_image.hash.avif" type="image/avif" />
-  <source srcset="/_astro/my_image.hash.webp" type="image/webp" />
-  <img
-    src="/_astro/my_image.hash.png"
-    width="1600"
-    height="900"
-    decoding="async"
-    loading="lazy"
-    alt="A description of my image."
-  />
-</picture>
-```
-
-See more in the [Images Guide](/en/guides/images/#picture-).
-
-### Properties
-
-`<Picture />` accepts all the properties of the `<Image />` component, plus the following:
-
-#### `formats`
-
-An array of image formats to use for the `<source>` tags. By default, this is set to `['webp']`.
-
-#### `fallbackFormat`
-
-Format to use as a fallback value for the `<img>` tag. Defaults to `.png` for static images, `.gif` for animated images, and `.svg` for SVG files.
-
-#### `pictureAttributes`
-
-An object of attributes to be added to the `<picture>` tag. Use this property to apply attributes to the outer `<picture>` element itself. Attributes applied to the `<Picture />` component directly will apply to the inner `<img>` element, except for those used for image transformation.
-
-
-## `<Content />`
-
-A generic component used to render the content of a [content collection entry](/en/guides/content-collections/#what-are-content-collections).
-
-First, query one or more entries using `getCollection()` or `getEntry()`. Then, the `entry.render()` function can return the `<Content />` component for use in a `.astro` file template.
-
-```astro title="src/pages/render-example.astro" {4, 7}
----
-import { getEntry } from 'astro:content';
-const entry = await getEntry('blog', 'post-1');
-const { Content } = await entry.render();
----
-<p>Published on: {entry.data.published.toDateString()}</p>
-<Content />
-```
-
-## `<ViewTransitions />`
-
-<p><Since v="2.9.0" /></p>
-
-Opt in to using view transitions on individual pages by importing and adding the `<ViewTransitions />` routing component to `<head>` on every desired page.
-
-```astro title="src/pages/index.astro" ins={2,7}
----
-import { ViewTransitions } from 'astro:transitions';
----
-<html lang="en">
-  <head>
-    <title>My Homepage</title>
-    <ViewTransitions />
-  </head>
-  <body>
-    <h1>Welcome to my website!</h1>
-  </body>
-</html>
-```
-
-See more about how to [control the router](/en/guides/view-transitions/#router-control) and [add transition directives](/en/guides/view-transitions/#transition-directives) to page elements and components.
+See the [list of languages supported by Prism](https://prismjs.com/#supported-languages) where you can find a language’s corresponding alias. And, you can also display your Astro code blocks with `lang="astro"`.
 
 ## `<Debug />`
 
diff --git a/src/content/docs/en/reference/errors/image-missing-alt.mdx b/src/content/docs/en/reference/errors/image-missing-alt.mdx
index 55d753d6a7b71..1c33c77fa7115 100644
--- a/src/content/docs/en/reference/errors/image-missing-alt.mdx
+++ b/src/content/docs/en/reference/errors/image-missing-alt.mdx
@@ -22,7 +22,7 @@ If the image is merely decorative (i.e. doesn’t contribute to the understandin
 
 **See Also:**
 -  [Images](/en/guides/images/)
--  [Image component](/en/guides/images/#image--astroassets)
--  [Image component#alt](/en/guides/images/#alt-required)
+-  [Image component](/en/reference/modules/astro-assets/#image-)
+-  [Image component#alt](/en/reference/modules/astro-assets/#alt-required)
 
 
diff --git a/src/content/docs/en/reference/errors/missing-image-dimension.mdx b/src/content/docs/en/reference/errors/missing-image-dimension.mdx
index 1b7f30a4c74a1..8ee09b1113c3c 100644
--- a/src/content/docs/en/reference/errors/missing-image-dimension.mdx
+++ b/src/content/docs/en/reference/errors/missing-image-dimension.mdx
@@ -16,12 +16,12 @@ import DontEditWarning from '~/components/DontEditWarning.astro'
 > Missing width and height attributes for `IMAGE_URL`. When using remote images, both dimensions are required in order to avoid cumulative layout shift (CLS).
 
 ## What went wrong?
-For remote images, `width` and `height` cannot automatically be inferred from the original file. To avoid cumulative layout shift (CLS), either specify these two properties, or set [`inferSize`](/en/guides/images/#infersize) to `true` to fetch a remote image's original dimensions.
+For remote images, `width` and `height` cannot automatically be inferred from the original file. To avoid cumulative layout shift (CLS), either specify these two properties, or set [`inferSize`](/en/reference/modules/astro-assets/#infersize) to `true` to fetch a remote image's original dimensions.
 
 If your image is inside your `src` folder, you probably meant to import it instead. See [the Imports guide for more information](/en/guides/imports/#other-assets).
 
 **See Also:**
 -  [Images](/en/guides/images/)
--  [Image component#width-and-height-required](/en/guides/images/#width-and-height-required-for-images-in-public)
+-  [Image component#width-and-height-required](/en/reference/modules/astro-assets/#width-and-height-required-for-images-in-public)
 
 
diff --git a/src/content/docs/en/reference/errors/missing-sharp.mdx b/src/content/docs/en/reference/errors/missing-sharp.mdx
index bd706ee0472fd..9fed3a6b7a09a 100644
--- a/src/content/docs/en/reference/errors/missing-sharp.mdx
+++ b/src/content/docs/en/reference/errors/missing-sharp.mdx
@@ -31,7 +31,6 @@ export default defineConfig({
 
 **See Also:**
 -  [Default Image Service](/en/guides/images/#default-image-service)
--  [Image Component](/en/guides/images/#image--astroassets)
 -  [Image Services API](/en/reference/image-service-reference/)
 
 
diff --git a/src/content/docs/en/reference/modules/astro-assets.mdx b/src/content/docs/en/reference/modules/astro-assets.mdx
index c041914953b16..79f36ed9122af 100644
--- a/src/content/docs/en/reference/modules/astro-assets.mdx
+++ b/src/content/docs/en/reference/modules/astro-assets.mdx
@@ -10,7 +10,7 @@ import ReadMore from '~/components/ReadMore.astro';
 
 <p><Since v="3.0.0" /></p>
 
- Astro provides built-in components and helper functions for optimizing and displaying your images. For features and usage examples, [see our image guide](/en/guides/images/).
+Astro provides built-in components and helper functions for optimizing and displaying your images. For features and usage examples, [see our image guide](/en/guides/images/).
 
 ## Imports from `astro:assets`
 
@@ -19,6 +19,7 @@ import {
   Image,
   Picture,
   getImage,
+  inferRemoteSize,
  } from 'astro:assets';
 ```
 
@@ -47,19 +48,222 @@ import myImage from "../assets/my_image.png"; // Image is 1600x900
   alt="A description of my image."
 />
 ```
-#### Properties
 
-- src (required)
-- alt (required)
-- width and height (required for `public/` and remote images)
-- format
-- quality
-- densities
-- widths
+#### Image properties
 
-In addition to the properties above, the `<Image />` component accepts all properties accepted by the HTML `<img>` tag.
+The `<Image />` component accepts all properties accepted by the HTML `<img>` tag in addition to the properties described below.
 
-See more in the [Images Guide](/en/guides/images/#image--astroassets).
+##### src (required)
+
+<p>
+
+**Type:** `ImageMetadata | string | Promise<{ default: ImageMetadata }>`
+</p>
+
+The format of the `src` value of your image file depends on where your image file is located:
+
+- **Local images in `src/`** - you must **also import the image** using a relative file path or configure and use an [import alias](/en/guides/imports/#aliases). Then use the import name as the `src` value:
+
+  ```astro title="src/pages/index.astro" "myImportedImage" "{myImportedImage}"
+  ---
+  import { Image } from 'astro:assets';
+  import myImportedImage from '../assets/my-local-image.png';
+  ---
+  <Image src={myImportedImage} alt="descriptive text" />
+  ```
+
+- **Images in the `public/` folder** -  use the image's **file path relative to the public folder**:
+
+  ```astro title="src/pages/index.astro" '"/images/my-public-image.png"'
+  ---
+  import { Image } from 'astro:assets';
+  ---
+  <Image
+    src="/images/my-public-image.png"
+    alt="descriptive text"
+    width="200"
+    height="150"
+  />
+  ```
+
+- **Remote images** - use the image's **full URL** as the property value:
+
+  ```astro title="src/pages/index.astro" '"https://example.com/remote-image.jpg"'
+  ---
+  import { Image } from 'astro:assets';
+  ---
+  <Image
+    src="https://example.com/remote-image.jpg"
+    alt="descriptive text"
+    width="200"
+    height="150"
+  />
+  ```
+
+##### alt (required)
+
+<p>
+
+**Type:** `string`
+</p>
+
+Use the required `alt` attribute to provide a string of [descriptive alt text](https://www.w3.org/WAI/tutorials/images/) for images.
+
+If an image is merely decorative (i.e. doesn't contribute to the understanding of the page), set `alt=""` so that screen readers and other assistive technologies know to ignore the image.
+
+##### width and height (required for images in `public/`)
+
+<p>
+
+**Type:** `number | undefined`
+</p>
+
+These properties define the dimensions to use for the image.
+
+When using images in their original aspect ratio, `width` and `height` are optional. These dimensions can be automatically inferred from image files located in `src/`. For remote images, add [the `inferSize` attribute set to `true`](#infersize) on the `<Image />` or `<Picture />` component or use [`inferRemoteSize()` function](#inferremotesize).
+
+However, both of these properties are required for images stored in your `public/` folder as Astro is unable to analyze these files.
+
+##### densities
+
+<p>
+
+**Type:** ``(number | `${number}x`)[] | undefined``<br />
+<Since v="3.3.0" />
+</p>
+
+A list of pixel densities to generate for the image.
+
+If provided, this value will be used to generate a `srcset` attribute on the `<img>` tag. Do not provide a value for `widths` when using this value.
+
+Densities that are equal to widths larger than the original image will be ignored to avoid upscaling the image.
+
+```astro title="src/components/MyComponent.astro"
+---
+import { Image } from 'astro:assets';
+import myImage from '../assets/my_image.png';
+---
+<Image
+  src={myImage}
+  width={myImage.width / 2}
+  densities={[1.5, 2]}
+  alt="A description of my image."
+/>
+```
+
+```html
+<!-- Output -->
+<img
+  src="/_astro/my_image.hash.webp"
+  srcset="
+    /_astro/my_image.hash.webp 1.5x
+    /_astro/my_image.hash.webp 2x
+  "
+  alt="A description of my image."
+  width="800"
+  height="450"
+  loading="lazy"
+  decoding="async"
+/>
+```
+
+##### widths
+
+<p>
+
+**Type:** `number[] | undefined`<br />
+<Since v="3.3.0" />
+</p>
+
+A list of widths to generate for the image.
+
+If provided, this value will be used to generate a `srcset` attribute on the `<img>` tag. A [`sizes` property](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/sizes) must also be provided.
+
+Do not provide a value for `densities` when using this value. Only one of these two values can be used to generate a `srcset`.
+
+Widths that are larger than the original image will be ignored to avoid upscaling the image.
+
+```astro
+---
+import { Image } from 'astro:assets';
+import myImage from '../assets/my_image.png'; // Image is 1600x900
+---
+<Image
+  src={myImage}
+  widths={[240, 540, 720, myImage.width]}
+  sizes={`(max-width: 360px) 240px, (max-width: 720px) 540px, (max-width: 1600px) 720px, ${myImage.width}px`}
+  alt="A description of my image."
+/>
+```
+
+```html
+<!-- Output -->
+<img
+  src="/_astro/my_image.hash.webp"
+  srcset="
+    /_astro/my_image.hash.webp 240w,
+    /_astro/my_image.hash.webp 540w,
+    /_astro/my_image.hash.webp 720w,
+		/_astro/my_image.hash.webp 1600w
+  "
+  sizes="
+    (max-width: 360px) 240px,
+    (max-width: 720px) 540px,
+    (max-width: 1600px) 720px,
+    1600px
+  "
+  alt="A description of my image."
+  width="1600"
+  height="900"
+  loading="lazy"
+  decoding="async"
+/>
+```
+
+##### format
+
+<p>
+
+**Type:** `ImageOutputFormat | undefined`
+</p>
+
+You can optionally state the [image file type](https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types#common_image_file_types) output to be used.
+
+By default, the `<Image />` component will produce a `.webp` file.
+
+##### quality
+
+<p>
+
+**Type:** `ImageQuality | undefined`
+</p>
+
+`quality` is an optional property that can either be:
+- a preset (`low`, `mid`, `high`, `max`) that is automatically normalized between formats.
+- a number from `0` to `100` (interpreted differently between formats).
+
+##### inferSize
+
+<p>
+
+**Type:** `boolean`<br />
+<Since v="4.4.0" />
+</p>
+
+Allows you to set the original `width` and `height` of a remote image automatically.
+
+By default, this value is set to `false` and you must manually specify both dimensions for your remote image.
+
+Add `inferSize` to the `<Image />` component (or `inferSize: true` to `getImage()`) to infer these values from the image content when fetched. This is helpful if you don't know the dimensions of the remote image, or if they might change:
+
+```astro mark="inferSize"
+---
+import { Image } from 'astro:assets';
+---
+<Image src="https://example.com/cat.png" inferSize alt="A cat sleeping in the sun." />
+```
+
+`inferSize` can fetch the dimensions of a [remote image from a domain that has not been authorized](/en/guides/images/#authorizing-remote-images), however the image itself will remain unprocessed.
 
 ### `<Picture />`
 
@@ -93,23 +297,66 @@ import myImage from "../assets/my_image.png"; // Image is 1600x900
 </picture>
 ```
 
-See more in the [Images Guide](/en/guides/images/#picture-).
-
-#### Properties
+#### Picture properties
 
-`<Picture />` accepts all the properties of the `<Image />` component, plus the following:
+`<Picture />` accepts all the properties of [the `<Image />` component](#image-properties), plus the following:
 
 ##### `formats`
 
-An array of image formats to use for the `<source>` tags. By default, this is set to `['webp']`.
+<p>
+
+**Type:** `ImageOutputFormat[]`
+</p>
+
+An array of image formats to use for the `<source>` tags. Entries will be added as `<source>` elements in the order they are listed, and this order determines which format is displayed. For the best performance, list the most modern format first (e.g. `webp` or `avif`). By default, this is set to `['webp']`.
 
 ##### `fallbackFormat`
 
-Format to use as a fallback value for the `<img>` tag. Defaults to `.png` for static images, `.gif` for animated images, and `.svg` for SVG files.
+<p>
+
+**Type:** `ImageOutputFormat`
+</p>
+
+Format to use as a fallback value for the `<img>` tag. Defaults to `.png` for static images (or `.jpg` if the image is a JPG), `.gif` for animated images, and `.svg` for SVG files.
 
 ##### `pictureAttributes`
 
-An object of attributes to be added to the `<picture>` tag. Use this property to apply attributes to the outer `<picture>` element itself. Attributes applied to the `<Picture />` component directly will apply to the inner `<img>` element, except for those used for image transformation.
+<p>
+
+**Type:** `HTMLAttributes<'picture'>`
+</p>
+
+An object of attributes to be added to the `<picture>` tag. 
+
+Use this property to apply attributes to the outer `<picture>` element itself. Attributes applied to the `<Picture />` component directly will apply to the inner `<img>` element, except for those used for image transformation.
+
+```astro title="src/components/MyComponent.astro"
+---
+import { Picture } from "astro:assets";
+import myImage from "../my_image.png"; // Image is 1600x900
+---
+
+<Picture
+  src={myImage}
+  alt="A description of my image."
+  pictureAttributes={{ style: "background-color: red;" }}
+/>
+```
+
+```html
+<!-- Output -->
+<picture style="background-color: red;">
+  <source srcset="/_astro/my_image.hash.webp" type="image/webp" />
+  <img
+    src="/_astro/my_image.hash.png"
+    alt="A description of my image."
+    width="1600"
+    height="900"
+    loading="lazy"
+    decoding="async"
+  />
+</picture>
+```
 
 ### `getImage()`
 
@@ -124,7 +371,7 @@ An object of attributes to be added to the `<picture>` tag. Use this property to
 
 The `getImage()` function is intended for generating images destined to be used somewhere else than directly in HTML, for example in an [API Route](/en/guides/endpoints/#server-endpoints-api-routes). It also allows you to create your own custom `<Image />` component.
 
-`getImage()` takes an options object with the [same properties as the Image component](/en/reference/components-reference/#properties) (except `alt`).
+`getImage()` takes an options object with the [same properties as the Image component](#image-properties) (except `alt`).
 
 ```astro
 ---
@@ -157,3 +404,18 @@ type GetImageResult = {
   };
 }
 ```
+
+### inferRemoteSize()
+
+<p>
+
+**Type:** `(url: string) => Promise<Omit<ImageMetadata, 'src' | 'fsPath'>>`<br />
+<Since v="4.12.0" />
+</p>
+
+A function to infer the dimensions of remote images. This can be used as an alternative to passing the `inferSize` property.
+
+```ts
+import { inferRemoteSize } from 'astro:assets';
+const {width, height} = await inferRemoteSize("https://example.com/cat.png");
+```
diff --git a/src/content/docs/ru/reference/api-reference.mdx b/src/content/docs/ru/reference/api-reference.mdx
index 7928da5d011e3..149c82a996e4b 100644
--- a/src/content/docs/ru/reference/api-reference.mdx
+++ b/src/content/docs/ru/reference/api-reference.mdx
@@ -1780,8 +1780,6 @@ import myImage from "../assets/my_image.png"; // Изображение имее
 
 В дополнение к вышеперечисленным свойствам, компонент `<Image />` принимает все свойства, принимаемые тегом HTML `<img>`.
 
-Смотрите больше в [Путеводителе по изображениям](/ru/guides/images/#image--astroassets).
-
 ### `<Picture />`
 
 <p><Since v="3.3.0" /></p>
@@ -1814,8 +1812,6 @@ import myImage from "../assets/my_image.png"; // Изображение имее
 </picture>
 ```
 
-Смотрите больше в [Путеводителе по изображениям](/ru/guides/images/#picture-).
-
 #### Properties
 
 `<Picture />` принимает все свойства компонента `<Image />`, плюс следующие:
diff --git a/src/content/docs/ru/reference/errors/image-missing-alt.mdx b/src/content/docs/ru/reference/errors/image-missing-alt.mdx
index 28d16cd2b0188..7f4df38a14314 100644
--- a/src/content/docs/ru/reference/errors/image-missing-alt.mdx
+++ b/src/content/docs/ru/reference/errors/image-missing-alt.mdx
@@ -15,5 +15,5 @@ githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/
 **Смотрите также:**
 
 -  [Изображения](/ru/guides/images/)
--  [Компонент изображения](/ru/guides/images/#image--astroassets)
--  [Компонент изображения#alt](/ru/guides/images/#alt-required)
+-  [Компонент изображения](/ru/reference/modules/astro-assets/#image-)
+-  [Компонент изображения#alt](/ru/reference/modules/astro-assets/#alt-required)
diff --git a/src/content/docs/ru/reference/errors/missing-image-dimension.mdx b/src/content/docs/ru/reference/errors/missing-image-dimension.mdx
index e22c7589f252c..b0c52db4228cc 100644
--- a/src/content/docs/ru/reference/errors/missing-image-dimension.mdx
+++ b/src/content/docs/ru/reference/errors/missing-image-dimension.mdx
@@ -8,12 +8,12 @@ githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/
 
 ## Что пошло не так?
 
-Для внешних изображений `width` и `height` не могут быть автоматически определены из исходного файла. Чтобы избежать кумулятивного сдвига макета (CLS), либо укажите эти два свойства, либо установите [`inferSize`](/ru/guides/images/#infersize) в `true`, чтобы получить оригинальные размеры удаленного изображения.
+Для внешних изображений `width` и `height` не могут быть автоматически определены из исходного файла. Чтобы избежать кумулятивного сдвига макета (CLS), либо укажите эти два свойства, либо установите [`inferSize`](/ru/reference/modules/astro-assets/#infersize) в `true`, чтобы получить оригинальные размеры удаленного изображения.
 
 Если ваше изображение находится в папке `src`, то вы, вероятно, хотели импортировать его. См. [руководство по импорту](/ru/guides/imports/#other-assets) для получения дополнительной информации.
 
 **Смотрите также:**
 
 -  [Изображения](/ru/guides/images/)
--  [Компонент изображения#width-and-height-required](/ru/guides/images/#width-and-height-required-for-images-in-public)
+-  [Компонент изображения#width-and-height-required](/ru/reference/modules/astro-assets/#width-and-height-required-for-images-in-public)
 
diff --git a/src/content/docs/ru/reference/errors/missing-sharp.mdx b/src/content/docs/ru/reference/errors/missing-sharp.mdx
index d37cd00fb0dc0..474208ae3d9ea 100644
--- a/src/content/docs/ru/reference/errors/missing-sharp.mdx
+++ b/src/content/docs/ru/reference/errors/missing-sharp.mdx
@@ -24,6 +24,5 @@ export default defineConfig({
 **Смотрите также:**
 
 -  [Служба изображений по умолчанию](/ru/guides/images/#default-image-service)
--  [Компонент изображения](/ru/guides/images/#image--astroassets)
 -  [API службы изображений](/ru/reference/image-service-reference/)
 

From 92ae041063bd0dd7bab3e75339652db0316a8677 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Tue, 29 Oct 2024 17:03:06 +0100
Subject: [PATCH 40/43] i18n(fr): create
 `reference/modules/astro-middleware.mdx` (#9828)

* i18n(fr): create `reference/modules/astro-middleware.mdx`

See #9687

* translate comment

Co-authored-by: Thomas Bonnet <thomasbnt@protonmail.com>

* translate missing sentence

Co-authored-by: Thomas Bonnet <thomasbnt@protonmail.com>

---------

Co-authored-by: Thomas Bonnet <thomasbnt@protonmail.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
---
 .../fr/reference/modules/astro-middleware.mdx | 122 ++++++++++++++++++
 1 file changed, 122 insertions(+)
 create mode 100644 src/content/docs/fr/reference/modules/astro-middleware.mdx

diff --git a/src/content/docs/fr/reference/modules/astro-middleware.mdx b/src/content/docs/fr/reference/modules/astro-middleware.mdx
new file mode 100644
index 0000000000000..d799a66783b31
--- /dev/null
+++ b/src/content/docs/fr/reference/modules/astro-middleware.mdx
@@ -0,0 +1,122 @@
+---
+title: Référence de l'API Middleware
+i18nReady: true
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 6
+---
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
+
+<p><Since v="2.6.0" /></p>
+
+Un middleware vous permet d'intercepter les requêtes et les réponses et d'injecter des comportements de manière dynamique chaque fois qu'une page ou un point de terminaison est sur le point d'être rendu. Pour les fonctionnalités et les exemples d'utilisation, [consultez notre guide Middleware](/fr/guides/middleware/).
+
+## Importations depuis `astro:middleware`
+
+```js
+import { 
+  sequence,
+  createContext,
+  trySerializeLocals,
+  defineMiddleware,
+ } from 'astro:middleware';
+```
+
+### `defineMiddleware()`
+
+Vous pouvez importer et utiliser la fonction utilitaire `defineMiddleware()` pour bénéficier de la sûreté du typage :
+
+```ts
+// src/middleware.ts
+import { defineMiddleware } from "astro:middleware";
+
+// `context` et `next` sont automatiquement saisis
+export const onRequest = defineMiddleware((context, next) => {
+
+});
+```
+
+### `sequence()`
+
+<p>
+
+**Type :** `(...handlers: MiddlewareHandler[]) => MiddlewareHandler`
+</p>
+
+Une fonction qui accepte les fonctions middleware comme arguments et les exécutera dans l'ordre dans lequel elles sont transmises.
+
+```js title="src/middleware.js"
+import { sequence } from "astro:middleware";
+
+async function validation(_, next) {...}
+async function auth(_, next) {...}
+async function greeting(_, next) {...}
+
+export const onRequest = sequence(validation, auth, greeting);
+```
+
+### `createContext()`
+
+<p>
+
+**Type :** `(context: CreateContext) => APIContext`<br />
+<Since v="2.8.0" />
+</p>
+
+Une API de bas niveau pour créer un objet [`APIContext`](/fr/reference/api-reference/#contexte-du-point-de-terminaison) à transmettre à une fonction `onRequest()` du middleware Astro.
+
+Cette fonction peut être utilisée par les intégrations/adaptateurs pour exécuter par programmation le middleware Astro.
+
+### `trySerializeLocals()`
+
+<p>
+
+**Type :** `(value: unknown) => string`<br />
+<Since v="2.8.0" />
+</p>
+
+Une API de bas niveau qui prend n'importe quelle valeur et tente d'en renvoyer une version sérialisée (une chaîne de caractères). Si la valeur ne peut pas être sérialisée, la fonction générera une erreur d'exécution.
+
+## Middleware exports
+
+Lors de la définition du middleware de votre projet dans `src/middleware.js`, il exporte les fonctions définies par l'utilisateur suivantes :
+
+### `onRequest()`
+
+**Type :** `(context: APIContext, next: MiddlewareNext) => Promise<Response> | Response | Promise<void> | void`
+
+Une fonction exportée requise depuis `src/middleware.js` qui sera appelée avant le rendu de chaque page ou route API. Elle reçoit deux arguments : [context](#context) et [next()](#next). `onRequest()` doit renvoyer une réponse (`Response`) : soit directement, soit en appelant `next()`.
+
+```js title="src/middleware.js"
+export function onRequest (context, next) {
+    // intercepte les données de réponse d'une requête
+    // éventuellement, transforme la réponse
+    // renvoie directement une réponse, ou le résultat de l'appel de `next()`
+    return next();
+};
+```
+
+Votre fonction `onRequest()` sera appelée avec les arguments suivants :
+
+#### `context`
+
+<p>
+
+**Type :** `APIContext`
+</p>
+
+Le premier argument de `onRequest()` est un objet de contexte. Il reflète de nombreuses propriétés globales d'`Astro`.
+
+<ReadMore>Consultez [Contextes de point de terminaison](/fr/reference/api-reference/#contexte-du-point-de-terminaison) pour plus d'informations sur l'objet de contexte.</ReadMore>
+
+#### `next()`
+
+<p>
+
+**Type :** `(rewritePayload?: string | URL | Request) => Promise<Response>`<br />
+</p>
+
+Le deuxième argument de `onRequest()` est une fonction qui appelle tous les middlewares suivants de la chaîne et renvoie une `Response`. Par exemple, un autre middleware pourrait modifier le corps HTML d'une réponse et attendre le résultat de `next()` permettrait à votre middleware de répondre à ces modifications.
+
+Depuis Astro v4.13.0, `next()` accepte un paramètre de chemin d'URL facultatif sous la forme d'une chaîne de caractères, d'une `URL` ou d'un objet `Request` pour [réécrire](/fr/guides/routing/#réécritures) la requête actuelle sans déclencher une nouvelle phase de rendu.

From 0532be62b3c65c3d71189920370c5a9d67cdccdd Mon Sep 17 00:00:00 2001
From: t0yohei <30691457+t0yohei@users.noreply.github.com>
Date: Wed, 30 Oct 2024 01:16:33 +0900
Subject: [PATCH 41/43] i18n(ja): Add media.mdx (#9855)

* i18n(ja): Add media.mdx

* i18n(ja): Update hosted media and other translations

---------

Co-authored-by: t0yohei <inuneko690121@gmail.co>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: morinokami <7889778+morinokami@users.noreply.github.com>
---
 src/content/docs/ja/guides/media.mdx | 39 ++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 src/content/docs/ja/guides/media.mdx

diff --git a/src/content/docs/ja/guides/media.mdx b/src/content/docs/ja/guides/media.mdx
new file mode 100644
index 0000000000000..b3a03f5e78a52
--- /dev/null
+++ b/src/content/docs/ja/guides/media.mdx
@@ -0,0 +1,39 @@
+---
+title: AstroでDAMを使う
+description: デジタルアセットマネージャー（DAM）を使ってAstroに画像や動画を追加する方法
+i18nReady: true
+---
+import MediaGuidesNav from '~/components/MediaGuidesNav.astro';
+import ReadMore from '~/components/ReadMore.astro';
+import Badge from "~/components/Badge.astro"
+
+
+**Astroプロジェクトにヘッドレスデジタルアセットマネージャー（DAM）を接続する準備はできましたか?** このガイドに従って、ホステッドメディアシステム（hosted media systems）を組み込みましょう。
+
+:::tip
+DAMまたはホステッドメディアシステムをプロジェクトに接続するために、インテグレーションディレクトリで[コミュニティ製のインテグレーション](https://astro.build/integrations/)を探してみましょう。
+:::
+
+## ホステッドメディアガイド
+
+各ページの多くは**未完成**なので注意してください。未完成のページへの貢献をお待ちしています！
+
+<MediaGuidesNav />
+
+## なぜ DAM やホステッドメディアを使うのか？
+
+DAM（デジタルアセットマネージャー）を使用することで、個人やチーム、組織は[CMS](/ja/guides/cms/)と同じように画像やビデオのアセットを一元管理することができます。
+
+違いは管理するコンテンツの種類です。DAMは主に画像や動画、そして3Dモデルのようなその他のメディアアセット、またそれらのアセットに関連するメタデータを管理します。
+
+これは、特に複数のウェブやモバイルプロパティ間でアセットを信頼できる唯一の情報源とする場合に便利です。このことは、複数のチームが同じアセットを使用する必要がある組織に属している場合や、PIM（商品情報マネージャー）のような他のコンテンツシステムに統合してアセットを製品に関連付ける場合に重要です。
+
+## Astroと相性の良いホステッドメディアシステムやDAMは？
+
+CMSを使用するときと同じように、Astroはコンテンツの _表示_ を担うので、APIやSDKを介してアセットを取得し、やり取りできるヘッドレスDAMの使用をお勧めします。
+
+CloudinaryのようないくつかのヘッドレスDAMはAstroの[インテグレーション](/ja/guides/integrations-guide/)を提供しており、アセットを簡単に取得し、ウェブサイトやアプリに表示することができます。
+
+## ホステッドメディアシステムやDAMなしでAstroを使用できますか？
+
+はい！Astroにはリモート画像を参照するためのサポートを含んだ、[画像の保存](/ja/guides/images/#画像を保存する場所)方法が組み込まれています。

From a50bf4ca75610da2da2e3a50b0236bb190fe44b0 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Tue, 29 Oct 2024 17:24:09 +0100
Subject: [PATCH 42/43] i18n(fr): update link in `guides/deploy/fleek.mdx`
 (#9856)

See #9800

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 src/content/docs/fr/guides/deploy/fleek.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/fr/guides/deploy/fleek.mdx b/src/content/docs/fr/guides/deploy/fleek.mdx
index cb040209f92c1..60f8f3ad7a712 100644
--- a/src/content/docs/fr/guides/deploy/fleek.mdx
+++ b/src/content/docs/fr/guides/deploy/fleek.mdx
@@ -75,4 +75,4 @@ Vous pouvez déployer vers Fleek via l’interface utilisateur du site web ou en
 ## En savoir plus
 
 <ReadMore>[Déployer votre site depuis l'interface utilisateur Fleek](https://fleek.xyz/docs/platform/deployments/)</ReadMore>
-<ReadMore>[Déployer votre site depuis Fleek CLI](https://fleek.xyz/docs/cli/sites/)</ReadMore>
+<ReadMore>[Déployer votre site depuis Fleek CLI](https://fleek.xyz/docs/cli/hosting/)</ReadMore>

From 1b254a36d2c0254d384ea511984fe7e156eb78da Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armand.philippot.eu>
Date: Tue, 29 Oct 2024 17:32:50 +0100
Subject: [PATCH 43/43] i18n(fr): update `guides/markdown-content.mdx` (#9834)

* i18n(fr): update `guides/markdown-content.mdx`

See #9687

* update anchor as well

---------

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: thomasbnt <14293805+thomasbnt@users.noreply.github.com>
---
 src/content/docs/fr/guides/markdown-content.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/fr/guides/markdown-content.mdx b/src/content/docs/fr/guides/markdown-content.mdx
index 12f601c4d8dd3..a4fbcf3fe36d3 100644
--- a/src/content/docs/fr/guides/markdown-content.mdx
+++ b/src/content/docs/fr/guides/markdown-content.mdx
@@ -61,7 +61,7 @@ const posts = Object.values(await import.meta.glob('../posts/*.md', { eager: tru
 
 Lorsque vous récupérez des données de vos collections via des fonctions d'aide, les propriétés de votre document Markdown sont disponibles dans un objet `data` (par exemple `post.data.title`). De plus, `body` contient le contenu brut, non compilé, sous forme de chaîne de caractères.
 
-<ReadMore>Voir le [Type des entrées de collection](/fr/reference/api-reference/#type-des-entrées-de-collection) complet.</ReadMore>
+<ReadMore>Voir le [Type des entrées de collection](/fr/reference/modules/astro-content/#collectionentry) complet.</ReadMore>
 
 #### Importation de Markdown