From dc79b6caf05159036d5fe7d4be7256f14c504a16 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 2 May 2024 09:32:48 +0900
Subject: [PATCH 1/9] i18n(ko-KR): update `framework-components.mdx`

---
 .../docs/ko/guides/framework-components.mdx   | 59 +++++++++----------
 1 file changed, 29 insertions(+), 30 deletions(-)

diff --git a/src/content/docs/ko/guides/framework-components.mdx b/src/content/docs/ko/guides/framework-components.mdx
index 00f4d33a96dfe..22341f64d1718 100644
--- a/src/content/docs/ko/guides/framework-components.mdx
+++ b/src/content/docs/ko/guides/framework-components.mdx
@@ -10,7 +10,7 @@ import ReadMore from '~/components/ReadMore.astro'
 
 ## 공식 UI 프레임워크 통합
 
-Astro는 [React](https://ko.react.dev/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://ko.vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/), [Lit](https://lit.dev/) 공식 통합이 포함되어 있습니다.
+Astro에는 [React](https://ko.react.dev/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://ko.vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/), [Lit](https://lit.dev/) 공식 통합이 포함되어 있습니다.
 
 통합 디렉터리에서 더 많은 [커뮤니티에서 관리하는 프레임워크 통합](https://astro.build/integrations/?search=&categories%5B%5D=frameworks) (예: Angular, Qwik, Elm)을 찾아보세요.
 
@@ -18,19 +18,19 @@ Astro는 [React](https://ko.react.dev/), [Preact](https://preactjs.com/), [Svelt
 
 ## 통합 설치
 
-이러한 Astro 통합 중 하나 이상을 프로젝트에 설치하고 구성할 수 있습니다.
+하나 이상의 Astro 통합을 프로젝트에 설치하고 구성할 수 있습니다.
 
 Astro 통합 설치 및 구성에 대한 자세한 내용은 [통합 안내서](/ko/guides/integrations-guide/)를 참조하세요.
 
 :::tip
-선택한 프레임워크의 예시를 보고 싶으십니까? [astro.new](https://astro.new/latest/frameworks)를 방문하여 프레임워크 템플릿 중 하나를 선택하세요.
+선택한 프레임워크의 예시를 보고 싶나요? [astro.new](https://astro.new/latest/frameworks)를 방문하여 프레임워크 템플릿 중 하나를 선택하세요.
 :::
 
-## 프레임워크 컴포넌트 사용하기
+## 프레임워크 컴포넌트 사용
 
-Astro 컴포넌트와 마찬가지로 자바스크립트 프레임워크 컴포넌트를 Astro 페이지, 레이아웃, 컴포넌트에서 사용할 수 있습니다! 모든 컴포넌트는 `/src/components`에 모아두거나 원하는 대로 구성할 수 있습니다.
+Astro 컴포넌트와 마찬가지로 자바스크립트 프레임워크 컴포넌트를 Astro 페이지, 레이아웃, 컴포넌트에서 사용할 수 있습니다! 모든 컴포넌트는 `/src/components` 디렉터리에 모아두거나 원하는 대로 구성할 수 있습니다.
 
-프레임워크 컴포넌트를 사용하려면 Astro 컴포넌트 스크립트에서 상대 경로를 지정하여 가져옵니다. 그리고 컴포넌트 템플릿에서 다른 컴포넌트, HTML 요소, JSX와 같은 표현식과 함께 사용합니다.
+프레임워크 컴포넌트를 사용하기 위해 Astro 컴포넌트 스크립트에서 상대 경로를 지정하여 가져옵니다. 그리고 컴포넌트 템플릿에서 다른 컴포넌트, HTML 요소, JSX와 같은 표현식과 함께 사용합니다.
 
 ```astro title="src/pages/static-components.astro" ins={2,7}
 ---
@@ -44,14 +44,13 @@ import MyReactComponent from '../components/MyReactComponent.jsx';
 </html>
 ```
 
-기본적으로 프레임워크 컴포넌트는 서버에서 정적 HTML로 렌더링 됩니다. 이는 비대화형 컴포넌트를 템플릿화하는데 유용하며, 필요하지 않은 자바스크립트를 클라이언트에 전송하는 것을 방지합니다.
+기본적으로 프레임워크 컴포넌트는 서버에서 정적 HTML로 렌더링 됩니다. 이는 비대화형 컴포넌트를 템플릿으로 만드는데 유용하며, 필요하지 않은 자바스크립트를 클라이언트에 전송하는 것을 방지합니다.
 
+## 인터랙티브 컴포넌트 하이드레이션
 
-## 인터랙티브 컴포넌트 하이드레이션하기
+프레임워크 컴포넌트는 [`client:*` 지시어](/ko/reference/directives-reference/#클라이언트-지시어)를 이용하여 대화형으로 만들 수 있습니다 (하이드레이션). 이는 컴포넌트의 자바스크립트가 브라우저로 전송되는 시기를 결정하는 컴포넌트 속성입니다.
 
-프레임워크 컴포넌트는 [`client:*` 지시어](/ko/reference/directives-reference/#클라이언트-지시어)를 이용하여 대화형(하이드레이션)으로 만들 수 있습니다. 이는 컴포넌트의 자바스크립트가 브라우저로 전송되는 시기를 결정하는 컴포넌트 속성입니다.
-
-`client:only`를 제외한 모든 클라이언트 지시어를 사용하면 컴포넌트는 먼저 서버에서 렌더링 되어 정적 HTML을 생성합니다. 자바스크립트 컴포넌트는 지시어에 따라 브라우저로 전송됩니다. 이후 컴포넌트가 하이드레이트 되어 인터랙티브하게 됩니다.
+`client:only`를 제외한 모든 클라이언트 지시어를 사용하면 컴포넌트는 먼저 서버에서 렌더링 되어 정적 HTML을 생성합니다. 자바스크립트 컴포넌트는 지시어에 따라 브라우저로 전송됩니다. 그러면 컴포넌트에 하이드레이션이 추가되어 인터랙티브 컴포넌트가 됩니다.
 
 ```astro title="src/pages/interactive-components.astro" /client:\S+/
 ---
@@ -70,10 +69,10 @@ import InteractiveModal from "../components/InteractiveModal.svelte"
 <InteractiveModal client:only="svelte" />
 ```
 
-컴포넌트를 렌더링하는 데 필요한 자바스크립트 프레임워크(React, Svelte 등)는 컴포넌트 자체의 자바스크립트와 함께 브라우저로 전송됩니다. 페이지의 여러 컴포넌트가 동일한 프레임워크를 사용하는 경우, 프레임워크는 한 번만 전송됩니다.
+컴포넌트를 렌더링하는 데 필요한 자바스크립트 프레임워크 (React, Svelte 등)는 컴포넌트 자체 자바스크립트와 함께 브라우저로 전송됩니다. 페이지의 여러 컴포넌트가 동일한 프레임워크를 사용하는 경우, 프레임워크는 한 번만 전송됩니다.
 
 :::note[접근성]
-이 컴포넌트들을 Astro 에서 사용할 경우, 프레임워크별 접근성 패턴이 동일하게 작동해야 합니다. 접근성 관련 자바스크립트가 제대로 로드되고 실행되도록 클라이언트 지시어를 반드시 설정해야 합니다.
+이러한 컴포넌트를 Astro 에서 사용하는 경우, 프레임워크별 접근성 패턴이 동일하게 작동해야 합니다. 접근성 관련 자바스크립트가 제대로 로드되고 실행되도록 클라이언트 지시어를 반드시 설정해야 합니다.
 :::
 
 ### 사용 가능한 하이드레이션 지시어
@@ -82,13 +81,13 @@ UI 프레임워크 컴포넌트에서 사용할 수 있는 하이드레이션 
 
 <ReadMore>하이드레이션 지시어에 대한 자세한 설명과 사용법은 [지시어 참조](/ko/reference/directives-reference/#클라이언트-지시어) 페이지를 참조하세요.</ReadMore>
 
-## 프레임워크 혼합하기
+## 프레임워크 혼합
 
-동일한 Astro 컴포넌트 내에서 여러 프레임워크에서 만든 컴포넌트를 가져와 렌더링할 수 있습니다.
+동일한 Astro 컴포넌트에서 여러 프레임워크 컴포넌트를 가져와 렌더링할 수 있습니다.
 
 ```astro title="src/pages/mixing-frameworks.astro"
 ---
-// 예: 한 페이지에 여러 프레임워크의 구성요소를 혼합하는 경우
+// 예시: 한 페이지에서 여러 프레임워크 컴포넌트 혼합
 import MyReactComponent from '../components/MyReactComponent.jsx';
 import MySvelteComponent from '../components/MySvelteComponent.svelte';
 import MyVueComponent from '../components/MyVueComponent.vue';
@@ -101,10 +100,10 @@ import MyVueComponent from '../components/MyVueComponent.vue';
 ```
 
 :::caution
-**Astro** 컴포넌트(`.astro`)만 여러 프레임워크의 컴포넌트를 포함할 수 있습니다.
+오직 **Astro** 컴포넌트 (`.astro`)만이 여러 프레임워크 컴포넌트를 포함할 수 있습니다.
 :::
 
-## 프레임워크 컴포넌트에 Props 전달하기
+## 프레임워크 컴포넌트에 Props 전달
 
 Astro 컴포넌트에서 프레임워크 컴포넌트로 props를 전달할 수 있습니다.
 
@@ -120,15 +119,15 @@ import Counter from '../components/Counter.svelte';
 ```
 
 :::caution[함수를 props로 전달하기]
-프레임워크 컴포넌트에 함수를 프로퍼티로 전달할 수 있지만, 이 함수는 서버 렌더링 중에만 작동합니다. 이 함수를 하이드레이션 컴포넌트(예: 이벤트 핸들러)에서 사용하려고 하면 오류가 발생합니다.
+프레임워크 컴포넌트에 함수를 전달할 수 있지만, 이 함수는 서버 렌더링 중에만 작동합니다. 이 함수를 하이드레이션 컴포넌트 (예: 이벤트 핸들러)에서 사용하면 오류가 발생합니다.
 
-이는 Astro 에서 함수를 직렬화(서버에서 클라이언트로 전송)할 수 없기 때문입니다.
+이는 Astro 에서 함수를 직렬화 (서버에서 클라이언트로 전송)할 수 없기 때문입니다.
 :::
 
 
-## 프레임워크 컴포넌트에 자식 요소 전달하기
+## 프레임워크 컴포넌트에 자식 요소 전달
 
-Astro 컴포넌트에서는 프레임워크 컴포넌트에 자식 요소를 전달할 수 있습니다. 각 프레임워크마다 이러한 자식 요소를 참조하는 고유한 패턴이 있는데, React, Preact, Solid는 `children`이라는 특별한 속성을 사용하고, Svelte와 Vue는 `<slot />`라는 요소를 사용합니다.
+Astro 컴포넌트에서 프레임워크 컴포넌트로 자식 요소를 전달할 수 있습니다. 각 프레임워크마다 이러한 자식 요소를 참조하는 고유한 패턴이 있는데, React, Preact, Solid는 `children`이라는 특별한 속성을 사용하고, Svelte와 Vue는 `<slot />`라는 요소를 사용합니다.
 
 ```astro title="src/pages/component-children.astro" {5}
 ---
@@ -181,9 +180,9 @@ Svelte와 Vue에서 이러한 슬롯은 `<slot>` 요소에 `name` 속성을 붙
 </aside>
 ```
 
-## 프레임워크 컴포넌트 중첩하기
+## 프레임워크 컴포넌트 중첩
 
-Astro 파일 내에서는 프레임워크 컴포넌트의 자식 요소도 하이드레이션된 컴포넌트로 만들 수 있습니다. 즉, 프레임워크의 모든 컴포넌트를 재귀적으로 중첩할 수 있습니다.
+Astro 파일에서 프레임워크 컴포넌트의 자식 요소를 하이드레이션 컴포넌트로 만들 수 있습니다. 즉, 프레임워크의 모든 컴포넌트를 재귀적으로 중첩할 수 있습니다.
 
 ```astro title="src/pages/nested-components.astro" {10-11}
 ---
@@ -202,20 +201,20 @@ import MySvelteButton from '../components/MySvelteButton.svelte';
 ```
 
 :::caution
-프레임워크의 컴포넌트 자체(예: `.jsx`, `.svelte`)는 여러 프레임워크를 혼용할 수 없습니다.
+프레임워크 컴포넌트 (예: `.jsx`, `.svelte`)는 여러 프레임워크를 혼용할 수 없습니다.
 :::
 
 이를 통해 원하는 자바스크립트 프레임워크로 전체 '앱'을 구축하고 상위 컴포넌트를 통해 Astro의 페이지로 렌더링할 수 있습니다.
 
 :::note
-Astro 컴포넌트는 하이드레이션되는 프레임워크 컴포넌트를 포함하더라도 항상 정적 HTML로 렌더링 됩니다. 즉, Astro 컴포넌트에서 프레임워크 컴포넌트에 React의 'render props'를 전달하면, Astro 컴포넌트는 이 패턴이 요구하는 클라이언트 런타임 동작을 제공하지 못하기 때문에 작동하지 않습니다. 대신 이름을 가진 슬롯을 사용합니다.
+Astro 컴포넌트는 하이드레이션 프레임워크 컴포넌트를 포함하더라도 항상 정적 HTML로 렌더링 됩니다. 즉, Astro 컴포넌트에서 프레임워크 컴포넌트에 React의 'render props'를 전달하면, Astro 컴포넌트는 이 패턴이 요구하는 클라이언트 런타임 동작을 제공하지 못하기 때문에 작동하지 않습니다. 대신 이름을 가진 슬롯을 사용합니다.
 :::
 
-## 프레임워크 컴포넌트 중 Astro 컴포넌트를 사용할 수 있나요?
+## 프레임워크 컴포넌트에서 Astro 컴포넌트를 사용할 수 있나요?
 
-UI 프레임워크 컴포넌트는 해당 프레임워크의 '아일랜드 (섬)'가 됩니다. 이러한 컴포넌트는 해당 프레임워크의 유효한 코드로서 자체 가져오기 또는 패키지를 사용하여 완전히 작성해야 하며, UI 프레임워크 컴포넌트(예: `.jsx` 또는 `.svelte`) 내에서 .astro 컴포넌트를 가져올 수 없습니다.
+UI 프레임워크 컴포넌트는 해당 프레임워크의 '아일랜드'가 됩니다. 이러한 컴포넌트는 해당 프레임워크의 유효한 코드로서 자체 가져오기 또는 패키지를 사용하여 작성해야 하며, UI 프레임워크 컴포넌트 (예: `.jsx` 또는 `.svelte`)에서 .astro 컴포넌트를 가져올 수 없습니다.
 
-하지만 [Astro의 `<slot />` 패턴](/ko/basics/astro-components/#슬롯)을 이용하여 Astro 컴포넌트가 생성한 정적 콘텐츠를 **.astro 컴포넌트 내에서** 프레임워크 컴포넌트에 자식 요소로 전달할 수 있습니다.
+하지만 [Astro의 `<slot />` 패턴](/ko/basics/astro-components/#슬롯)을 사용하여 Astro 컴포넌트가 생성한 정적 콘텐츠를 **.astro 컴포넌트에서** 프레임워크 컴포넌트에 자식 요소로 전달할 수 있습니다.
 
 ```astro title="src/pages/astro-children.astro" {6}
 ---
@@ -227,7 +226,7 @@ import MyAstroComponent from '../components/MyAstroComponent.astro';
 </MyReactComponent>
 ```
 
-## Astro 컴포넌트에 하이드레이션을 할 수 있나요?
+## Astro 컴포넌트를 하이드레이션 할 수 있나요?
 
 `client:` 지시어를 사용하여 Astro 컴포넌트에 하이드레이션을 시도하면 오류가 발생합니다.
 

From cc7491825151c9553103c74ee24db77b3059a2f2 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 2 May 2024 09:45:31 +0900
Subject: [PATCH 2/9] fix: broken links

---
 src/content/docs/ko/basics/astro-components.mdx               | 2 +-
 src/content/docs/ko/basics/astro-syntax.mdx                   | 2 +-
 src/content/docs/ko/guides/images.mdx                         | 2 +-
 src/content/docs/ko/guides/integrations-guide/lit.mdx         | 2 +-
 src/content/docs/ko/guides/integrations-guide/markdoc.mdx     | 2 +-
 src/content/docs/ko/guides/integrations-guide/preact.mdx      | 2 +-
 src/content/docs/ko/guides/integrations-guide/react.mdx       | 2 +-
 src/content/docs/ko/guides/integrations-guide/solid-js.mdx    | 2 +-
 src/content/docs/ko/guides/integrations-guide/svelte.mdx      | 2 +-
 src/content/docs/ko/guides/integrations-guide/vue.mdx         | 2 +-
 src/content/docs/ko/guides/markdown-content.mdx               | 2 +-
 src/content/docs/ko/guides/troubleshooting.mdx                | 2 +-
 src/content/docs/ko/recipes/sharing-state-islands.mdx         | 4 ++--
 src/content/docs/ko/reference/errors/no-client-entrypoint.mdx | 2 +-
 src/content/docs/ko/tutorial/6-islands/1.mdx                  | 2 +-
 15 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/src/content/docs/ko/basics/astro-components.mdx b/src/content/docs/ko/basics/astro-components.mdx
index 2c0cab0ca1994..912e1a977531e 100644
--- a/src/content/docs/ko/basics/astro-components.mdx
+++ b/src/content/docs/ko/basics/astro-components.mdx
@@ -10,7 +10,7 @@ Astro 컴포넌트는 매우 유연합니다. Astro 컴포넌트에는 헤더나
 
 Astro 컴포넌트에 대해 알아야 할 가장 중요한 점은 **클라이언트에서 렌더링되지 않는다**는 것입니다. 기본적으로 빌드 시 HTML로 렌더링되며, [서버 측 렌더링 (SSR)](/ko/guides/server-side-rendering/)을 사용하는 경우에는 사용자의 요청을 받을 때마다 HTML로 렌더링 됩니다. 컴포넌트 프런트매터에 JavaScript 코드를 포함할 수 있으며, 모든 내용은 사용자의 브라우저로 전송되는 최종 페이지에서 제거됩니다. 그 결과, JavaScript가 추가되지 않아 사이트가 더 빨라집니다.
 
-Astro 컴포넌트가 클라이언트 측에서 상호작용 해야하는 경우, Astro 컴포넌트에 [표준 HTML `<script>` 태그](/ko/guides/client-side-scripts/)를 추가하거나, [UI 프레임워크 컴포넌트](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션하기)를 사용할 수 있습니다.
+Astro 컴포넌트가 클라이언트 측에서 상호작용 해야하는 경우, Astro 컴포넌트에 [표준 HTML `<script>` 태그](/ko/guides/client-side-scripts/)를 추가하거나, [UI 프레임워크 컴포넌트](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션)를 사용할 수 있습니다.
 
 ## 컴포넌트 구조
 
diff --git a/src/content/docs/ko/basics/astro-syntax.mdx b/src/content/docs/ko/basics/astro-syntax.mdx
index 8596a40ee0738..72244b7c61b32 100644
--- a/src/content/docs/ko/basics/astro-syntax.mdx
+++ b/src/content/docs/ko/basics/astro-syntax.mdx
@@ -118,7 +118,7 @@ const Component = MyComponent;
 
 - **변수 이름은 대문자로 시작해야 합니다.** 예를 들어 `element` 대신 `Element`를 사용하세요. 그렇지 않으면 Astro는 변수 이름을 리터럴 HTML 태그로 렌더링하는 것을 시도합니다.
 
-- **수화 지시어는 지원되지 않습니다.** [`client:*` 수화 지시어](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션하기)를 사용하면 Astro는 프로덕션을 위해 번들링할 컴포넌트를 알아야 하지만 동적 태그 패턴이 이를 알 수 없게 만듭니다.
+- **수화 지시어는 지원되지 않습니다.** [`client:*` 수화 지시어](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션)를 사용하면 Astro는 프로덕션을 위해 번들링할 컴포넌트를 알아야 하지만 동적 태그 패턴이 이를 알 수 없게 만듭니다.
 
 ### 프래그먼트
 
diff --git a/src/content/docs/ko/guides/images.mdx b/src/content/docs/ko/guides/images.mdx
index 242cdd4593ff8..945fe91f41c8f 100644
--- a/src/content/docs/ko/guides/images.mdx
+++ b/src/content/docs/ko/guides/images.mdx
@@ -635,7 +635,7 @@ export default function ReactImage() {
 
 다른 Astro 컴포넌트와 마찬가지로 `<Image />` 컴포넌트는 **UI 프레임워크 컴포넌트에서 사용할 수 없습니다**.
 
-그러나 `<Image />`에서 생성된 정적 콘텐츠를 `.astro` 파일 내 프레임워크 컴포넌트에 하위 항목으로 전달하거나 [명명된 `<slot/>`](/ko/guides/framework-components/#프레임워크-컴포넌트-중-astro-컴포넌트를-사용할-수-있나요)을 사용하여 전달할 수 있습니다.
+그러나 `<Image />`에서 생성된 정적 콘텐츠를 `.astro` 파일 내 프레임워크 컴포넌트에 하위 항목으로 전달하거나 [명명된 `<slot/>`](/ko/guides/framework-components/#프레임워크-컴포넌트에서-astro-컴포넌트를-사용할-수-있나요)을 사용하여 전달할 수 있습니다.
 
 ```astro title="ImageWrapper.astro"
 ---
diff --git a/src/content/docs/ko/guides/integrations-guide/lit.mdx b/src/content/docs/ko/guides/integrations-guide/lit.mdx
index 5d275c91766d8..9d87891fc2c0d 100644
--- a/src/content/docs/ko/guides/integrations-guide/lit.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/lit.mdx
@@ -188,4 +188,4 @@ Astro는 Lit 컴포넌트용 IntelliSense를 지원하지 않습니다.
 
 [astro-integration]: /ko/guides/integrations-guide/
 
-[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용하기
+[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용
diff --git a/src/content/docs/ko/guides/integrations-guide/markdoc.mdx b/src/content/docs/ko/guides/integrations-guide/markdoc.mdx
index 4880075273834..2493e176a5744 100644
--- a/src/content/docs/ko/guides/integrations-guide/markdoc.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/markdoc.mdx
@@ -225,7 +225,7 @@ Use tags like this fancy "aside" to add some _flair_ to your docs.
 
 ### 클라이언트 측 UI 컴포넌트 사용
 
-태그와 노드는 `.astro` 파일로 제한됩니다. Markdoc에 클라이언트 측 UI 컴포넌트를 포함하려면 원하는 `client:` 지시어와 함께 [프레임워크 컴포넌트를 렌더링하는 래퍼 `.astro` 컴포넌트를 사용](/ko/guides/framework-components/#프레임워크-컴포넌트-중첩하기)하세요.
+태그와 노드는 `.astro` 파일로 제한됩니다. Markdoc에 클라이언트 측 UI 컴포넌트를 포함하려면 원하는 `client:` 지시어와 함께 [프레임워크 컴포넌트를 렌더링하는 래퍼 `.astro` 컴포넌트를 사용](/ko/guides/framework-components/#프레임워크-컴포넌트-중첩)하세요.
 
 이 예시는 React `Aside.tsx` 컴포넌트를 `ClientAside.astro` 컴포넌트로 래핑합니다.
 
diff --git a/src/content/docs/ko/guides/integrations-guide/preact.mdx b/src/content/docs/ko/guides/integrations-guide/preact.mdx
index e1d8657ce8af3..0bc9005f485a1 100644
--- a/src/content/docs/ko/guides/integrations-guide/preact.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/preact.mdx
@@ -193,4 +193,4 @@ export default defineConfig({
 
 [astro-integration]: /ko/guides/integrations-guide/
 
-[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용하기
+[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용
diff --git a/src/content/docs/ko/guides/integrations-guide/react.mdx b/src/content/docs/ko/guides/integrations-guide/react.mdx
index 3625798539972..97a074728f795 100644
--- a/src/content/docs/ko/guides/integrations-guide/react.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/react.mdx
@@ -173,4 +173,4 @@ export default defineConfig({
 
 [astro-integration]: /ko/guides/integrations-guide/
 
-[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용하기
+[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용
diff --git a/src/content/docs/ko/guides/integrations-guide/solid-js.mdx b/src/content/docs/ko/guides/integrations-guide/solid-js.mdx
index ff4de29612b55..6d43cc7712eb7 100644
--- a/src/content/docs/ko/guides/integrations-guide/solid-js.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/solid-js.mdx
@@ -170,7 +170,7 @@ function CharacterName() {
 
 [astro-integration]: /ko/guides/integrations-guide/
 
-[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용하기
+[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용
 
 [astro-client-only]: /ko/reference/directives-reference/#clientonly
 
diff --git a/src/content/docs/ko/guides/integrations-guide/svelte.mdx b/src/content/docs/ko/guides/integrations-guide/svelte.mdx
index c63c5463c4e88..dc950080df447 100644
--- a/src/content/docs/ko/guides/integrations-guide/svelte.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/svelte.mdx
@@ -154,4 +154,4 @@ export default {
 
 [astro-integration]: /ko/guides/integrations-guide/
 
-[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용하기
+[astro-ui-frameworks]: /ko/guides/framework-components/#프레임워크-컴포넌트-사용
diff --git a/src/content/docs/ko/guides/integrations-guide/vue.mdx b/src/content/docs/ko/guides/integrations-guide/vue.mdx
index 95199bd65b197..adb8c65db4da9 100644
--- a/src/content/docs/ko/guides/integrations-guide/vue.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/vue.mdx
@@ -92,7 +92,7 @@ export default defineConfig({
 
 ## 시작하기
 
-Astro에서 첫 번째 Vue 컴포넌트를 사용하려면 [UI 프레임워크 문서](/ko/guides/framework-components/#프레임워크-컴포넌트-사용하기)로 이동합니다. 다음을 확인할 수 있습니다.
+Astro에서 첫 번째 Vue 컴포넌트를 사용하려면 [UI 프레임워크 문서](/ko/guides/framework-components/#프레임워크-컴포넌트-사용)로 이동합니다. 다음을 확인할 수 있습니다.
 
 * 📦 프레임워크 컴포넌트가 로드되는 방식,
 * 💧 클라이언트 측 하이드레이션 옵션,
diff --git a/src/content/docs/ko/guides/markdown-content.mdx b/src/content/docs/ko/guides/markdown-content.mdx
index 99ee1200b6831..2d205f8099086 100644
--- a/src/content/docs/ko/guides/markdown-content.mdx
+++ b/src/content/docs/ko/guides/markdown-content.mdx
@@ -158,7 +158,7 @@ title: 'My first MDX post'
 
 ### MDX에서 컴포넌트 사용
 
-MDX 통합을 설치한 후 다른 Astro 컴포넌트에서 사용하는 것처럼 [Astro 컴포넌트](/ko/basics/astro-components/#컴포넌트-props)와 [UI 프레임워크 컴포넌트](/ko/guides/framework-components/#프레임워크-컴포넌트-사용하기)를 MDX (`.mdx`) 파일로 가져와 사용할 수 있습니다.
+MDX 통합을 설치한 후 다른 Astro 컴포넌트에서 사용하는 것처럼 [Astro 컴포넌트](/ko/basics/astro-components/#컴포넌트-props)와 [UI 프레임워크 컴포넌트](/ko/guides/framework-components/#프레임워크-컴포넌트-사용)를 MDX (`.mdx`) 파일로 가져와 사용할 수 있습니다.
 
 필요한 경우 UI 프레임워크 컴포넌트에 `client:directive`를 포함하는 것을 잊지 마세요!
 
diff --git a/src/content/docs/ko/guides/troubleshooting.mdx b/src/content/docs/ko/guides/troubleshooting.mdx
index ef248af8b82fa..c2aa2d3d238a6 100644
--- a/src/content/docs/ko/guides/troubleshooting.mdx
+++ b/src/content/docs/ko/guides/troubleshooting.mdx
@@ -127,7 +127,7 @@ Astro 컴포넌트는 서버에서 실행되므로 프런트매터에서 이러
 
 컴포넌트가 렌더링 중이지만 (위 참조) 사용자 상호 작용에 응답하지 않는 경우 컴포넌트를 수화하기 위한 [`client:*` 지시어](/ko/reference/directives-reference/#클라이언트-지시어)가 누락되었을 수 있습니다.
 
-기본적으로 [UI 프레임워크 컴포넌트는 클라이언트에서 수화되지 않습니다](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션하기). `client:*` 지시어가 제공되지 않으면 해당 HTML이 JavaScript 없이 페이지에 렌더링됩니다.
+기본적으로 [UI 프레임워크 컴포넌트는 클라이언트에서 수화되지 않습니다](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션). `client:*` 지시어가 제공되지 않으면 해당 HTML이 JavaScript 없이 페이지에 렌더링됩니다.
 
 :::tip
 [Astro 컴포넌트](/ko/basics/astro-components/)는 클라이언트 측 런타임이 없는 HTML 전용 템플릿 컴포넌트입니다. 그러나 Astro 컴포넌트 템플릿에서 `<script>` 태그를 사용하여 전역 범위에서 실행되는 브라우저에 JavaScript를 보낼 수 있습니다.
diff --git a/src/content/docs/ko/recipes/sharing-state-islands.mdx b/src/content/docs/ko/recipes/sharing-state-islands.mdx
index c076465d00ab3..cc56e2389a298 100644
--- a/src/content/docs/ko/recipes/sharing-state-islands.mdx
+++ b/src/content/docs/ko/recipes/sharing-state-islands.mdx
@@ -12,7 +12,7 @@ import RecipeLinks from "~/components/RecipeLinks.astro"
 
 [아일랜드 아키텍처 / 부분 수화](/ko/concepts/islands/)를 사용하여 Astro 웹 사이트를 구축할 때 다음 문제에 직면했을 수 있습니다: **컴포넌트 간 상태를 공유하고 싶습니다.**
 
-React 또는 Vue와 같은 UI 프레임워크는 다른 컴포넌트가 사용하도록 ["context" providers](https://ko.react.dev/learn/passing-data-deeply-with-context)를 권장할 수 있습니다. 하지만 Astro 또는 Markdown에서 [컴포넌트를 부분적으로 수화](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션하기)하는 경우 이러한 컨텍스트 래퍼를 사용할 수 없습니다.
+React 또는 Vue와 같은 UI 프레임워크는 다른 컴포넌트가 사용하도록 ["context" providers](https://ko.react.dev/learn/passing-data-deeply-with-context)를 권장할 수 있습니다. 하지만 Astro 또는 Markdown에서 [컴포넌트를 부분적으로 수화](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션)하는 경우 이러한 컨텍스트 래퍼를 사용할 수 없습니다.
 
 Astro는 공유 클라이언트 측 스토리지를 위한 다른 솔루션인 [**Nano Stores**](https://github.com/nanostores/nanostores)를 권장합니다.
 
@@ -37,7 +37,7 @@ Astro는 공유 클라이언트 측 스토리지를 위한 다른 솔루션인 [
 
 Nano Stores는 서버 측 컴포넌트에서 가져오고, 쓰고, 읽을 수 _있지만_ **권장하지는 않습니다!** 이는 몇 가지 제한 사항으로 인해 발생합니다.
 
-- `.astro` 파일이나 [수화되지 않은 컴포넌트](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션하기)에서 저장소에 쓰는 것은 [클라이언트 측 컴포넌트](/ko/reference/directives-reference/#클라이언트-지시어)에서 받은 값에 영향을 주지 _않습니다._
+- `.astro` 파일이나 [수화되지 않은 컴포넌트](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션)에서 저장소에 쓰는 것은 [클라이언트 측 컴포넌트](/ko/reference/directives-reference/#클라이언트-지시어)에서 받은 값에 영향을 주지 _않습니다._
 - Nano Stores를 클라이언트 측 컴포넌트에 "prop"으로 전달할 수 없습니다. 
 - Astro 컴포넌트는 다시 렌더링되지 않으므로 `.astro` 파일의 변경 사항 저장을 구독할 수 없습니다.
 
diff --git a/src/content/docs/ko/reference/errors/no-client-entrypoint.mdx b/src/content/docs/ko/reference/errors/no-client-entrypoint.mdx
index ffcc29627b011..147b3695c1235 100644
--- a/src/content/docs/ko/reference/errors/no-client-entrypoint.mdx
+++ b/src/content/docs/ko/reference/errors/no-client-entrypoint.mdx
@@ -13,4 +13,4 @@ Astro는 클라이언트에서 컴포넌트를 수화하려고 시도했지만,
 **더 보기:**
 
 -  [addRenderer 옵션](/ko/reference/integrations-reference/#addrenderer-옵션)
--  [프레임워크 컴포넌트 수화](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션하기)
\ No newline at end of file
+-  [프레임워크 컴포넌트 수화](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션)
\ No newline at end of file
diff --git a/src/content/docs/ko/tutorial/6-islands/1.mdx b/src/content/docs/ko/tutorial/6-islands/1.mdx
index e96c008b6a211..a98162ebe4044 100644
--- a/src/content/docs/ko/tutorial/6-islands/1.mdx
+++ b/src/content/docs/ko/tutorial/6-islands/1.mdx
@@ -219,6 +219,6 @@ import SvelteCounter from '../components/SvelteCounter.svelte';
 
 - [Astro 통합 안내서](/ko/guides/integrations-guide/)
 
-- [Astro에서 UI 프레임워크 컴포넌트 사용](/ko/guides/framework-components/#프레임워크-컴포넌트-사용하기)
+- [Astro에서 UI 프레임워크 컴포넌트 사용](/ko/guides/framework-components/#프레임워크-컴포넌트-사용)
 
 - [Astro 클라이언트 지시어 참조](/ko/reference/directives-reference/#클라이언트-지시어)

From 0fa273b9610824f5a5fed8cd542ee0ab262c28a4 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 16 May 2024 11:59:49 +0900
Subject: [PATCH 3/9] i18n(ko-KR): update `images.mdx`

---
 src/content/docs/ko/guides/images.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/ko/guides/images.mdx b/src/content/docs/ko/guides/images.mdx
index 945fe91f41c8f..b1599130c4038 100644
--- a/src/content/docs/ko/guides/images.mdx
+++ b/src/content/docs/ko/guides/images.mdx
@@ -489,7 +489,7 @@ export default defineConfig({
 
 ## Markdown 파일의 이미지
 
-`.md` 파일에 표준 Markdown `![alt](src)` 구문을 사용하세요. 이 구문은 Astro의 [이미지 서비스 API](/ko/reference/image-service-reference/)와 함께 작동하여 로컬 이미지와 승인된 원격 이미지를 최적화합니다.
+`.md` 파일에 표준 Markdown `![alt](src)` 구문을 사용하세요. 이 구문은 Astro의 [이미지 서비스 API](/ko/reference/image-service-reference/)와 함께 작동하여 `src/`에 저장된 로컬 이미지를 최적화합니다. 원격 이미지와 `public/` 폴더에 저장된 이미지는 최적화되지 않습니다.
 
 ```md
 <!-- src/pages/post-1.md -->

From b12091c53e13d8227d5fe2adcbd653d8d32d2327 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 16 May 2024 12:03:28 +0900
Subject: [PATCH 4/9] i18n(ko-KR): update `lit.mdx`

---
 .../docs/ko/guides/integrations-guide/lit.mdx | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/src/content/docs/ko/guides/integrations-guide/lit.mdx b/src/content/docs/ko/guides/integrations-guide/lit.mdx
index 9d87891fc2c0d..5c7099b466eba 100644
--- a/src/content/docs/ko/guides/integrations-guide/lit.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/lit.mdx
@@ -127,6 +127,34 @@ import { MyElement } from '../components/my-element.js';
 Lit에는 `HTMLElement` 및 `customElements`와 같은 브라우저 전역 항목이 있어야 합니다. 이러한 이유로 Lit 렌더러는 Lit가 실행될 수 있도록 이러한 전역 변수를 서버에 심습니다. 이로 인해 잘못 작동하는 라이브러리가 *실행될 수* 있습니다.
 :::
 
+### 실험적 Decorators
+
+[Lit의 실험적 Decorators](https://lit.dev/docs/components/decorators/)를 사용하려면 `tsconfig.json` 파일에 다음을 추가하세요.
+
+```json title="tsconfig.json" add={3}
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+  }
+}
+```
+
+이를 통해 `@customElement` 및 `@state`와 같은 실험적 Decorators를 사용하여 맞춤 속성을 등록하고 Lit 컴포넌트에 상태 속성을 정의할 수 있습니다.
+
+```ts title="src/components/my-element.ts"
+import { LitElement, html } from "lit";
+import { customElement, state } from "lit/decorators.js";
+
+@customElement("my-element")
+export class MyElement extends LitElement {
+    @state() name = "my-element";
+
+    override render() {
+        return html`<p>Hello world! From ${this.name}</p>`;
+    }
+}
+```
+
 ### 폴리필 및 하이드레이션
 
 렌더러는 Declarative Shadow DOM이 없는 브라우저에서 지원하기 위해 적절한 폴리필 추가를 자동으로 처리합니다. 폴리필은 약 *1.5kB*입니다. 브라우저가 Declarative Shadow DOM을 지원하는 경우 250바이트 미만이 로드됩니다 (기능 감지 지원을 위해).

From 0bc071446d1e4dc92fb59bee78b8154151432220 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 16 May 2024 12:07:09 +0900
Subject: [PATCH 5/9] i18n(ko-KR): update `preact.mdx`

---
 .../ko/guides/integrations-guide/preact.mdx     | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/content/docs/ko/guides/integrations-guide/preact.mdx b/src/content/docs/ko/guides/integrations-guide/preact.mdx
index 0bc9005f485a1..bfc2a2ed22d92 100644
--- a/src/content/docs/ko/guides/integrations-guide/preact.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/preact.mdx
@@ -8,6 +8,7 @@ i18nReady: true
 ---
 
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
+import Since from '~/components/Since.astro';
 
 이 **[Astro 통합][astro-integration]** 을 통해 [Preact](https://preactjs.com/) 컴포넌트에 대한 서버 측 렌더링 및 클라이언트 측 하이드레이션이 가능해졌습니다.
 
@@ -150,6 +151,22 @@ React 컴포넌트 라이브러리를 가져올 때 `react` 및 `react-dom` 종
 현재 `compat` 옵션은 코드를 ESM으로 내보내는 React 라이브러리에서만 작동합니다. 빌드 시 오류가 발생하면 `astro.config.mjs` 파일의 `vite.ssr.noExternal: ['the-react-library']`에 라이브러리를 추가해 보세요.
 :::
 
+### devtools
+
+<p><Since pkg="@astrojs/preact" v="3.3.0" /></p>
+
+`devtools: true`가 포함된 객체를 `preact()` 통합 구성에 전달하여 개발 모드에서 [Preact devtools](https://preactjs.github.io/preact-devtools/)를 활성화할 수 있습니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+import preact from '@astrojs/preact';
+
+export default defineConfig({
+  // ...
+  integrations: [preact({ devtools: true })],
+});
+```
+
 ## 옵션
 
 ### 여러 JSX 프레임워크 결합

From efc91033c57674d918f3d530ea5b9b2344beffc2 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 16 May 2024 12:12:15 +0900
Subject: [PATCH 6/9] i18n(ko-KR): update `react.mdx`

---
 src/content/docs/ko/guides/integrations-guide/react.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/ko/guides/integrations-guide/react.mdx b/src/content/docs/ko/guides/integrations-guide/react.mdx
index 97a074728f795..ee0280eb19d42 100644
--- a/src/content/docs/ko/guides/integrations-guide/react.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/react.mdx
@@ -153,7 +153,7 @@ import ReactComponent from './ReactComponent';
 
 예를 들어 특정 요소를 다른 위치에 배치할 수 있도록 하나 이상의 하위 요소가 전달될 것으로 *예상*하는 라이브러리를 사용하는 경우 이것이 차단 요인이 될 수 있습니다.
 
-실험적 플래그 `experimentalReactChildren`을 설정하여 Astro에게 항상 자식을 React vnode로 React에 전달하도록 지시할 수 있습니다. 여기에는 약간의 런타임 비용이 있지만 호환성에 도움이 될 수 있습니다.
+실험적 플래그 `experimentalReactChildren`을 설정하여 React의 자식 요소로 항상 React 가상 DOM 노드를 전달하도록 Astro에게 지시할 수 있습니다. 이는 약간의 런타임 비용이 있지만 호환성에 도움이 될 수 있습니다.
 
 React 통합 구성에서 이 옵션을 활성화할 수 있습니다.
 

From 21d9a4bd925810c0afc2cd087a0320c0c446af3e Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 16 May 2024 12:15:14 +0900
Subject: [PATCH 7/9] i18n(ko-KR): update `solid-js.mdx`

---
 .../ko/guides/integrations-guide/solid-js.mdx | 39 ++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/src/content/docs/ko/guides/integrations-guide/solid-js.mdx b/src/content/docs/ko/guides/integrations-guide/solid-js.mdx
index 6d43cc7712eb7..10c13863110ec 100644
--- a/src/content/docs/ko/guides/integrations-guide/solid-js.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/solid-js.mdx
@@ -6,7 +6,8 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int
 category: renderer
 i18nReady: true
 ---
-import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
+import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
+import Since from '~/components/Since.astro';
 
 이 **[Astro 통합][astro-integration]** 을 통해 [SolidJS](https://www.solidjs.com/) 컴포넌트에 대한 서버 측 렌더링 및 클라이언트 측 하이드레이션이 가능해졌습니다.
 
@@ -98,6 +99,42 @@ Astro에서 첫 번째 SolidJS 컴포넌트를 사용하려면 [UI 프레임워
 * 💧 클라이언트 측 하이드레이션 옵션
 * 🤝 프레임워크를 함께 혼합하고 중첩할 수 있는 기회
 
+## 구성
+
+### devtools
+
+<p><Since pkg="@astrojs/solid-js" v="4.2.0" /></p>
+
+`devtools: true`가 포함된 객체를 `solid()` 통합 구성에 전달하고 프로젝트 종속성에 `solid-devtools`를 추가하여 개발 모드에서 [Solid DevTools](https://github.com/thetarnav/solid-devtools)를 활성화할 수 있습니다.
+
+<PackageManagerTabs>
+  <Fragment slot="npm">
+  ```sh
+  npm install solid-devtools
+  ```
+  </Fragment>
+  <Fragment slot="pnpm">
+  ```sh
+  pnpm add solid-devtools
+  ```
+  </Fragment>
+  <Fragment slot="yarn">
+  ```sh
+  yarn add solid-devtools
+  ```
+  </Fragment>
+</PackageManagerTabs>
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+import solid from '@astrojs/solid';
+
+export default defineConfig({
+  // ...
+  integrations: [solid({ devtools: true })],
+});
+```
+
 ## 옵션
 
 ### 여러 JSX 프레임워크 결합

From b76c5f955add3e3993cff3305639fada340d29a0 Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 16 May 2024 12:16:55 +0900
Subject: [PATCH 8/9] i18n(ko-KR): update `vue.mdx`

---
 .../docs/ko/guides/integrations-guide/vue.mdx | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/src/content/docs/ko/guides/integrations-guide/vue.mdx b/src/content/docs/ko/guides/integrations-guide/vue.mdx
index adb8c65db4da9..cfab6178a147f 100644
--- a/src/content/docs/ko/guides/integrations-guide/vue.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/vue.mdx
@@ -6,7 +6,8 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int
 category: renderer
 i18nReady: true
 ---
-import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
+import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
+import Since from '~/components/Since.astro';
 
 이 **[Astro 통합](/ko/guides/integrations-guide/)**을 통해 [Vue 3](https://vuejs.org/) 컴포넌트에 대한 서버 측 랜더링 및 클라이언트 측 하이드레이션이 가능해집니다.
 
@@ -190,3 +191,19 @@ export default defineConfig({
   ],
 });
 ```
+
+### devtools
+
+<p><Since pkg="@astrojs/vue" v="4.2.0" /></p>
+
+`devtools: true`가 포함된 객체를 `vue()` 통합 구성에 전달하여 개발 모드에서 [Vue DevTools](https://devtools-next.vuejs.org/)를 활성화할 수 있습니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+import vue from '@astrojs/vue';
+
+export default defineConfig({
+  // ...
+  integrations: [vue({ devtools: true })],
+});
+```
\ No newline at end of file

From 3a71c519fe48eab90f76931ae2a73b412f5b751f Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Thu, 16 May 2024 12:27:46 +0900
Subject: [PATCH 9/9] i18n(ko-KR): update `sharing-state-island.mdx`

---
 src/content/docs/ko/guides/integrations-guide/markdoc.mdx | 2 +-
 src/content/docs/ko/recipes/sharing-state-islands.mdx     | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/content/docs/ko/guides/integrations-guide/markdoc.mdx b/src/content/docs/ko/guides/integrations-guide/markdoc.mdx
index 2493e176a5744..943dd341099b1 100644
--- a/src/content/docs/ko/guides/integrations-guide/markdoc.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/markdoc.mdx
@@ -6,9 +6,9 @@ githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/int
 category: other
 i18nReady: true
 ---
-
 import { FileTree } from '@astrojs/starlight/components';
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
+import { Steps } from '@astrojs/starlight/components';
 import ReadMore from '~/components/ReadMore.astro';
 
 이 **[Astro 통합][astro-integration]** 을 통해 [Markdoc](https://markdoc.dev/)을 사용하여 컴포넌트, 페이지 및 콘텐츠 컬렉션 항목을 생성할 수 있습니다.
diff --git a/src/content/docs/ko/recipes/sharing-state-islands.mdx b/src/content/docs/ko/recipes/sharing-state-islands.mdx
index cc56e2389a298..bf25e63d4a633 100644
--- a/src/content/docs/ko/recipes/sharing-state-islands.mdx
+++ b/src/content/docs/ko/recipes/sharing-state-islands.mdx
@@ -35,8 +35,7 @@ Astro는 공유 클라이언트 측 스토리지를 위한 다른 솔루션인 [
 <details>
 <summary>**🙋 `.astro` 파일이나 기타 서버 측 컴포넌트에서 Nano Stores를 사용할 수 있나요?**</summary>
 
-Nano Stores는 서버 측 컴포넌트에서 가져오고, 쓰고, 읽을 수 _있지만_ **권장하지는 않습니다!** 이는 몇 가지 제한 사항으로 인해 발생합니다.
-
+Nano Stores는 `<script>` 태그에서 [`.astro` 컴포넌트 간 상태를 공유](/ko/recipes/sharing-state)하는 데 사용할 수 있습니다. 그러나 서버 측 컴포넌트 프런트매터에서 Nano Stores를 사용하는 것은 다음과 같은 제한 사항으로 인해 권장되지 않습니다.
 - `.astro` 파일이나 [수화되지 않은 컴포넌트](/ko/guides/framework-components/#인터랙티브-컴포넌트-하이드레이션)에서 저장소에 쓰는 것은 [클라이언트 측 컴포넌트](/ko/reference/directives-reference/#클라이언트-지시어)에서 받은 값에 영향을 주지 _않습니다._
 - Nano Stores를 클라이언트 측 컴포넌트에 "prop"으로 전달할 수 없습니다. 
 - Astro 컴포넌트는 다시 렌더링되지 않으므로 `.astro` 파일의 변경 사항 저장을 구독할 수 없습니다.