diff --git a/src/content/docs/ko/guides/fonts.mdx b/src/content/docs/ko/guides/fonts.mdx
index 43895a39cfaa9..517508d20f5ce 100644
--- a/src/content/docs/ko/guides/fonts.mdx
+++ b/src/content/docs/ko/guides/fonts.mdx
@@ -11,7 +11,7 @@ import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
이 안내서는 프로젝트에 [웹 글꼴](https://developer.mozilla.org/ko/docs/Learn_web_development/Core/Text_styling/Web_fonts)을 추가하고 컴포넌트에서 사용하는 방법을 설명합니다.
-Astro는 통합되고, [완전히 사용자 정의 가능하며](/ko/reference/configuration-reference/), 타입 안정성을 갖춘 API를 통해 파일 시스템 및 다양한 글꼴 제공업체(예: Fontsource, Google)의 글꼴을 사용할 수 있는 방법을 제공합니다.
+Astro는 통합되고, [완전히 사용자 정의 가능하며](/ko/reference/configuration-reference/#fonts), 타입 안정성을 갖춘 API를 통해 파일 시스템 및 다양한 글꼴 제공업체(예: Fontsource, Google)의 글꼴을 사용할 수 있는 방법을 제공합니다.
웹 글꼴은 로드 시간과 렌더링 시간 모두에서 페이지 성능에 영향을 미칠 수 있습니다. 이 API는 프리로드 링크, 최적화된 대체 글꼴, 정해진 기본값 등 자동 [웹 글꼴 최적화](https://web.dev/learn/performance/optimize-web-fonts)를 통해 사이트 성능을 유지하는 데 도움을 줍니다. [일반적인 사용 예시를 참조하세요](#예시).
@@ -19,9 +19,9 @@ Astro는 통합되고, [완전히 사용자 정의 가능하며](/ko/reference/c
## 사용자 정의 글꼴 구성
-Astro 프로젝트에 사용자 정의 글꼴을 등록하는 것은 Astro 구성 파일의 [`fonts` 옵션](/ko/reference/configuration-reference/)을 통해 이루어집니다.
+Astro 프로젝트에 사용자 정의 글꼴을 등록하는 것은 Astro 구성 파일의 [`fonts` 옵션](/ko/reference/configuration-reference/#fonts)을 통해 이루어집니다.
-사용하려는 각 글꼴에 대해 [이름](/ko/reference/configuration-reference/), [CSS 변수](/ko/reference/configuration-reference/), 그리고 Astro 글꼴 제공업체를 지정해야 합니다.
+사용하려는 각 글꼴에 대해 [이름](/ko/reference/configuration-reference/#fontname), [CSS 변수](/ko/reference/configuration-reference/#fontcssvariable), 그리고 Astro 글꼴 제공업체를 지정해야 합니다.
Astro는 Adobe, Bunny, Fontshare, Fontsource, Google, Google Icons, NPM과 같은 [가장 인기 있는 글꼴 제공업체에 대한 내장 지원](/ko/reference/font-provider-reference/#built-in-providers)과 로컬 글꼴 파일 사용을 지원합니다. 또한 성능과 방문자 경험을 최적화하기 위해 [글꼴 구성을 추가로 사용자 정의할 수 있습니다](#세부적인-글꼴-구성).
@@ -175,7 +175,7 @@ Astro는 Google Fonts 및 기타 오픈 소스 글꼴 사용을 간소화하는
## 프로그래밍 방식으로 글꼴 데이터 접근
-[`fontData`](/ko/reference/modules/astro-assets/#fontdata) 객체를 사용하면 하위 수준의 글꼴 패밀리 데이터를 프로그래밍 방식으로 가져올 수 있습니다. 예를 들어, 적절한 [형식](/ko/reference/configuration-reference/) 구성과 결합하여 [satori](https://github.com/vercel/satori)를 사용하여 OpenGraph 이미지를 생성하기 위한 [API 라우트](/ko/guides/endpoints/#서버-엔드포인트-api-라우트)에서 사용할 수 있습니다:
+[`fontData`](/ko/reference/modules/astro-assets/#fontdata) 객체를 사용하면 하위 수준의 글꼴 패밀리 데이터를 프로그래밍 방식으로 가져올 수 있습니다. 예를 들어, 적절한 [형식](/ko/reference/configuration-reference/#fontformats) 구성과 결합하여 [satori](https://github.com/vercel/satori)를 사용하여 OpenGraph 이미지를 생성하기 위한 [API 라우트](/ko/guides/endpoints/#서버-엔드포인트-api-라우트)에서 사용할 수 있습니다:
```tsx title="src/pages/og.png.ts" {2} "fontData[\"--font-roboto\"]"
import type{ APIRoute } from "astro";
diff --git a/src/content/docs/ko/guides/integrations-guide/netlify.mdx b/src/content/docs/ko/guides/integrations-guide/netlify.mdx
index 5b106ce66dfa9..bc45db64da837 100644
--- a/src/content/docs/ko/guides/integrations-guide/netlify.mdx
+++ b/src/content/docs/ko/guides/integrations-guide/netlify.mdx
@@ -421,7 +421,7 @@ Netlify 구성에서 사전 렌더링된 페이지에 대한 사용자 정의
이 기능이 활성화되면, Astro 기능 (예: 콘텐츠 보안 정책)에서 제공하는 경우 어댑터는 [정적 헤더를 프레임워크 API 구성 파일](https://docs.netlify.com/frameworks-api/#headers)에 저장합니다.
-예를 들어, [콘텐츠 보안 정책](/ko/reference/configuration-reference/)이 활성화된 경우, `` 요소를 생성하는 대신 `staticHeaders`를 사용하여 CSP `headers`를 Netlify 구성에 추가할 수 있습니다.
+예를 들어, [콘텐츠 보안 정책](/ko/reference/configuration-reference/#securitycsp)이 활성화된 경우, `` 요소를 생성하는 대신 `staticHeaders`를 사용하여 CSP `headers`를 Netlify 구성에 추가할 수 있습니다.
```js title="astro.config.mjs" {9}
import { defineConfig } from 'astro/config';
diff --git a/src/content/docs/ko/guides/view-transitions.mdx b/src/content/docs/ko/guides/view-transitions.mdx
index f8855c38b0fde..2381740479807 100644
--- a/src/content/docs/ko/guides/view-transitions.mdx
+++ b/src/content/docs/ko/guides/view-transitions.mdx
@@ -461,7 +461,7 @@ import { ClientRouter } from "astro:transitions";
사이트 및 허용할 내용에 따라 필요한 검증의 방식이 달라집니다.
-사용자 입력을 `navigate()` API와 함께 사용하는 경우, Astro의 [콘텐츠 보안 정책](/ko/reference/configuration-reference/)을 활성화하여 교차 사이트 스크립팅 (XSS) 위험으로부터 보호하는 것을 고려해 보세요.
+사용자 입력을 `navigate()` API와 함께 사용하는 경우, Astro의 [콘텐츠 보안 정책](/ko/reference/configuration-reference/#securitycsp)을 활성화하여 교차 사이트 스크립팅 (XSS) 위험으로부터 보호하는 것을 고려해 보세요.
## 대체 옵션
diff --git a/src/content/docs/ko/reference/adapter-reference.mdx b/src/content/docs/ko/reference/adapter-reference.mdx
index 1b33353ccf077..d21f6cf7ab0cb 100644
--- a/src/content/docs/ko/reference/adapter-reference.mdx
+++ b/src/content/docs/ko/reference/adapter-reference.mdx
@@ -818,7 +818,7 @@ export default function createIntegration() {
}
```
-헤더의 값은 애플리케이션에서 활성화 및 사용되는 기능에 따라 변경될 수 있습니다. 예를 들어, [CSP가 활성화된 경우](/ko/reference/configuration-reference/), `` 요소가 정적 페이지에 추가되지 않습니다. 대신, 해당 `content`는 `routeToHeaders` 맵에서 사용할 수 있습니다.
+헤더의 값은 애플리케이션에서 활성화 및 사용되는 기능에 따라 변경될 수 있습니다. 예를 들어, [CSP가 활성화된 경우](/ko/reference/configuration-reference/#securitycsp), `` 요소가 정적 페이지에 추가되지 않습니다. 대신, 해당 `content`는 `routeToHeaders` 맵에서 사용할 수 있습니다.
### `preserveBuildClientDir`
diff --git a/src/content/docs/ko/reference/api-reference.mdx b/src/content/docs/ko/reference/api-reference.mdx
index ca3095c51db43..5768ffb9c9bfc 100644
--- a/src/content/docs/ko/reference/api-reference.mdx
+++ b/src/content/docs/ko/reference/api-reference.mdx
@@ -1068,7 +1068,7 @@ Astro의 CSP 런타임 API는 문서가 로드할 수 있는 리소스를 제어
`.astro` 컴포넌트 내부의 `Astro` 전역 객체 또는 엔드포인트 및 미들웨어의 `APIContext` 타입을 사용하여 페이지별로 `` 요소를 사용자 정의할 수 있습니다.
-리소스가 여러 번 삽입되거나 여러 소스(예: [`csp` 구성](/ko/reference/configuration-reference/)에 정의된 것과 다음 CSP 런타임 API를 사용하여 추가된 것)에서 제공되는 경우, Astro는 모든 리소스를 병합하고 중복을 제거하여 `` 요소를 생성합니다.
+리소스가 여러 번 삽입되거나 여러 소스(예: [`csp` 구성](/ko/reference/configuration-reference/#securitycsp)에 정의된 것과 다음 CSP 런타임 API를 사용하여 추가된 것)에서 제공되는 경우, Astro는 모든 리소스를 병합하고 중복을 제거하여 `` 요소를 생성합니다.
#### `csp.insertDirective()`
diff --git a/src/content/docs/ko/reference/configuration-reference.mdx b/src/content/docs/ko/reference/configuration-reference.mdx
index 11e81281e99e2..ce3894cd0897f 100644
--- a/src/content/docs/ko/reference/configuration-reference.mdx
+++ b/src/content/docs/ko/reference/configuration-reference.mdx
@@ -373,6 +373,60 @@ Astro 컴포넌트의 요소 선택기가 전역 스타일 기본값 (예: 전
``where'`를 사용하면 구체성을 더 잘 제어할 수 있지만, 적용되는 선택기를 제어하려면 더 높은 구체성 선택기, 레이어 및 기타 도구를 사용해야 합니다.
`'attribute'`를 사용하는 것은 요소의 `class` 속성을 조작하고 자신의 스타일 지정 로직과 Astro의 스타일 적용 사이의 충돌을 피해야 할 때 유용합니다.
+### prerenderConflictBehavior
+
+
+
+**타입:** `'error' | 'warn' | 'ignore'`
+**기본값:** `'warn'`
+
+
+
+두 개의 라우트가 동일한 사전 렌더링된 URL을 생성할 때의 기본 동작을 결정합니다.
+
+- `error`: 빌드를 실패시키고 오류를 표시하여 충돌을 해결하도록 합니다.
+- `warn` (기본값): 충돌이 발생하면 경고를 기록하지만, 우선순위가 가장 높은 라우트를 사용하여 빌드를 진행합니다.
+- `ignore`: 충돌이 발생해도 아무 메시지 없이 우선순위가 가장 높은 라우트를 사용하여 빌드를 진행합니다.
+
+```js
+{
+ prerenderConflictBehavior: 'error'
+}
+```
+
+### vite
+
+
+
+**타입:** `ViteUserConfig`
+
+
+Vite에 추가 설정 옵션을 전달합니다. Astro가 필요한 일부 고급 설정을 지원하지 않을 때 유용합니다.
+
+전체 `vite` 설정 객체 문서는 [vite.dev](https://ko.vite.dev/config/)에서 확인할 수 있습니다.
+
+#### 예시
+
+```js
+{
+ vite: {
+ ssr: {
+ // 예: 필요한 경우, 손상된 패키지가 SSR 처리를 건너뛰도록 강제합니다.
+ external: ['broken-npm-package'],
+ }
+ }
+}
+```
+
+```js
+{
+ vite: {
+ // 예: Astro 프로젝트에 직접 맞춤형 vite 플러그인 추가
+ plugins: [myPlugin()],
+ }
+}
+```
+
### security
@@ -428,6 +482,9 @@ SSR 사용 시 들어오는 요청에 대해 허용되는 호스트 패턴 목
각 패턴은 `protocol`, `hostname`, `port`를 지정할 수 있습니다. 제공된 옵션에 대해 유효성 검사를 수행합니다. 패턴은 유연한 호스트명 일치를 위해 와일드카드를 지원합니다.
+- `*.example.com` - 정확히 한 단계의 서브도메인과 일치합니다 (예: `sub.example.com`은 일치하지만 `deep.sub.example.com`은 일치하지 않음)
+- `**.example.com` - 모든 깊이의 서브도메인과 일치합니다 (예: `sub.example.com`과 `deep.sub.example.com` 모두 일치)
+
```js
{
security: {
@@ -447,40 +504,359 @@ SSR 사용 시 들어오는 요청에 대해 허용되는 호스트 패턴 목
}
```
+일부 특정 상황(예: 동적 도메인을 사용하는 신뢰할 수 있는 리버스 프록시 뒤에 있는 애플리케이션)에서는 모든 도메인을 허용해야 할 수 있습니다. 이 경우 빈 객체를 사용하세요.
+
+```js
+{
+ security: {
+ // 모든 도메인 허용 - 필요한 경우에만 사용하세요.
+ allowedDomains: [{}]
+ }
+}
+```
+
이 설정이 구성되지 않으면, `X-Forwarded-Host` 헤더는 신뢰되지 않으며 무시됩니다.
-### vite
+#### security.serverIslandBodySizeLimit
-**타입:** `ViteUserConfig`
+**타입:** `number`
+**기본값:** `1048576` (1 MB)
+
+
+
+아일랜드 컴포넌트로 전달되는 암호화된 props와 슬롯 HTML이 포함된 서버 아일랜드 요청 본문의 허용 최대 크기(바이트)를 설정합니다.
+기본적으로 서버 아일랜드 요청 본문은 남용을 방지하기 위해 1MB(1048576바이트)로 제한됩니다.
+서버 아일랜드가 더 큰 페이로드를 받아야 하는 경우 이 제한을 늘릴 수 있습니다.
+
+```js
+// astro.config.mjs
+export default defineConfig({
+ security: {
+ serverIslandBodySizeLimit: 10 * 1024 * 1024 // 10 MB
+ }
+})
+```
+
+#### security.csp
+
+
+
+**타입:** `boolean | object`
+**기본값:** `false`
+
-추가 구성 옵션을 Vite에 전달합니다. Astro가 필요할 수 있는 일부 고급 구성을 지원하지 않을 때 유용합니다.
+[콘텐츠 보안 정책(CSP)](https://developer.mozilla.org/ko/docs/Web/HTTP/CSP) 지원을 활성화하여 문서가 로드할 수 있는 리소스를 제어함으로써 특정 유형의 보안 위협을 최소화합니다. 이는 [크로스 사이트 스크립팅(XSS)](https://developer.mozilla.org/ko/docs/Glossary/Cross-site_scripting) 공격에 대한 추가적인 보호를 제공합니다.
-[vite.dev](https://ko.vite.dev/config/)에서 전체 `vite` 구성 객체 문서를 확인하세요.
+이 기능을 활성화하면 Astro의 처리 및 번들링된 스크립트와 스타일에 대한 기본 보안이 강화되며, 이러한 요소와 추가 콘텐츠 유형을 추가로 구성할 수 있습니다.
-#### 예
+이 기능에는 몇 가지 제한 사항이 있습니다:
+- 외부 스크립트 및 외부 스타일은 기본적으로 지원되지 않지만, [자신만의 해시를 제공](#securitycspscriptdirectivehashes)할 수 있습니다.
+- ``를 사용하는 [Astro의 뷰 전환](/ko/guides/view-transitions/)은 지원되지 않지만, Astro의 네이티브 뷰 전환 및 내비게이션 API 개선 사항을 사용하지 않는 경우 [브라우저 네이티브 뷰 전환 API로 마이그레이션](https://events-3bg.pages.dev/jotter/astro-view-transitions/)하는 것을 고려할 수 있습니다.
+- Shiki는 현재 지원되지 않습니다. Shiki 함수는 인라인 스타일을 사용하므로 Astro CSP 구현과 함께 작동할 수 없습니다. 프로젝트에 CSP와 구문 강조가 모두 필요한 경우 [`` 사용](/ko/guides/syntax-highlighting/#prism-)을 고려하세요.
+- `unsafe-inline` 지시어는 Astro의 CSP 구현과 호환되지 않습니다. 기본적으로 Astro는 번들링된 모든 스크립트(예: 클라이언트 아일랜드)에 대한 해시를 생성하며, 모든 최신 브라우저는 해시 또는 nonce가 있는 지시어에 `unsafe-inline`이 포함될 경우 이를 자동으로 거부합니다.
-```js
-{
- vite: {
- ssr: {
- // 예: 필요한 경우, 손상된 패키지가 SSR 처리를 건너뛰도록 강제합니다.
- external: ['broken-npm-package'],
+:::note
+Vite 개발 서버의 특성상 이 기능은 `dev` 모드에서 작업하는 동안 지원되지 않습니다. 대신, `build` 및 `preview`를 사용하여 Astro 프로젝트에서 이 기능을 테스트할 수 있습니다.
+:::
+
+활성화되면 Astro는 각 페이지의 `` 요소 내부에 `` 요소를 추가합니다.
+이 요소는 `http-equiv="content-security-policy"` 속성을 가지며, `content` 속성은 페이지에서 사용되는 스크립트 및 스타일에 따라 `script-src` 및 `style-src` [지시어](#securitycspdirectives)에 대한 값을 제공합니다.
+
+```html
+
+
+
+
+```
+
+추가 옵션이 포함된 구성 객체로 이 기능을 활성화하여 `` 요소를 맞춤설정할 수 있습니다.
+
+##### security.csp.algorithm
+
+
+
+**타입:** `"SHA-256" | "SHA-384" | "SHA-512"`
+**기본값:** `'SHA-256'`
+
+
+
+Astro가 스타일과 스크립트의 해시를 생성할 때 사용할 [해시 함수](https://developer.mozilla.org/ko/docs/Glossary/Hash_function)입니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+ security: {
+ csp: {
+ algorithm: 'SHA-512'
}
}
-}
+});
```
-```js
-{
- vite: {
- // 예: Astro 프로젝트에 직접 맞춤형 vite 플러그인 추가
- plugins: [myPlugin()],
+##### security.csp.directives
+
+
+
+**타입:** `Array`
+**기본값:** `[]`
+
+
+
+특정 콘텐츠 타입에 대한 유효한 소스를 정의하는 [CSP 지시어](https://content-security-policy.com/#directive) 목록입니다 (기본적으로 포함된 `script-src` 및 `style-src` 외에). 이 지시어는 모든 페이지에 추가됩니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+ security: {
+ csp: {
+ directives: [
+ "default-src 'self'",
+ "img-src 'self' https://images.cdn.example.com"
+ ]
+ }
}
-}
+});
+```
+빌드 후, `` 요소는 Astro의 기본 지시어와 함께 여러분의 지시어를 `content` 값에 추가할 것입니다.
+
+```html
+
+```
+
+##### security.csp.styleDirective
+
+
+
+**타입:** `CspStyleDirective`
+**기본값:** `undefined`
+
+
+
+`style-src` 지시어의 기본 소스를 [`resources`](#securitycspstyledirectiveresources) 속성으로 재정의하거나, 추가 [해시](#securitycspstyledirectivehashes)를 렌더링할 수 있도록 하는 구성 객체입니다.
+
+###### security.csp.styleDirective.hashes
+
+
+
+**타입:** `Array`
+**기본값:** `[]`
+
+
+
+렌더링할 추가 해시 목록입니다.
+
+`sha384-`, `sha512-`, `sha256-`으로 시작하는 해시를 제공해야 합니다. 다른 값은 유효성 검사 오류를 발생시킵니다. 이 해시들은 모든 페이지에 추가됩니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+ security: {
+ csp: {
+ styleDirective: {
+ hashes: [
+ "sha384-styleHash",
+ "sha512-styleHash",
+ "sha256-styleHash"
+ ]
+ }
+ }
+ }
+});
+```
+
+빌드 후, `` 요소는 `style-src` 지시어에 여러분의 추가 해시를 포함하게 됩니다.
+
+```html
+
+```
+
+###### security.csp.styleDirective.resources
+
+
+
+**타입:** `Array`
+**기본값:** `[]`
+
+
+
+Astro의 기본 소스를 덮어쓰기 위한 `style-src` 지시어의 유효한 소스 목록입니다. 이 목록에는 기본적으로 `'self'`가 포함되지 않으므로, 유지하려면 이 목록에 포함해야 합니다. 이 리소스는 모든 페이지에 추가됩니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+ security: {
+ csp: {
+ styleDirective: {
+ resources: [
+ "'self'",
+ "https://styles.cdn.example.com"
+ ]
+ }
+ }
+ }
+});
+```
+
+빌드 후, `` 요소는 대신 여러분의 소스를 `style-src` 지시어에 적용할 것입니다.
+
+```html
+
+
+
+```
+
+리소스가 여러 번 삽입되거나 여러 소스(예: `csp` 구성에 정의된 것과 [CSP 런타임 API](/ko/reference/api-reference/#csp)를 사용하여 추가된 것)에서 제공되는 경우, Astro는 모든 리소스를 병합하고 중복을 제거하여 `` 요소를 생성합니다.
+
+##### security.csp.scriptDirective
+
+
+
+**타입:** `CspScriptDirective`
+**기본값:** `undefined`
+
+
+
+`script-src` 지시어의 기본 소스를 [`resources`](#securitycspscriptdirectiveresources) 속성으로 재정의하거나, 추가 [해시](#securitycspscriptdirectivehashes)를 렌더링할 수 있도록 하는 구성 객체입니다.
+
+###### security.csp.scriptDirective.hashes
+
+
+
+**타입:** `Array`
+**기본값:** `[]`
+
+
+
+렌더링할 추가 해시 목록입니다.
+
+`sha384-`, `sha512-`, `sha256-`으로 시작하는 해시를 제공해야 합니다. 다른 값은 유효성 검사 오류를 발생시킵니다. 이 해시는 모든 페이지에 추가됩니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+ security: {
+ csp: {
+ scriptDirective: {
+ hashes: [
+ "sha384-scriptHash",
+ "sha512-scriptHash",
+ "sha256-scriptHash"
+ ]
+ }
+ }
+ }
+});
+```
+
+빌드 후, `` 요소는 `script-src` 지시어에 여러분의 추가 해시를 포함하게 됩니다.
+
+```html
+
+```
+
+###### security.csp.scriptDirective.resources
+
+
+
+**타입:** `Array`
+**기본값:** `[]`
+
+
+
+`script-src` 지시어에 대한 유효한 소스 목록으로, Astro의 기본 소스를 재정의합니다. 기본적으로 `'self'`는 포함되지 않으므로, 이를 유지하려면 이 목록에 포함해야 합니다. 이러한 리소스는 모든 페이지에 추가됩니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+ security: {
+ csp: {
+ scriptDirective: {
+ resources: [
+ "'self'", "https://cdn.example.com"
+ ]
+ }
+ }
+ }
+});
+```
+
+빌드 후, `` 요소는 대신 여러분의 소스를 `script-src` 지시어에 적용할 것입니다.
+
+```html
+
+
+
+```
+
+리소스가 여러 번 삽입되거나 여러 소스(예: `csp` 구성에 정의된 것과 [CSP 런타임 API](/ko/reference/api-reference/#csp)를 사용하여 추가된 것)에서 제공되는 경우, Astro는 모든 리소스를 병합하고 중복을 제거하여 `` 요소를 생성합니다.
+
+###### security.csp.scriptDirective.strictDynamic
+
+
+
+**타입:** `boolean`
+**기본값:** `false`
+
+
+
+스크립트의 동적 주입을 지원하기 위해 [`strict-dynamic` 키워드](https://developer.mozilla.org/ko/docs/Web/HTTP/Headers/Content-Security-Policy/script-src#strict-dynamic)를 활성화합니다.
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+ security: {
+ csp: {
+ scriptDirective: {
+ strictDynamic: true
+ }
+ }
+ }
+});
```
## 빌드 옵션
@@ -868,22 +1244,26 @@ Astro 프로젝트의 세션 스토리지를 구성합니다. 이는 세션 데
-**타입:** `string | undefined`
+**타입:** `SessionDriverConfig | undefined`
-세션 스토리지를 위해 사용할 Unstorage 드라이버입니다. [Node](/ko/guides/integrations-guide/node/#세션), [Cloudflare](/ko/guides/integrations-guide/cloudflare/#세션), [Netlify](/ko/guides/integrations-guide/netlify/#세션) 어댑터는 자동으로 기본 드라이버를 구성하지만, 기본 드라이버를 제공하지 않는 어댑터를 선호하거나 사용하는 경우 사용자 정의 드라이버를 지정할 수 있습니다.
+세션 스토리지를 위해 사용할 드라이버입니다. [Node](/ko/guides/integrations-guide/node/#세션), [Cloudflare](/ko/guides/integrations-guide/cloudflare/#세션), [Netlify](/ko/guides/integrations-guide/netlify/#세션) 어댑터는 자동으로 기본 드라이버를 구성하지만, 기본 드라이버를 제공하지 않는 어댑터를 선호하거나 사용하는 경우 사용자 정의 드라이버를 지정할 수 있습니다.
-이 값은 [Unstorage 드라이버 문서](https://unstorage.unjs.io/drivers)에 있는 "드라이버 이름"입니다.
+```js title="astro.config.mjs" ins={7-9} ins=" sessionDrivers "
+import { defineConfig, sessionDrivers } from 'astro/config'
+import vercel from '@astrojs/vercel'
-```js title="astro.config.mjs" ins={4}
-{
- adapter: vercel(),
+export default defineConfig({
+ adapter: vercel()
session: {
- driver: "redis",
- },
-}
+ driver: sessionDrivers.redis({
+ url: process.env.REDIS_URL
+ }),
+ }
+})
```
+
:::note
일부 드라이버는 추가 패키지 설치가 필요할 수 있습니다. 또한 일부 드라이버는 환경 변수나 자격 증명 설정을 요구할 수도 있습니다. 자세한 내용은 [Unstorage 문서](https://unstorage.unjs.io/drivers)를 참조하세요.
:::
@@ -897,6 +1277,10 @@ Astro 프로젝트의 세션 스토리지를 구성합니다. 이는 세션 데
+:::caution[사용되지 않음]
+이 옵션은 더 이상 사용되지 않으며 향후 주요 버전에서 삭제될 예정입니다. 대신 드라이버 함수에 옵션을 전달하세요.
+:::
+
세션 스토리지를 위해 사용할 드라이버별 옵션입니다. 옵션은 사용 중인 드라이버에 따라 다릅니다. 각 드라이버에서 사용할 수 있는 옵션에 대한 자세한 내용은 [Unstorage 문서](https://unstorage.unjs.io/drivers)를 참조하세요.
```js title="astro.config.mjs" ins={4-6}
@@ -955,7 +1339,7 @@ Astro 프로젝트의 세션 스토리지를 구성합니다. 이는 세션 데
세션 값에 대한 선택적 기본 만료 시간(초)입니다.
-기본적으로 세션 값은 삭제되거나 세션이 파괴될 때까지 유지되며, 특정 시간이 경과해도 자동으로 만료되지 않습니다. 세션 값에 대한 기본 만료 기간을 추가하려면 `session.ttl`을 설정하세요. [`session.set()`](/ko/reference/api-reference/)에 `ttl` 옵션을 전달하면 해당 개별 항목에 대한 전역 기본값을 덮어씁니다.
+기본적으로 세션 값은 삭제되거나 세션이 파괴될 때까지 유지되며, 특정 시간이 경과해도 자동으로 만료되지 않습니다. 세션 값에 대한 기본 만료 기간을 추가하려면 `session.ttl`을 설정하세요. [`session.set()`](/ko/reference/api-reference/#sessionset)에 `ttl` 옵션을 전달하면 해당 개별 항목에 대한 전역 기본값을 덮어씁니다.
```js title="astro.config.mjs" ins={3-4}
{
@@ -1117,6 +1501,13 @@ Astro의 자산 지원에 사용되는 이미지 서비스를 설정합니다.
entrypoint: 'astro/assets/services/sharp',
config: {
limitInputPixels: false,
+ webp: {
+ effort: 6,
+ alphaQuality: 80,
+ },
+ jpeg: {
+ mozjpeg: true,
+ },
},
},
},
@@ -1150,6 +1541,62 @@ Sharp 이미지 서비스에서 [이미지 크기를 조정하는 데 사용되
기본적으로 이 값은 `undefined`이며, Sharp의 기본 커널인 `lanczos3`에 매핑됩니다.
+#### image.service.config.jpeg
+
+
+
+**타입:** `Record | undefined`
+**기본값:** `undefined`
+
+
+
+Astro의 내장 Sharp 이미지 서비스를 사용할 때 `sharp().jpeg()`에 전달되는 기본 인코더 옵션입니다.
+
+`mozjpeg`, `progressive`, `chromaSubsampling` 또는 기본 `quality`와 같은 옵션에 사용할 수 있습니다.
+``, ``, `getImage()`에서 설정한 이미지별 `quality` 값이 여전히 우선합니다.
+
+#### image.service.config.webp
+
+
+
+**타입:** `Record | undefined`
+**기본값:** `undefined`
+
+
+
+Astro의 내장 Sharp 이미지 서비스를 사용할 때 `sharp().webp()`에 전달되는 기본 인코더 옵션입니다.
+
+`effort`, `alphaQuality`, `lossless`, `nearLossless` 또는 기본 `quality`와 같은 옵션에 사용할 수 있습니다.
+``, ``, `getImage()`에서 설정한 이미지별 `quality` 값이 여전히 우선합니다.
+
+#### image.service.config.avif
+
+
+
+**타입:** `Record | undefined`
+**기본값:** `undefined`
+
+
+
+Astro의 내장 Sharp 이미지 서비스를 사용할 때 `sharp().avif()`에 전달되는 기본 인코더 옵션입니다.
+
+`effort`, `chromaSubsampling`, `bitdepth`, `lossless` 또는 기본 `quality`와 같은 옵션에 사용할 수 있습니다.
+``, ``, `getImage()`에서 설정한 이미지별 `quality` 값이 여전히 우선합니다.
+
+#### image.service.config.png
+
+
+
+**타입:** `Record | undefined`
+**기본값:** `undefined`
+
+
+
+Astro의 내장 Sharp 이미지 서비스를 사용할 때 `sharp().png()`에 전달되는 기본 인코더 옵션입니다.
+
+`compressionLevel`, `effort`, `palette` 또는 기본 `quality`와 같은 옵션에 사용할 수 있습니다.
+``, ``, `getImage()`에서 설정한 이미지별 `quality` 값이 여전히 우선합니다.
+
### image.domains
@@ -1457,21 +1904,17 @@ Astro는 기본적으로 [GitHub 기반 Markdown](https://github.com/remarkjs/re
-**타입:** `boolean`
+**타입:** `boolean | Smartypants`
**기본값:** `true`
-Astro는 기본적으로 [SmartyPants 포매터](https://daringfireball.net/projects/smartypants/)를 사용합니다. 이를 비활성화하려면 `smartypants` 플래그를 `false`로 설정하세요.
+[SmartyPants 포매터](https://daringfireball.net/projects/smartypants/)를 사용하여 곧은 따옴표를 둥근 따옴표로, 대시를 en/em 대시로, 세 개의 점을 줄임표로 변환할지 여부입니다.
-```js
-{
- markdown: {
- smartypants: false,
- }
-}
-```
+이를 비활성화하려면 `smartypants` 플래그를 `false`로 설정하세요.
+
+타이포그래피를 더 세밀하게 제어하려면 대신 [`retext-smartypants`에서 지원하는 속성](https://github.com/retextjs/retext-smartypants?tab=readme-ov-file#fields)이 포함된 구성 객체를 지정할 수 있습니다.
### markdown.remarkRehype
@@ -1633,14 +2076,14 @@ export default defineConfig({
**타입:** `boolean`
-**기본값:** `true`
+**기본값:** `false`
`prefixDefaultLocale: true`가 설정된 경우 `src/pages/index.astro`에 의해 생성된 홈 URL (`/`)이 `/[defaultLocale]`로 리디렉션되는지 여부를 구성합니다.
-사이트 루트에서 자동 리디렉션을 비활성화하려면 `redirectToDefaultLocale: false`를 설정하세요.
+사이트 루트에서 자동 리디렉션을 활성화하려면 `redirectToDefaultLocale: true`를 설정하세요.
```js
// astro.config.mjs
@@ -1650,7 +2093,7 @@ export default defineConfig({
locales: ['en', 'fr'],
routing: {
prefixDefaultLocale: true,
- redirectToDefaultLocale: false,
+ redirectToDefaultLocale: true,
},
},
});
@@ -1753,7 +2196,9 @@ Astro의 [환경 변수](/ko/guides/environment-variables/)에 대한 자세한
-`envField`를 사용하여 환경 변수의 데이터 타입과 속성을 정의하는 객체입니다: `context`(클라이언트 또는 서버), `access`(공개 또는 비밀), 사용할 `default` 값, 그리고 이 환경 변수가 `optional`인지 여부(기본값은 `false`).
+Zod 유효성 검사를 통해 강제되고 TypeScript 지원(예: 자동 완성, 타입 안정성)이 제공되는 환경 변수를 정의합니다. 각 키는 변수 이름에 해당하며, 값은 [`envField`로 정의된](/ko/reference/modules/astro-config/#envfield) 데이터 타입 및 유효성 검사에 해당합니다.
+
+문자열, 숫자, 열거형, 불리언의 네 가지 데이터 타입을 지원합니다. 각 타입에는 `context` (client 또는 server), `access` 수준 (public 또는 secret)이 필요하며, `default` 값이나 변수의 `optional` 여부(기본값은 `false`)와 같은 추가 유효성 검사 옵션을 설정할 수 있습니다.
```js
// astro.config.mjs
@@ -1770,46 +2215,6 @@ export default defineConfig({
})
```
-`envField`는 문자열, 숫자, 열거형, 불리언의 네 가지 데이터 타입을 지원합니다. `context`와 `access`는 모든 데이터 타입에 필요한 속성입니다. 다음은 각 데이터 타입에 사용할 수 있는 전체 속성 목록입니다:
-
-```js
-import { envField } from "astro/config"
-
-envField.string({
- // context & access
- optional: true,
- default: "foo",
- max: 20,
- min: 1,
- length: 13,
- url: true,
- includes: "oo",
- startsWith: "f",
- endsWith: "o",
-})
-envField.number({
- // context & access
- optional: true,
- default: 15,
- gt: 2,
- min: 1,
- lt: 3,
- max: 4,
- int: true,
-})
-envField.boolean({
- // context & access
- optional: true,
- default: true,
-})
-envField.enum({
- // context & access
- values: ['foo', 'bar', 'baz'], // 필수
- optional: true,
- default: 'baz',
-})
-```
-
### env.validateSecrets
@@ -1836,3 +2241,265 @@ export default defineConfig({
}
})
```
+
+## fonts
+
+
+
+**타입:** `Array`
+**기본값:** `[]`
+
+
+
+폰트를 구성하고 폰트별로 일부 맞춤 옵션을 지정할 수 있습니다.
+
+[Astro에서 커스텀 폰트를 사용하는 방법](/ko/guides/fonts/)에 대한 자세한 내용은 가이드를 참조하세요.
+
+### font.provider
+
+
+
+**타입:** `FontProvider`
+
+
+
+폰트 파일의 소스입니다. [내장 제공자](/ko/reference/font-provider-reference/#built-in-providers)를 사용하거나 나만의 [커스텀 제공자](/ko/reference/font-provider-reference/#building-a-font-provider)를 작성할 수 있습니다.
+
+```js
+import { defineConfig, fontProviders } from "astro/config";
+
+export default defineConfig({
+ fonts: [{
+ provider: fontProviders.google(),
+ name: "Roboto",
+ cssVariable: "--font-roboto"
+ }]
+});
+```
+
+### font.name
+
+
+
+**타입:** `string`
+
+
+
+폰트 제공자가 식별하는 폰트 패밀리 이름입니다.
+
+```js
+name: "Roboto"
+```
+
+### font.cssVariable
+
+
+
+**타입:** `string`
+
+
+
+CSS 변수 형태(즉, `--`로 시작)로 선택한 유효한 [ident](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/ident)입니다.
+
+```js
+cssVariable: "--font-roboto"
+```
+
+### font.fallbacks
+
+
+
+**타입:** `Array`
+**기본값:** `["sans-serif"]`
+
+
+
+선택한 폰트를 사용할 수 없거나 로딩 중일 때 사용할 폰트 배열입니다. 대체 폰트는 나열된 순서대로 선택됩니다. 사용 가능한 첫 번째 폰트가 사용됩니다.
+
+```js
+fallbacks: ["CustomFont", "serif"]
+```
+
+대체 폰트를 완전히 비활성화하려면 빈 배열을 구성하세요.
+
+```js
+fallbacks: []
+```
+
+폰트의 의도된 모양과 일치하는 [일반 패밀리 이름](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/font-family#generic-name)을 하나 이상 지정하세요. 그러면 Astro는 폰트 메트릭을 사용하여 [최적화된 대체 폰트](https://developer.chrome.com/blog/font-fallbacks) 생성을 시도합니다. 이 최적화를 비활성화하려면 `optimizedFallbacks`를 false로 설정하세요.
+
+### font.optimizedFallbacks
+
+
+
+**타입:** `boolean`
+**기본값:** `true`
+
+
+
+대체 폰트를 생성할 때 Astro의 기본 최적화를 활성화할지 여부입니다. [`fallbacks`](#fontfallbacks)가 생성되는 방식을 완전히 제어하기 위해 이 기본 최적화를 비활성화할 수 있습니다.
+
+```js
+optimizedFallbacks: false
+```
+
+### font.weights
+
+
+
+**타입:** `Array<(number|string)>`
+**기본값:** `[400]`
+
+
+
+[폰트 두께](https://developer.mozilla.org/ko/docs/Web/CSS/font-weight) 배열입니다. 구성에 값을 지정하지 않으면 불필요한 다운로드를 방지하기 위해 기본적으로 두께 `400`만 포함됩니다. 다른 폰트 두께에 액세스하려면 이 속성을 포함해야 합니다.
+
+```js
+weights: [200, "400", "bold"]
+```
+
+관련 폰트가 [가변 폰트](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Fonts/Variable_fonts)인 경우 두께 범위를 지정할 수 있습니다.
+
+```js
+weights: ["100 900"]
+```
+
+### font.styles
+
+
+
+**타입:** `Array<("normal"|"italic"|"oblique")>`
+**기본값:** `["normal", "italic"]`
+
+
+
+[폰트 스타일](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/font-style) 배열입니다.
+
+```js
+styles: ["normal", "oblique"]
+```
+
+### font.subsets
+
+
+
+**타입:** `Array`
+**기본값:** `["latin"]`
+
+
+
+미리 로드할 [폰트 서브셋](https://knaap.dev/posts/font-subsetting/) 목록을 정의합니다.
+
+```js
+subsets: ["latin"]
+```
+
+### font.formats
+
+
+
+**타입:** `Array<("woff2"|"woff"|"otf"|"ttf"|"eot")>`
+**기본값:** `["woff2"]`
+
+
+
+[폰트 형식](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@font-face/src) 배열입니다.
+
+```js
+formats: ["woff2", "woff"]
+```
+
+### font.options
+
+
+
+**타입:** `Record`
+
+
+
+제공자별 옵션을 전달하는 객체입니다. 폰트 패밀리 [제공자](#fontprovider)에 따라 자동으로 타입이 지정됩니다.
+
+```js
+options: {
+ experimental: {
+ glyphs: ["a"]
+ }
+}
+```
+
+### font.display
+
+
+
+**타입:** `"auto" | "block" | "swap" | "fallback" | "optional"`
+**기본값:** `"swap"`
+
+
+
+다운로드되어 사용할 준비가 된 시점에 따라 [폰트가 표시되는 방식](https://developer.mozilla.org/ko/docs/Web/CSS/@font-face/font-display)을 정의합니다.
+
+```js
+display: "block"
+```
+
+### font.unicodeRange
+
+
+
+**타입:** `Array`
+**기본값:** `undefined`
+
+
+
+특정 [유니코드 문자 범위](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@font-face/unicode-range)를 기반으로 폰트를 다운로드하고 사용해야 하는 시점을 결정합니다. 페이지의 문자가 구성된 범위와 일치하면 브라우저는 폰트를 다운로드하여 페이지에서 모든 문자를 사용할 수 있게 됩니다. 단일 폰트에 대해 미리 로드된 문자 서브셋을 구성하려면 대신 [subsets](#fontsubsets) 속성을 참조하세요.
+
+이는 웹사이트의 특정 부분에서 다른 문자를 사용하고 별도의 폰트로 표시되는 경우 불필요한 폰트 다운로드를 피하기 위한 현지화에 유용할 수 있습니다. 예를 들어 영어와 일본어 버전을 모두 제공하는 웹사이트는 `unicodeRange`에 제공된 일본어 문자가 포함되지 않은 영어 버전 페이지에서 브라우저가 일본어 폰트를 다운로드하지 않도록 방지할 수 있습니다.
+
+```js
+unicodeRange: ["U+26"]
+```
+
+### font.stretch
+
+
+
+**타입:** `string`
+**기본값:** `undefined`
+
+
+
+[폰트 장평](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@font-face/font-stretch)입니다.
+
+```js
+stretch: "condensed"
+```
+
+### font.featureSettings
+
+
+
+**타입:** `string`
+**기본값:** `undefined`
+
+
+
+[타이포그래피 폰트 기능](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@font-face/font-feature-settings) (예: 합자, 작은 대문자, 스와시)을 제어합니다.
+
+```js
+featureSettings: "'smcp' 2"
+```
+
+### font.variationSettings
+
+
+
+**타입:** `string`
+**기본값:** `undefined`
+
+
+
+폰트 [변형 설정](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@font-face/font-variation-settings)입니다.
+
+```js
+variationSettings: "'xhgt' 0.7"
+```
diff --git a/src/content/docs/ko/reference/errors/prerender-route-conflict.mdx b/src/content/docs/ko/reference/errors/prerender-route-conflict.mdx
index 0980fa697cb99..f385540d4dd8f 100644
--- a/src/content/docs/ko/reference/errors/prerender-route-conflict.mdx
+++ b/src/content/docs/ko/reference/errors/prerender-route-conflict.mdx
@@ -11,4 +11,4 @@ githubURL: https://github.com/withastro/astro/blob/main/packages/astro/src/core/
**더 보기:**
- [라우트 우선 순위](/ko/guides/routing/#라우트-우선-순위)
-- [`prerenderConflictBehavior`](/ko/reference/configuration-reference/)
+- [`prerenderConflictBehavior`](/ko/reference/configuration-reference/#prerenderconflictbehavior)
diff --git a/src/content/docs/ko/reference/integrations-reference.mdx b/src/content/docs/ko/reference/integrations-reference.mdx
index bf58c10224d75..7775395622d8f 100644
--- a/src/content/docs/ko/reference/integrations-reference.mdx
+++ b/src/content/docs/ko/reference/integrations-reference.mdx
@@ -851,7 +851,7 @@ export default {
}
```
-로더는 `refreshContextData` 속성에 접근하여 웹훅 본문을 가져올 수 있습니다. 자세한 내용은 [`refreshContextData`](/ko/reference/content-loader-reference/) 속성을 참조하세요.
+로더는 `refreshContextData` 속성에 접근하여 웹훅 본문을 가져올 수 있습니다. 자세한 내용은 [`refreshContextData`](/ko/reference/content-loader-reference/#loadercontextrefreshcontextdata) 속성을 참조하세요.
### `astro:server:start`
@@ -2665,7 +2665,7 @@ HTML 출력에 인라인으로 포함될 스크립트의 식별자와 해당 콘
-[콘텐츠 보안 정책 구성](/ko/reference/configuration-reference/)을 설명합니다.
+[콘텐츠 보안 정책 구성](/ko/reference/configuration-reference/#securitycsp)을 설명합니다.
##### `SSRManifest.csp.cspDestination`
@@ -2683,7 +2683,7 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지,
**타입:** `'SHA-256' | 'SHA-384' | 'SHA-512'`
-[설정된 해시 함수](/ko/reference/configuration-reference/)를 지정합니다.
+[설정된 해시 함수](/ko/reference/configuration-reference/#securitycspalgorithm)를 지정합니다.
##### `SSRManifest.csp.scriptHashes`
@@ -2692,7 +2692,7 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지,
**타입:** `string[]`
-프로젝트 스크립트용으로 생성된 해시 목록과 외부 스크립트용으로 [사용자가 제공한 해시](/ko/reference/configuration-reference/) 목록을 지정합니다.
+프로젝트 스크립트용으로 생성된 해시 목록과 외부 스크립트용으로 [사용자가 제공한 해시](/ko/reference/configuration-reference/#securitycspscriptdirectivehashes) 목록을 지정합니다.
##### `SSRManifest.csp.scriptResources`
@@ -2701,7 +2701,7 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지,
**타입:** `string[]`
-[설정된 스크립트 리소스](/ko/reference/configuration-reference/)와 [삽입된 스크립트 리소스](/ko/reference/api-reference/)를 결합한 유효한 소스 목록을 지정합니다.
+[설정된 스크립트 리소스](/ko/reference/configuration-reference/#securitycspscriptdirectiveresources)와 [삽입된 스크립트 리소스](/ko/reference/api-reference/#cspinsertscriptresource)를 결합한 유효한 소스 목록을 지정합니다.
##### `SSRManifest.csp.isStrictDynamic`
@@ -2710,7 +2710,7 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지,
**타입:** `boolean`
-[설정에서 동적 스크립트 삽입 지원이 활성화되었는지 여부](/ko/reference/configuration-reference/)를 결정합니다.
+[설정에서 동적 스크립트 삽입 지원이 활성화되었는지 여부](/ko/reference/configuration-reference/#securitycspscriptdirectivestrictdynamic)를 결정합니다.
##### `SSRManifest.csp.styleHashes`
@@ -2719,7 +2719,7 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지,
**타입:** `string[]`
-프로젝트 스타일용으로 생성된 해시 목록과 외부 스타일용으로 [사용자가 제공한 해시](/ko/reference/configuration-reference/) 목록을 지정합니다.
+프로젝트 스타일용으로 생성된 해시 목록과 외부 스타일용으로 [사용자가 제공한 해시](/ko/reference/configuration-reference/#securitycspstyledirectivehashes) 목록을 지정합니다.
##### `SSRManifest.csp.styleResources`
@@ -2728,7 +2728,7 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지,
**타입:** `string[]`
-[설정된 스타일 리소스](/ko/reference/configuration-reference/)와 [삽입된 스타일 리소스](/ko/reference/api-reference/#cspinsertstyleresource)를 결합한 유효한 소스 목록을 지정합니다.
+[설정된 스타일 리소스](/ko/reference/configuration-reference/#securitycspstyledirectiveresources)와 [삽입된 스타일 리소스](/ko/reference/api-reference/#cspinsertstyleresource)를 결합한 유효한 소스 목록을 지정합니다.
##### `SSRManifest.csp.directives`
@@ -2737,7 +2737,7 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지,
**타입:** `CspDirective[]`
-특정 콘텐츠 유형에 대해 [설정된 유효한 소스 목록](/ko/reference/configuration-reference/)을 지정합니다.
+특정 콘텐츠 유형에 대해 [설정된 유효한 소스 목록](/ko/reference/configuration-reference/#securitycspdirectives)을 지정합니다.
#### `SSRManifest.devToolbar`
diff --git a/src/content/docs/ko/reference/modules/astro-assets.mdx b/src/content/docs/ko/reference/modules/astro-assets.mdx
index 1b0f7e6eefa2e..421018e73e6eb 100644
--- a/src/content/docs/ko/reference/modules/astro-assets.mdx
+++ b/src/content/docs/ko/reference/modules/astro-assets.mdx
@@ -578,7 +578,7 @@ import { Font } from "astro:assets";
**예시 타입:** `"--font-roboto" | "--font-comic-sans" | ...`
-Astro 설정에 등록된 [`cssVariable`](/ko/reference/configuration-reference/)입니다:
+Astro 설정에 등록된 [`cssVariable`](/ko/reference/configuration-reference/#fontcssvariable)입니다:
```astro title="src/components/Head.astro" "cssVariable"
---
@@ -699,7 +699,7 @@ const { width, height } = await inferRemoteSize("https://example.com/cat.png");
-각 키는 [`cssVariable`](/ko/reference/configuration-reference/)이며, 값은 관련 글꼴을 설명하는 배열인 객체입니다. 각 글꼴은 해당 글꼴에 사용할 수 있는 `src` 배열과 선택적 속성인 `weight` 및 `style`을 포함하는 객체입니다:
+각 키는 [`cssVariable`](/ko/reference/configuration-reference/#fontcssvariable)이며, 값은 관련 글꼴을 설명하는 배열인 객체입니다. 각 글꼴은 해당 글꼴에 사용할 수 있는 `src` 배열과 선택적 속성인 `weight` 및 `style`을 포함하는 객체입니다:
```ts
import { fontData } from "astro:assets"
diff --git a/src/content/docs/ko/reference/modules/astro-config.mdx b/src/content/docs/ko/reference/modules/astro-config.mdx
index 5861ef79d698d..b4e4be5505201 100644
--- a/src/content/docs/ko/reference/modules/astro-config.mdx
+++ b/src/content/docs/ko/reference/modules/astro-config.mdx
@@ -295,7 +295,7 @@ export default defineConfig({
-[구성된 폰트를 가져오기](/ko/reference/configuration-reference/) 위해 사용되는 [내장 제공자](/ko/reference/font-provider-reference/#built-in-providers)를 설명합니다.
+[구성된 폰트를 가져오기](/ko/reference/configuration-reference/#fontprovider) 위해 사용되는 [내장 제공자](/ko/reference/font-provider-reference/#built-in-providers)를 설명합니다.
### `getViteConfig()`