From ae6c6400b27945b8e6d99fcf7bbea85d2cd1c1c9 Mon Sep 17 00:00:00 2001
From: Junseong Park <to@jspark.dev>
Date: Fri, 26 Sep 2025 12:09:28 +0900
Subject: [PATCH] i18n(ko-KR): create `fail-on-prerender-conflict.mdx`

---
 .../fail-on-prerender-conflict.mdx            | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 src/content/docs/ko/reference/experimental-flags/fail-on-prerender-conflict.mdx

diff --git a/src/content/docs/ko/reference/experimental-flags/fail-on-prerender-conflict.mdx b/src/content/docs/ko/reference/experimental-flags/fail-on-prerender-conflict.mdx
new file mode 100644
index 0000000000000..da18e2d2e6a5b
--- /dev/null
+++ b/src/content/docs/ko/reference/experimental-flags/fail-on-prerender-conflict.mdx
@@ -0,0 +1,37 @@
+---
+title: 실험적 사전 렌더링 충돌 오류
+sidebar:
+  label: 사전 렌더링 충돌 오류
+i18nReady: true
+---
+
+import Since from '~/components/Since.astro'
+
+<p>
+
+**타입:** `boolean`<br />
+**기본값:** `false`<br />
+<Since v="5.14.0" />
+</p>
+
+빌드 과정에서 사전 렌더링 충돌 경고를 오류로 전환합니다.
+
+Astro는 빌드 과정에서 동일한 출력 경로를 생성할 수 있는 여러 동적 라우트 간 충돌에 대해 경고합니다. 예를 들어 `/blog/[slug]`와 `/blog/[...all]` 모두 `/blog/post-1` 경로를 사전 렌더링하려고 시도합니다. 이러한 경우 Astro는 충돌하는 경로에 대해 [가장 높은 우선순위의 라우트](/ko/guides/routing/#라우트-우선-순위)만 렌더링합니다. 이를 통해 사이트는 성공적으로 빌드되지만, 일부 페이지가 예상치 못한 라우트로 렌더링된다는 사실을 발견할 수 있습니다.
+
+이 실험적 플래그가 설정되면, 빌드는 즉시 실패하며, 오류가 발생합니다. 이로 인해 라우팅 충돌을 즉시 해결해야 하며, Astro가 라우트를 의도한 대로 빌드하도록 보장합니다.
+
+이 동작을 활성화하려면 Astro 구성에 `experimental.failOnPrerenderConflict` 기능 플래그를 추가하세요.
+
+```js title="astro.config.mjs" ins={4-6}
+import { defineConfig } from "astro/config"
+
+defineConfig({
+	experimental: {
+		failOnPrerenderConflict: true,
+	},
+});
+```
+
+## 사용하기
+
+이 플래그를 활성화한 후에는 프로젝트 빌드 시 사전 렌더링된 라우트 충돌에 대한 오류가 발생할 수 있습니다. 이 경우 모호한 라우팅을 방지하기 위해 하나 이상의 [동적 라우트](/ko/guides/routing/#동적-라우트)를 업데이트해야 합니다.