astro-i18n-aut Astro를 위한 i18n 통합 🧑‍🚀

모든 Astro 크루원을 위해 ❤️로 제작됨 🧑‍🚀

동기

Astro를 위한 국제화(i18n) 통합 제공:

• defaultLocale 지원
• 템플릿 파일 중복 방지
• 어댑터 독립적
• UI 프레임워크 독립적
• @astrojs/sitemap과 호환 가능

빠른 시작

설치

npm을 통해 설치:

npm install astro-i18n-aut

구성

Astro 구성 파일에서:

import { defineConfig } from "astro/config";
import { i18n, filterSitemapByDefaultLocale } from "astro-i18n-aut/integration";
import sitemap from "@astrojs/sitemap";
const defaultLocale = "en";
const locales = {
  en: "en-US", // the defaultLocale value must present in locales keys
  es: "es-ES",
  fr: "fr-CA",
};
export default defineConfig({
  site: "https://example.com/",
  trailingSlash: "always",
  build: {
    format: "directory",
  },
  integrations: [
    i18n({
      locales,
      defaultLocale,
    }),
    sitemap({
      i18n: {
        locales,
        defaultLocale,
      },
      filter: filterSitemapByDefaultLocale({ defaultLocale }),
    }),
  ],
});

astro_tmp_pages_*

사용법

이제 설정을 완료했으므로, 각 .astro 페이지는 다른 언어로 추가 렌더링됩니다. 예를 들어, src/pages/about.astro는 다음과 같이 렌더링됩니다:

• /about/
• /es/about/
• /fr/about/

• /en/about/ => /about/

Astro 프론트매터와 페이지 내용은 모든 번역된 페이지마다 다시 실행됩니다. 예를 들어, Astro.url.pathname은 다음과 같습니다:

• /about/
• /es/about/
• /fr/about/

---
import { getLocale } from "astro-i18n-aut";
import Layout from "../layouts/Layout.astro";
const locale = getLocale(Astro.url);
let title: string;
switch (locale) {
  case "es":
    title = "¡Hola Mundo!";
    break;
  case "fr":
    title = "Bonjour Monde!";
    break;
  default:
    title = "Hello World!";
}

  
{title}

Astro 구성 옵션

자세한 내용은 공식 Astro 문서를 참조하세요:

• site
• trailingSlash
• format

•   {

#### 페이지 제외하기
Astro의 문서에는 다음과 같이 나와 있습니다:
페이지나 디렉터리 이름 앞에 밑줄(_)을 붙여 빌드에서 제외할 수 있습니다. _ 접두사가 붙은 파일은 라우터에서 인식되지 않으며 dist/ 디렉터리에 포함되지 않습니다.
>
이를 사용하여 페이지를 일시적으로 비활성화하거나 테스트, 유틸리티, 컴포넌트를 관련 페이지와 같은 폴더에 넣을 수 있습니다.
불행히도, 이 페이지 제외하기 기능은 지원되지 않습니다. 페이지 디렉터리에는 페이지만 보관하시기 바랍니다.
밑줄(_)로 시작하는 페이지를 제외하려면 무시할 glob 패턴에 pages//_*를 추가할 수 있습니다:

#### Markdown
.md 및 .mdx의 경우 Astro Content Collections를 사용하세요.
이 라이브러리와 Astro Content Collections를 사용하면 content 내에서 Markdown을 분리하고 체계적으로 관리할 수 있으며, pages/blog/index.astro 및 pages/blog/[slug].astro를 사용하여 defaultLocale이 있어도 모든 콘텐츠를 렌더링할 수 있습니다! 다음은 예시 폴더 구조입니다:

Astro는 페이지 파일 유형으로 .tsx 또는 .jsx를 지원하지 않습니다.

React와 Vue와 같은 UI 프레임워크는 Astro에서 일반적으로 사용하는 것처럼 컴포넌트로 가져와 사용하세요.

번역된 콘텐츠 title={t('title')} 또는 로케일 locale={locale}을 props로 전달해도 됩니다.

#### 엔드포인트

기본적으로 pages/api//* 내의 모든 페이지는 무시됩니다.

.ts 및 .js` 엔드포인트의 경우, 다중 로케일을 처리하는 방법은 여러분에게 달려 있습니다. 엔드포인트는 사용자에게 직접 보이지 않고, 사용하는 방법도 다양하기 때문에 구현은 여러분의 선택에 맡깁니다.

라이선스

MIT 라이선스

기여

PR 환영합니다! 도움에 감사드립니다. 버그 신고 및 PR 작성에 관한 자세한 내용은 기여 가이드를 참고하세요.

--- Tranlated By Open Ai Tx | Last indexed: 2026-07-24 ---