From c00cd6ee3aa081efa8ba3a74a4e7159dab070b38 Mon Sep 17 00:00:00 2001 From: Junseong Park <39112954+jsparkdev@users.noreply.github.com> Date: Fri, 17 Jul 2026 11:24:56 +0900 Subject: [PATCH 1/5] Update routing-reference.mdx --- .../docs/ko/reference/routing-reference.mdx | 22 +++++++++++++------ 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/src/content/docs/ko/reference/routing-reference.mdx b/src/content/docs/ko/reference/routing-reference.mdx index ad8cd5b9eb560..3efcfd586cb8a 100644 --- a/src/content/docs/ko/reference/routing-reference.mdx +++ b/src/content/docs/ko/reference/routing-reference.mdx @@ -153,8 +153,8 @@ const { id } = Astro.params; ```astro title="src/pages/posts/[id].astro" {9} --- export async function getStaticPaths() { - const response = await fetch('...'); - const data = await response.json(); + const response = await fetch("..."); + const data: any[] = await response.json(); return data.map((post) => { return { @@ -167,6 +167,7 @@ export async function getStaticPaths() { const { id } = Astro.params; const { post } = Astro.props; --- +

{id}: {post.name}

``` @@ -188,11 +189,12 @@ const { post } = Astro.props; ```astro title="src/pages/[...locale]/[files]/[slug].astro" "routePattern" "getLocalizedData" --- +import type { GetStaticPathsOptions } from "astro"; import { getLocalizedData } from "../../../utils/i18n"; -export async function getStaticPaths({ routePattern }) { - const response = await fetch('...'); - const data = await response.json(); +export async function getStaticPaths({ routePattern }: GetStaticPathsOptions) { + const response = await fetch("..."); + const data: any[] = await response.json(); console.log(routePattern); // [...locale]/[files]/[slug] @@ -219,14 +221,19 @@ const { locale, files, slug } = Astro.params; ```astro title="src/pages/pokemon/[page].astro" --- -export async function getStaticPaths({ paginate }) { +import type { GetStaticPathsOptions } from "astro"; + +export async function getStaticPaths({ paginate }: GetStaticPathsOptions) { // fetch(), getCollection() 등으로 데이터 로드 const response = await fetch(`https://pokeapi.co/api/v2/pokemon?limit=150`); const result = await response.json(); const allPokemon = result.results; // 모든 항목에 대한 페이지가 매겨진 경로 컬렉션을 반환 - return paginate(allPokemon, { pageSize: 10 }); + return paginate(allPokemon, { + pageSize: 10, + format: (url) => `${url}.html`, + }); } const { page } = Astro.props; @@ -239,6 +246,7 @@ const { page } = Astro.props; - `pageSize` - 페이지당 표시되는 항목 수(기본값 `10`) - `params` - 동적 라우트 생성을 위한 추가 매개변수 전달 - `props` - 각 페이지에서 사용할 수 있는 추가 props 전달 + - `format` - **v7.1.0 버전부터 사용 가능.** 렌더링되기 전에 계산된 URL을 원하는 형태로 변경할 수 있는 함수 `paginate()`는 `[page].astro` 또는 `[...page].astro`의 파일 이름을 가정합니다. `page` 매개변수는 URL에서 페이지 번호가 됩니다: From 3ebcc5280e93583c4b8b4553d174ca4fd33fc844 Mon Sep 17 00:00:00 2001 From: Junseong Park <39112954+jsparkdev@users.noreply.github.com> Date: Fri, 17 Jul 2026 11:25:57 +0900 Subject: [PATCH 2/5] Update logger-reference.mdx --- src/content/docs/ko/reference/logger-reference.mdx | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/src/content/docs/ko/reference/logger-reference.mdx b/src/content/docs/ko/reference/logger-reference.mdx index 5de782ae1e3ff..1b7a70a0be05d 100644 --- a/src/content/docs/ko/reference/logger-reference.mdx +++ b/src/content/docs/ko/reference/logger-reference.mdx @@ -41,11 +41,7 @@ export default defineConfig({ 다음 예시는 필수 `write()` 함수를 구현한 [`AstroLoggerDestination` 객체](#astrologgerdestination)를 반환하는 가장 단순한 로거를 구현합니다. ```ts title="@org/custom-logger/index.ts" -import type { - AstroLoggerLevel, - AstroLoggerDestination, - AstroLoggerMessage -} from "astro"; +import type { AstroLoggerLevel, AstroLoggerDestination } from "astro"; import { matchesLevel } from "astro/logger"; type LoggerOptions = { @@ -55,7 +51,7 @@ type LoggerOptions = { function orgLogger(options: LoggerOptions = {}): AstroLoggerDestination { const { level = 'info' } = options; return { - write(message: AstroLoggerMessage) { + write(message) { // 이 유틸리티를 사용하여 메시지 출력 여부를 판단합니다. if (matchesLevel(message.level, level)) { // 메시지를 기록하고 로그 레벨을 반영합니다. From abfdc43c87ba24815dd80496d0285d97f827ef5a Mon Sep 17 00:00:00 2001 From: Junseong Park <39112954+jsparkdev@users.noreply.github.com> Date: Fri, 17 Jul 2026 11:39:14 +0900 Subject: [PATCH 3/5] Update integrations-reference.mdx --- .../ko/reference/integrations-reference.mdx | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/src/content/docs/ko/reference/integrations-reference.mdx b/src/content/docs/ko/reference/integrations-reference.mdx index 219b5407ea571..e58ff67ab4da5 100644 --- a/src/content/docs/ko/reference/integrations-reference.mdx +++ b/src/content/docs/ko/reference/integrations-reference.mdx @@ -2495,6 +2495,10 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지, ##### `SSRManifest.csp.scriptHashes` +:::caution[사용 중단] +대신 [`scriptDirective`](#ssrmanifestcspscriptdirective)를 사용하세요. 이 속성에는 일반 `script-src` 지시어에 해당하는 해시만 포함됩니다. 향후 메이저 버전에서 제거될 예정입니다. +::: +

**타입:** `string[]` @@ -2504,6 +2508,10 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지, ##### `SSRManifest.csp.scriptResources` +:::caution[사용 중단] +대신 [`scriptDirective`](#ssrmanifestcspscriptdirective)를 사용하세요. 이 속성에는 일반 `script-src` 지시어에 해당하는 소스만 포함됩니다. 향후 메이저 버전에서 제거될 예정입니다. +::: +

**타입:** `string[]` @@ -2513,6 +2521,10 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지, ##### `SSRManifest.csp.isStrictDynamic` +:::caution[사용 중단] +대신 [`scriptDirective.strictDynamic`](#ssrmanifestcspscriptdirective)을 사용하세요. 향후 메이저 버전에서 제거될 예정입니다. +::: +

**타입:** `boolean` @@ -2520,8 +2532,22 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지, [설정에서 동적 스크립트 삽입 지원이 활성화되었는지 여부](/ko/reference/configuration-reference/#securitycspscriptdirectivestrictdynamic)를 결정합니다. +##### `SSRManifest.csp.scriptDirective` + +

+ +**타입:** `{ resources: Array; hashes: Array; strictDynamic: boolean }`
+ +

+ +`script-src` 관련 지시어에 대한 소스, 해시, 그리고 [`'strict-dynamic'`](/ko/reference/configuration-reference/#securitycspscriptdirectivestrictdynamic) 지원 여부를 설명합니다. 각 소스와 해시는 `kind` 속성을 사용해 보다 구체적인 지시어를 대상으로 지정할 수 있습니다. `script-src-elem`에는 `'element'`를, `script-src-attr`에는 `'attribute'`를, `script-src`에는 `'default'`를 사용하세요. (`'default'`는 일반 문자열을 사용하는 것과 동일합니다.) + ##### `SSRManifest.csp.styleHashes` +:::caution[사용 중단] +대신 [`styleDirective`](#ssrmanifestcspstyledirective)를 사용하세요. 이 속성에는 일반 `style-src` 지시어에 해당하는 해시만 포함됩니다. 향후 메이저 버전에서 제거될 예정입니다. +::: +

**타입:** `string[]` @@ -2531,6 +2557,10 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지, ##### `SSRManifest.csp.styleResources` +:::caution[사용 중단] +대신 [`styleDirective`](#ssrmanifestcspstyledirective)를 사용하세요. 이 속성에는 일반 `style-src` 지시어에 해당하는 소스만 포함됩니다. 향후 메이저 버전에서 제거될 예정입니다. +::: +

**타입:** `string[]` @@ -2538,6 +2568,16 @@ CSP 지시어를 `meta` 요소로 삽입할지, 응답 `header`로 삽입할지, [설정된 스타일 리소스](/ko/reference/configuration-reference/#securitycspstyledirectiveresources)와 [삽입된 스타일 리소스](/ko/reference/api-reference/#cspinsertstyleresource)를 결합한 유효한 소스 목록을 지정합니다. +##### `SSRManifest.csp.styleDirective` + +

+ +**타입:** `{ resources: Array; hashes: Array }`
+ +

+ +`style-src` 관련 지시어에 대한 소스와 해시를 설명합니다. 각 소스와 해시는 `kind` 속성을 사용해 보다 구체적인 지시어를 대상으로 지정할 수 있습니다. `style-src-elem`에는 `'element'`를, `style-src-attr`에는 `'attribute'`를, `style-src`에는 `'default'`를 사용하세요. (`'default'`는 일반 문자열을 사용하는 것과 동일합니다.) + ##### `SSRManifest.csp.directives`

From 32e7e4b620ebdc3bd218a6844fbba4f3da82e805 Mon Sep 17 00:00:00 2001 From: Junseong Park <39112954+jsparkdev@users.noreply.github.com> Date: Fri, 17 Jul 2026 11:42:11 +0900 Subject: [PATCH 4/5] Update cli-reference.mdx --- src/content/docs/ko/reference/cli-reference.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/src/content/docs/ko/reference/cli-reference.mdx b/src/content/docs/ko/reference/cli-reference.mdx index 97916d1af6033..f4a6fb275c830 100644 --- a/src/content/docs/ko/reference/cli-reference.mdx +++ b/src/content/docs/ko/reference/cli-reference.mdx @@ -125,6 +125,7 @@ Flags --host Expose on a network IP address at --open Automatically open the app in the browser on server start --force Clear the content layer cache, forcing a full rebuild. + --ignore-lock Start the dev server even if another one is already running, without checking or writing the lock file. --allowed-hosts Specify a comma-separated list of allowed hosts or allow any hostname. --help (-h) See all available flags. ``` @@ -215,6 +216,20 @@ astro dev --background --force 자동 에이전트 감지 및 상태 확인 엔드포인트에 대한 자세한 내용은 [AI 코딩 에이전트를 위한 백그라운드 모드](/ko/guides/build-with-ai/#백그라운드-모드)를 참조하세요. +#### `--ignore-lock` + +

+ +다른 실행 중인 개발 서버를 감지하는 데 사용되는 잠금 파일을 확인하거나 기록하지 않고 개발 서버를 시작합니다. 이를 통해 오류를 발생시키는 대신, 동일한 프로젝트에서 이미 실행 중인 개발 서버와 함께 새 개발 서버를 시작할 수 있습니다. + +```shell +astro dev --ignore-lock --port 4322 +``` + +새로 시작한 서버는 `astro dev stop`, `astro dev status`, `astro dev logs`에서 추적되지 않습니다. + +`--background`(AI 코딩 에이전트가 실행한 경우 포함) 또는 `--force`와 함께 사용하면 오류가 발생합니다. 두 옵션 모두 잠금 파일에 의존하기 때문입니다. +

하위 명령어

From 9033b58d73110467d11da0d27bbe05b47220168d Mon Sep 17 00:00:00 2001 From: Junseong Park <39112954+jsparkdev@users.noreply.github.com> Date: Fri, 17 Jul 2026 11:48:34 +0900 Subject: [PATCH 5/5] Update content-loader-reference.mdx --- .../ko/reference/content-loader-reference.mdx | 28 ++++++++++++++++++- 1 file changed, 27 insertions(+), 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 e45f6804657da..491421ea5a7bb 100644 --- a/src/content/docs/ko/reference/content-loader-reference.mdx +++ b/src/content/docs/ko/reference/content-loader-reference.mdx @@ -34,7 +34,7 @@ Astro의 [`glob()`](#glob-로더) 및 [`file()`](#file-로더) 로더는 로컬 `glob()` 로더는 파일 시스템의 모든 위치에 있는 파일 디렉터리에서 엔트리를 생성합니다. 지원되는 파일 형식은 Markdown, MDX, Markdoc, JSON, YAML, TOML 파일입니다. -이 로더는 `pattern`, `base` (선택 사항), `generateId` (선택 사항), `retainBody` (선택 사항) 속성을 가진 객체를 인자로 받습니다. +이 로더는 `pattern`, `base` (선택 사항), `generateId` (선택 사항), `retainBody` (선택 사항), `deferRender` (선택 사항) 속성을 가진 객체를 인자로 받습니다. ```ts title="src/content.config.ts" import { defineCollection } from 'astro:content'; @@ -124,6 +124,32 @@ Markdown 파일의 경우 렌더링된 본문은 여전히 [`entry.rendered.html MDX 컬렉션의 경우 저장소에 더 이상 본문이 보존되지 않으므로 컬렉션 크기가 크게 줄어듭니다. +#### `deferRender` + +

+ +**타입:** `boolean`
+**기본값:** `false` + +

+ +Markdown 엔트리의 렌더링을 페이지에서 실제로 렌더링될 때까지 지연할지 여부입니다. `false`(기본값)인 경우 콘텐츠 동기화 중에 즉시 렌더링됩니다. 이 옵션은 MDX, Markdoc 및 데이터 엔트리(예: JSON, YAML)에는 적용되지 않습니다. + +기본적으로 `glob()` 로더는 동기화 중에 각 Markdown 엔트리를 렌더링하고, 생성된 HTML을 데이터 저장소에 저장합니다. 이를 통해 렌더링된 콘텐츠를 캐시하여 여러 빌드에서 재사용할 수 있습니다. 하지만 렌더링 결과가 원본보다 훨씬 큰 대규모 컬렉션의 경우, 렌더링된 HTML을 모두 한 번에 메모리에 저장하면 빌드 중 메모리가 부족해질 수 있습니다. + +`deferRender`가 `true`이면 `.mdx` 파일에서 이미 사용하는 것과 동일한 온디맨드 렌더링 방식을 사용하여, 각 엔트리가 페이지에서 실제로 렌더링될 때까지 렌더링을 미룹니다. 이렇게 하면 `astro build` 중 메모리 사용량을 일정하게 유지할 수 있지만, 렌더링된 HTML은 더 이상 데이터 저장소에 캐시되지 않습니다. + +```ts title="src/content.config.ts" +const docs = defineCollection({ + /* 빌드 중 메모리 부족을 방지하기 위해 대규모 Markdown 컬렉션의 렌더링을 지연합니다. */ + loader: glob({ + pattern: '**/*.md', + base: './src/data/docs', + deferRender: true, + }), +}); +``` + ### `file()` 로더