레거시 플래그

일부 사용자들의 Astro 버전 간 마이그레이션을 돕기 위해, 때때로 우리는 legacy 플래그를 도입합니다.

이러한 플래그를 통해 최신 버전의 Astro에서 더 이상 사용되지 않거나 구식이 된 동작을 선택적으로 사용할 수 있으며, 프로젝트 코드를 완전히 업데이트할 수 있을 때까지 새로운 Astro 릴리스의 이점을 계속해서 활용할 수 있습니다.

collectionsBackwardsCompat

타입: boolean
기본값: false

추가된 버전: astro@6.0.0 새로운 기능

legacy.collectionsBackwardsCompat 플래그는 v5.0에서 도입된 콘텐츠 레이어 API로 마이그레이션할 수 없는 프로젝트를 위해 일시적인 하위 호환성을 제공합니다.

astro.config.mjs

export default defineConfig({
  legacy: {
    collectionsBackwardsCompat: true,
  },
});

이 플래그는 몇 가지 레거시 v4 콘텐츠 컬렉션 기능을 유지합니다:

• 로더 없이 type: 'content' 및 type: 'data'를 지원합니다.
• 레거시 엔트리 API(entry.slug 및 entry.render())를 유지합니다.
• 슬러그 기반 ID 대신 경로 기반 엔트리 ID를 사용합니다.

이 플래그는 일시적인 마이그레이션 도우미입니다. 컬렉션을 콘텐츠 레이어 API로 마이그레이션한 후 이 플래그를 비활성화하세요.