국제화 API 참조
Added in:
astro@3.5.0
이 모듈은 프로젝트에 구성된 로케일을 사용하여 URL을 생성하는 데 도움이 되는 함수를 제공합니다.
i18n 라우터를 사용하여 프로젝트에 대한 경로를 생성하는 것은 페이지 경로에 영향을 주는 특정 구성 값에 따라 달라집니다. 이러한 함수를 사용하여 경로를 생성할 때 다음에 대한 개별 설정을 고려해야 합니다.
또한 defaultLocale
에 대해 이러한 함수에서 반환된 URL은 i18n.routing
구성을 반영합니다.
기능 및 사용 예시는 i18n 라우팅 가이드를 참조하세요.
astro:i18n
에서 가져오기
섹션 제목: astro:i18n에서 가져오기getRelativeLocaleUrl()
섹션 제목: getRelativeLocaleUrl()타입: (locale: string, path?: string, options?: GetLocaleOptions) => string
이 함수를 사용하여 로케일의 상대 경로를 검색합니다. 해당 로케일이 존재하지 않으면 Astro는 오류를 발생시킵니다.
getAbsoluteLocaleUrl()
섹션 제목: getAbsoluteLocaleUrl()타입: (locale: string, path: string, options?: GetLocaleOptions) => string
[site
]의 값이 존재할 때 로케일의 절대 경로를 검색하려면 이 함수를 사용하세요. [site
]가 구성되지 않은 경우 함수는 상대 URL을 반환합니다. 해당 로케일이 존재하지 않으면 Astro는 오류를 발생시킵니다.
getRelativeLocaleUrlList()
섹션 제목: getRelativeLocaleUrlList()타입: (path?: string, options?: GetLocaleOptions) => string[]
모든 로케일에 대한 상대 경로 목록을 반환하려면 getRelativeLocaleUrl
처럼 이 함수를 사용하세요.
getAbsoluteLocaleUrlList()
섹션 제목: getAbsoluteLocaleUrlList()타입: (path?: string, options?: GetLocaleOptions) => string[]
모든 로케일에 대한 절대 경로 목록을 반환하려면 getAbsoluteLocaleUrl
처럼 이 함수를 사용하세요.
getPathByLocale()
섹션 제목: getPathByLocale()타입: (locale: string) => string
사용자 정의 로케일 경로가 구성된 경우 하나 이상의 codes
와 연결된 path
를 반환하는 함수입니다.
getLocaleByPath()
섹션 제목: getLocaleByPath()타입: (path: string) => string
로케일 path
와 연관된 code
를 반환하는 함수입니다.
redirectToDefaultLocale()
섹션 제목: redirectToDefaultLocale()타입: (context: APIContext, statusCode?: ValidRedirectStatus) => Promise<Response>
astro@4.6.0
i18n.routing
이 "manual"
로 설정된 경우에만 사용할 수 있습니다.
구성된 defaultLocale
로 리디렉션되는 Response
를 반환하는 함수입니다. 유효한 리디렉션 상태 코드를 선택적으로 허용합니다.
redirectToFallback()
섹션 제목: redirectToFallback()타입: (context: APIContext, response: Response) => Promise<Response>
astro@4.6.0
i18n.routing
이 "manual"
로 설정된 경우에만 사용할 수 있습니다.
자체 미들웨어에서 i18n.fallback
구성을 사용할 수 있게 해주는 함수입니다.
notFound()
섹션 제목: notFound()타입: (context: APIContext, response?: Response) => Promise<Response> | undefined
astro@4.6.0
i18n.routing
이 "manual"
로 설정된 경우에만 사용할 수 있습니다.
다음과 같은 경우 라우팅 미들웨어에서 이 함수를 사용하여 404를 반환합니다.
- 현재 경로가 루트가 아닌 경우. 예를 들어
/
또는/<base>
- URL에 로케일이 포함되어 있지 않은 경우
Response
가 전달되면 이 함수에서 내보낸 새 Response
에는 원래 응답과 동일한 헤더가 포함됩니다.
middleware()
섹션 제목: middleware()타입: (options: { prefixDefaultLocale: boolean, redirectToDefaultLocale: boolean }) => MiddlewareHandler
astro@4.6.0
i18n.routing
이 "manual"
로 설정된 경우에만 사용할 수 있습니다.
Astro i18n 미들웨어를 프로그래밍 방식으로 생성할 수 있는 함수입니다.
이는 기본 i18n 로직을 계속 사용하고 싶지만 웹 사이트에 몇 가지 예외만 추가하려는 경우에 유용합니다.
requestHasLocale()
섹션 제목: requestHasLocale()타입: (context: APIContext) => boolean
astro@4.6.0
i18n.routing
이 "manual"
로 설정된 경우에만 사용할 수 있습니다.
현재 URL에 구성된 로케일이 포함되어 있는지 확인합니다. 내부적으로 이 함수는 APIContext#url.pathname
을 사용합니다.