Merge branch 'main' into 4.13.0

withastro · Aug 1, 2024 · abda08a · abda08a
2 parents ad98eef + 7a982ce
commit abda08a
Show file tree

Hide file tree

Showing 5 changed files with 43 additions and 15 deletions.
diff --git a/src/content/docs/fr/guides/migrate-to-astro/from-docusaurus.mdx b/src/content/docs/fr/guides/migrate-to-astro/from-docusaurus.mdx
@@ -19,7 +19,7 @@ Docusaurus et Astro partagent certaines similitudes qui vous aideront à migrer
 
 - Astro et Docusaurus supportent tous deux les [pages MDX](/fr/guides/markdown-content/). Vous devriez pouvoir utiliser vos fichiers `.mdx` existants pour Astro.
 
-- Astro et Docusaurus utilisent [e routage basé sur les fichiers](/fr/guides/routing/) pour générer automatiquement des routes de pages pour tout fichier MDX situé dans `src/pages`. L'utilisation de la structure de fichiers d'Astro pour votre contenu existant et lors de l'ajout de nouvelles pages devrait vous sembler familière.
+- Astro et Docusaurus utilisent [le routage basé sur les fichiers](/fr/guides/routing/) pour générer automatiquement des routes de pages pour tout fichier MDX situé dans `src/pages`. L'utilisation de la structure de fichiers d'Astro pour votre contenu existant et lors de l'ajout de nouvelles pages devrait vous sembler familière.
 
 - Astro dispose d'une [intégration officielle pour l'utilisation des composants React](/fr/guides/integrations-guide/react/). Notez que dans Astro, les fichiers React **doivent** avoir une extension `.jsx` ou `.tsx`.
 
@@ -29,7 +29,7 @@ Docusaurus et Astro partagent certaines similitudes qui vous aideront à migrer
 
 ## Principales différences entre Docusaurus et Astro
 
-Lorsque vous reconstruisez votre site Docusaurus dans Astro, vous remarquerez quelques différences importantes :
+Lorsque vous reconstruisez votre site Docusaurus avec Astro, vous remarquerez quelques différences importantes :
 
 - Docusaurus est une application monopage (SPA) basée sur React. Les sites Astro sont des applications multi-pages construites en utilisant des [composants `.astro`](/fr/basics/astro-components/), mais peuvent aussi supporter [React, Preact, Vue.js, Svelte, SolidJS, AlpineJS, Lit](/fr/guides/framework-components/) et le templating HTML brut.
 
@@ -39,7 +39,7 @@ Lorsque vous reconstruisez votre site Docusaurus dans Astro, vous remarquerez qu
 
 ## Passer de Docusaurus à Astro
 
-Pour convertir un site de documentation Docusaurus en Astro, par notre [modèle de démarrage officiel Starlight](https://starlight.astro.build), ou explorez d'autres thèmes de documentation communautaires dans notre [vitrine de thèmes](https://astro.build/themes?search=&categories%5B%5D=docs).
+Pour convertir un site de documentation Docusaurus en Astro, commencez par notre [modèle de démarrage officiel Starlight](https://starlight.astro.build), ou explorez d'autres thèmes de documentation communautaires dans notre [vitrine de thèmes](https://astro.build/themes?search=&categories%5B%5D=docs).
 
 Vous pouvez passer un argument `--template` à la commande `create astro` pour démarrer un nouveau projet Astro avec l'un de nos modèles officiels. Vous pouvez aussi [démarrer un nouveau projet à partir de n'importe quel dépôt Astro existant sur GitHub](/fr/install-and-setup/#utiliser-un-thème-ou-un-modèle-de-démarrage).
 

diff --git a/src/content/docs/ko/basics/layouts.mdx b/src/content/docs/ko/basics/layouts.mdx
@@ -238,22 +238,34 @@ const { title, fancyJsHelper } = Astro.props;
 
 <ReadMore>[Markdown/MDX 안내서](/ko/guides/markdown-content/)에서 Astro의 Markdown 및 MDX 지원에 대해 자세히 알아보세요.</ReadMore>
 
-## `.md`, `.mdx`, `.astro`에 하나의 레이아웃 사용
+### 레이아웃에서 TypeScript 사용하기
 
-단일 Astro 레이아웃을 작성하여 `.md` 및 `.mdx` 파일의 `frontmatter` 객체는 물론, `.astro` 파일에서 전달된 모든 명명된 props를 수신할 수 있습니다.
+모든 Astro 레이아웃의 props로 타입을 제공하여 타입 안정성 및 자동 완성 기능을 추가할 수 있습니다.
 
-아래 예에서 레이아웃은 프런트매터 YAML `title` 속성 또는 `title` 속성을 전달하는 Astro 컴포넌트에서 페이지 제목을 표시합니다.
-
-```astro /{?title}?/ /Astro.props[.a-z]*/
+```astro ins={2-7} title="src/components/MyLayout.astro"
 ---
-// src/components/MyLayout.astro
-const { title } = Astro.props.frontmatter || Astro.props;
+interface Props { 
+	title: string;
+  description: string;
+  publishDate: string;
+  viewCount: number;
+}
+const { title, description, publishDate, viewCount } = Astro.props;
 ---
-<html>
-  <head></head>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="description" content={description}>
+    <title>{title}</title>
+  </head>
   <body>
-    <h1>{title}</h1>
-    <slot />
+    <header>
+      <p>Published on {publishDate}</p>
+      <p>Viewed by {viewCount} folks</p>
+    </header>
+    <main>
+      <slot />
+    </main>
   </body>
 </html>
 ```

diff --git a/src/content/docs/ko/basics/project-structure.mdx b/src/content/docs/ko/basics/project-structure.mdx
@@ -118,6 +118,10 @@ JavaScript 패키지 관리자가 종속성을 관리하는 데 사용하는 파
 
 이 파일은 모든 시작 템플릿에서 생성되며 Astro 프로젝트에 대한 구성 옵션을 포함합니다. 이 파일에서 사용할 통합, 빌드 옵션, 서버 옵션 등을 설정할 수 있습니다.
 
+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 구성 가이드](/ko/guides/configuring-astro/)를 확인하세요.
 
 ### `tsconfig.json`

diff --git a/src/content/docs/ko/guides/routing.mdx b/src/content/docs/ko/guides/routing.mdx
@@ -421,7 +421,7 @@ interface Page<T = any> {
 		next: string | undefined;
     /** 첫 페이지의 URL (현재 페이지가 첫 페이지가 아닌 경우) */
 		first: string | undefined;
-		/** 다음 페이지의 URL (현재 페이지가 마지막 페이지가 아닌 경우) */
+		/** 마지막 페이지의 URL (현재 페이지가 마지막 페이지가 아닌 경우) */
 		last: string | undefined;
 	};
 }

diff --git a/src/content/docs/ko/reference/api-reference.mdx b/src/content/docs/ko/reference/api-reference.mdx
@@ -535,6 +535,18 @@ import Shout from "../components/Shout.astro";
 <!-- <div>SLOTS!</div>로 렌더링 됩니다. -->
 ```
 
+콜백 함수는 `slot` 속성이 있는 래핑 HTML 요소 태그 내부의 명명된 슬롯으로 전달할 수 있습니다. 이 요소는 콜백을 명명된 슬롯으로 전송하는 데만 사용되며 페이지에 렌더링되지 않습니다.
+
+```astro
+<Shout message="slots!">
+  <fragment slot="message">
+    {(message) => <div>{message}</div>}
+  </fragment>
+</Shout>
+```
+
+래핑 태그에는 표준 HTML 요소를 사용하거나 컴포넌트로 해석되지 않는 소문자 태그 (예: `<Fragment />` 대신 `<fragment>`)를 사용하세요.  HTML `<slot>` 요소는 Astro 슬롯으로 해석되므로 사용하지 마세요.
+
 ### `Astro.self`
 
 `Astro.self`를 사용하면 Astro 컴포넌트를 재귀적으로 호출할 수 있습니다. 이 동작을 사용하면 컴포넌트 템플릿의 `<Astro.self>`를 사용하여 Astro 컴포넌트 자체에서 Astro 컴포넌트를 렌더링할 수 있습니다. 이는 대규모 데이터 저장소와 중첩된 데이터 구조를 반복하는 데 도움이 될 수 있습니다.