From 030f33c58356ac9f23069460d1e19323873eb0dc Mon Sep 17 00:00:00 2001
From: Junseong Park <39112954+jsparkdev@users.noreply.github.com>
Date: Fri, 29 May 2026 11:45:23 +0900
Subject: [PATCH 1/5] Update index.mdx
---
src/content/docs/ko/guides/migrate-to-astro/index.mdx | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/src/content/docs/ko/guides/migrate-to-astro/index.mdx b/src/content/docs/ko/guides/migrate-to-astro/index.mdx
index e0b42acffd743..416101ed5c1f8 100644
--- a/src/content/docs/ko/guides/migrate-to-astro/index.mdx
+++ b/src/content/docs/ko/guides/migrate-to-astro/index.mdx
@@ -7,9 +7,9 @@ i18nReady: true
---
import MigrationGuidesNav from '~/components/MigrationGuidesNav.astro';
-**여러분의 사이트를 Astro로 전환할 준비가 되셨나요?** 마이그레이션 팁에 대한 안내서 중 하나를 참조하세요.
+**여러분의 사이트를 Astro로 전환할 준비가 되셨나요?** 마이그레이션 팁에 대한 가이드 중 하나를 참조하세요.
-## 마이그레이션 안내서
+## 마이그레이션 가이드
@@ -27,7 +27,7 @@ Astro는 성능, 단순성, 프레임워크에 내장된 많은 기능 등 다
- Tailwind를 포함한 [CSS 스타일시트 또는 라이브러리](/ko/guides/styling/)
-- 기존 [remark 및 rehype 플러그인](/ko/guides/markdown-content/#markdown-플러그인)을 사용하여 구성되는 [Markdown/MDX 파일](/ko/guides/markdown-content/)
+- 플러그인을 지원하고 [구성 가능한 Markdown 프로세서](/ko/guides/markdown-content/#markdown-플러그인)가 포함된 [Markdown/MDX 파일](/ko/guides/markdown-content/)
- 통합 또는 API를 통한 [CMS 콘텐츠](/ko/guides/cms/)
From 1256e92e59f5b6977a99db5dfd46f19033af844f Mon Sep 17 00:00:00 2001
From: Junseong Park <39112954+jsparkdev@users.noreply.github.com>
Date: Fri, 29 May 2026 11:46:25 +0900
Subject: [PATCH 2/5] Update astro-content.mdx
---
src/content/docs/ko/reference/modules/astro-content.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/content/docs/ko/reference/modules/astro-content.mdx b/src/content/docs/ko/reference/modules/astro-content.mdx
index b148cd6e52594..58c19cdd37cb0 100644
--- a/src/content/docs/ko/reference/modules/astro-content.mdx
+++ b/src/content/docs/ko/reference/modules/astro-content.mdx
@@ -326,7 +326,7 @@ const enterpriseRelatedPosts = await getEntries(enterprisePost.data.relatedPosts
- `` - Astro 파일에서 문서의 내용을 렌더링하는 데 사용되는 컴포넌트입니다.
- `headings` - Markdown 및 MDX 가져오기 시 [Astro의 `getHeadings()` 유틸리티를 반영](/ko/guides/markdown-content/#사용-가능한-속성)하여 생성된 헤딩 목록입니다.
-- `remarkPluginFrontmatter` - [remark 또는 rehype 플러그인이 적용된 후](/ko/guides/markdown-content/#프로그래밍-방식으로-프런트매터-수정하기) 수정된 프론트매터 객체입니다. `any` 타입으로 설정됩니다.
+- `remarkPluginFrontmatter` - [Markdown 플러그인이 적용된 후](/ko/guides/markdown-content/#프로그래밍-방식으로-프런트매터-수정하기) 수정된 프론트매터 객체입니다. `any` 타입으로 설정됩니다.
```astro title="src/pages/blog/entry-1.astro"
---
From 7158a516849672ab647aed3c61ded6df467928af Mon Sep 17 00:00:00 2001
From: Junseong Park <39112954+jsparkdev@users.noreply.github.com>
Date: Fri, 29 May 2026 11:49:51 +0900
Subject: [PATCH 3/5] Update adapter-reference.mdx
---
.../docs/ko/reference/adapter-reference.mdx | 33 +++++++++++++++++++
1 file changed, 33 insertions(+)
diff --git a/src/content/docs/ko/reference/adapter-reference.mdx b/src/content/docs/ko/reference/adapter-reference.mdx
index df28302177dc5..9ccfe16a35b22 100644
--- a/src/content/docs/ko/reference/adapter-reference.mdx
+++ b/src/content/docs/ko/reference/adapter-reference.mdx
@@ -853,6 +853,39 @@ export default function createIntegration() {
}
```
+### `preserveBuildServerDir`
+
+
+
+**타입:** `boolean`
+**기본값:** `false`
+
+
+
+`true`로 설정하면 정적 빌드는 서버 출력을 `outDir`에 직접 생성하는 대신 `client/server` 디렉터리 구조를 유지합니다. 이를 통해 정적 빌드에서도 서버 파일에 `build.server`를 사용하게 되어 서버 빌드와의 일관성을 유지할 수 있습니다.
+
+이 옵션은 빌드 출력 유형과 관계없이 일관된 `dist/client/` 및 `dist/server/` 구조를 요구하는 어댑터에 유용합니다. 예를 들어, 정적 사이트라도 서버 엔트리가 필요한 서버 아일랜드나 이미지 엔드포인트를 포함할 수 있는 경우에 적합합니다.
+
+```js title="my-adapter.mjs" ins={10-12}
+export default function createIntegration() {
+ return {
+ name: '@example/my-adapter',
+ hooks: {
+ 'astro:config:done': ({ setAdapter }) => {
+ setAdapter({
+ name: '@example/my-adapter',
+ entrypointResolution: 'auto',
+ serverEntrypoint: '@example/my-adapter/server.js',
+ adapterFeatures: {
+ preserveBuildServerDir: true,
+ },
+ });
+ },
+ },
+ };
+}
+```
+
## 어댑터 타입 참조
다음 타입들은 `astro` 모듈에서 가져올 수 있습니다:
From ac22b9799c8074f5bc59e019eb56a543584af12b Mon Sep 17 00:00:00 2001
From: Junseong Park <39112954+jsparkdev@users.noreply.github.com>
Date: Fri, 29 May 2026 11:50:42 +0900
Subject: [PATCH 4/5] Update content-loader-reference.mdx
---
src/content/docs/ko/reference/content-loader-reference.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/content/docs/ko/reference/content-loader-reference.mdx b/src/content/docs/ko/reference/content-loader-reference.mdx
index 684c37f441a96..4bafea5468646 100644
--- a/src/content/docs/ko/reference/content-loader-reference.mdx
+++ b/src/content/docs/ko/reference/content-loader-reference.mdx
@@ -1304,7 +1304,7 @@ ID로 저장소에 엔트리가 존재하는지 확인합니다.
**타입:** `Record`
-파일에서 파싱된 원본 프론트매터를 설명합니다. 여기에는 [remark 플러그인에서 프로그래밍 방식으로 주입된 데이터](/ko/guides/markdown-content/#프로그래밍-방식으로-프런트매터-수정하기)가 포함될 수 있습니다.
+파일에서 파싱된 원본 프론트매터를 설명합니다. 여기에는 [Markdown 플러그인에서 프로그래밍 방식으로 주입된 데이터](/ko/guides/markdown-content/#프로그래밍-방식으로-프런트매터-수정하기)가 포함될 수 있습니다.
## 라이브 로더 API
From f4c9c9e70f88d988aeb3369abc1d3d0214fc99b2 Mon Sep 17 00:00:00 2001
From: Junseong Park <39112954+jsparkdev@users.noreply.github.com>
Date: Fri, 29 May 2026 11:51:09 +0900
Subject: [PATCH 5/5] Update programmatic-reference.mdx
---
src/content/docs/ko/reference/programmatic-reference.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/content/docs/ko/reference/programmatic-reference.mdx b/src/content/docs/ko/reference/programmatic-reference.mdx
index df5a9b193e494..ce24b6145c6a8 100644
--- a/src/content/docs/ko/reference/programmatic-reference.mdx
+++ b/src/content/docs/ko/reference/programmatic-reference.mdx
@@ -190,7 +190,7 @@ await sync({
Astro 구성 객체와 유효한 Astro 구성 옵션 세트가 포함된 부분 객체를 받아 두 값을 결합한 유효한 Astro 구성을 반환합니다.
-- 배열은 연결됩니다. (통합 및 remark 플러그인 포함)
+- 배열은 연결됩니다. (통합 포함)
- 객체는 재귀적으로 병합됩니다.
- Vite 옵션은 기본 `isRoot` 플래그와 함께 [Vite의 `mergeConfig()` 함수](https://ko.vite.dev/guide/api-javascript#mergeconfig)를 사용하여 병합됩니다.
- 함수로 제공될 수 있는 옵션은 이러한 동일한 규칙으로 두 구성의 반환 값을 재귀적으로 병합하는 새 함수로 래핑됩니다.