생성:2025-04-18마지막 업데이트:2025-06-29

이 문서를 원하는 AI 어시스턴트에 참조하세요

ChatGPT

Claude

DeepSeek

Google AI mode Gemini

Perplexity Mistral

Grok

이 페이지와 원하는 AI 어시스턴트를 사용하여 문서를 요약합니다

버전 기록

"초기 이력"
v5.5.102025. 6. 29.

이 페이지의 콘텐츠는 AI를 사용하여 번역되었습니다.

영어 원본 내용의 최신 버전을 보기

문서 수정

이 문서를 개선할 아이디어가 있으시면 GitHub에 풀 리퀘스트를 제출하여 자유롭게 기여해 주세요.

문서에 대한 GitHub 링크

복사

문서의 Markdown을 클립보드에 복사

Intlayer에서 `지역별` 콘텐츠 선언 방법

Name: Intlayer
Author: Intlayer

Intlayer는 다국어 콘텐츠를 선언하는 두 가지 방식을 지원합니다:

모든 번역을 포함한 단일 파일
지역별로 하나씩 파일을 나누는 방식 (지역별 형식)

이 유연성은 다음을 가능하게 합니다:

다른 i18n 도구에서의 손쉬운 마이그레이션
자동 번역 워크플로우 지원
번역을 별도의 지역별 파일로 명확하게 조직화

여러 번역을 포함한 단일 파일

이 형식은 다음에 적합합니다:

코드 내 빠른 반복 작업
CMS와의 원활한 통합

대부분의 사용 사례에 권장되는 접근 방식입니다. 번역을 중앙 집중화하여 반복 작업과 CMS 통합을 쉽게 만듭니다.

hello-world.content.ts

코드 복사

코드를 클립보드에 복사

import { t, type Dictionary } from "intlayer";

const helloWorldContent = {
  key: "hello-world",
  content: {
    multilingualContent: t({
      en: "Title of my component",
      es: "Título de mi componente",
    }),
  },
} satisfies Dictionary;

export default helloWorldContent;

권장: 이 형식은 Intlayer의 시각적 편집기를 사용하거나 코드 내에서 직접 번역을 관리할 때 가장 적합합니다.

로케일별 파일에 대한 전역 설정

intlayer.config.ts 파일에 다음을 추가하여 로케일별 파일에 대한 전역 설정을 구성할 수 있습니다:

코드 복사

코드를 클립보드에 복사

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  dictionary: {    locale: Locales.ENGLISH,  },};export default config;

이 구성을 사용하면 모든 로케일별 파일이 기본 로케일이 영어로 설정된 상태로 생성됩니다. 또한 extract 명령어와 컴파일러를 사용한 .content 파일 생성도 포함됩니다. (자세한 내용은 Compiler 또는 Extract를 참조하세요.)

로케일별 형식

이 형식은 다음과 같은 경우에 유용합니다:

번역을 독립적으로 버전 관리하거나 재정의하려는 경우.
기계 번역 또는 인간 번역 워크플로우를 통합하는 경우.

로케일 필드를 지정하여 번역을 개별 로케일 파일로 분리할 수도 있습니다:

hello-world.es.content.ts

코드 복사

코드를 클립보드에 복사

import { t, Locales, type Dictionary } from "intlayer";

const helloWorldContent = {
  key: "hello-world",
  locale: Locales.SPANISH, // 중요
  content: { multilingualContent: "Título de mi componente" },
} satisfies Dictionary;

export default helloWorldContent;

중요: locale 필드가 정의되어 있는지 반드시 확인하세요. 이 필드는 Intlayer에 해당 파일이 어떤 언어를 나타내는지 알려줍니다.

참고: 두 경우 모두, 콘텐츠 선언 파일은 Intlayer에서 인식되기 위해 *.content.{ts,tsx,js,jsx,mjs,cjs,json} 명명 패턴을 따라야 합니다. .[locale] 접미사는 선택 사항이며 명명 규칙으로만 사용됩니다.

형식 혼합

동일한 콘텐츠 키에 대해 두 가지 선언 방식을 결합할 수 있습니다. 예를 들어:

index.content.ts와 같은 파일에서 기본 콘텐츠를 정적으로 선언합니다.
index.fr.content.ts 또는 index.content.json과 같은 별도의 파일에서 특정 번역을 추가하거나 덮어씁니다.

이 설정은 특히 다음과 같은 경우에 유용합니다:

코드에서 초기 콘텐츠 구조를 정의하려는 경우.
나중에 CMS 또는 자동화 도구를 사용하여 번역을 보완하거나 완성하려는 경우.

bash

코드 복사

코드를 클립보드에 복사

.└── Components    └── MyComponent        ├── index.content.ts        ├── index.content.json        └── index.ts

예시

다국어 콘텐츠 선언 파일 예시:

Components/MyComponent/index.content.ts

코드 복사

코드를 클립보드에 복사

import { t, type Dictionary } from "intlayer";const helloWorldContent = {  key: "hello-world",  locale: Locales.ENGLISH,  content: {    multilingualContent: "내 컴포넌트의 제목",    projectName: "내 프로젝트",  },} satisfies Dictionary;export default helloWorldContent;

Components/MyComponent/index.content.json

코드 복사

코드를 클립보드에 복사

{  "$schema": "https://intlayer.org/schema.json",  "key": "hello-world",  "content": {    "multilingualContent": {      "nodeType": "translation",      "translation": {        "fr": "Titre de mon composant",        "es": "Título de mi componente"      }    }  }}

Intlayer는 다국어 및 로케일별 파일을 자동으로 병합합니다.

Components/MyComponent/index.ts

코드 복사

코드를 클립보드에 복사

import { getIntlayer, Locales } from "intlayer";const intlayer = getIntlayer("hello-world"); // 기본 로케일은 ENGLISH이므로 ENGLISH 콘텐츠를 반환합니다.console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "내 컴포넌트의 제목",//  "projectName": "내 프로젝트"// }const intlayer = getIntlayer("hello-world", Locales.SPANISH);console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "Título de mi componente",//  "projectName": "내 프로젝트"// }const intlayer = getIntlayer("hello-world", Locales.FRENCH);console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "Titre de mon composant",//  "projectName": "내 프로젝트"// }

자동 번역 생성

intlayer CLI를 사용하여 선호하는 서비스를 기반으로 누락된 번역을 자동으로 채우세요.

함수 가져오기

컴파일러

생성:2025-04-18마지막 업데이트:2025-06-29

이 문서를 원하는 AI 어시스턴트에 참조하세요

ChatGPT

Claude

DeepSeek

Google AI mode Gemini

Perplexity Mistral

Grok

이 페이지와 원하는 AI 어시스턴트를 사용하여 문서를 요약합니다

버전 기록

"초기 이력"
v5.5.102025. 6. 29.

이 페이지의 콘텐츠는 AI를 사용하여 번역되었습니다.

영어 원본 내용의 최신 버전을 보기

문서 수정

이 문서를 개선할 아이디어가 있으시면 GitHub에 풀 리퀘스트를 제출하여 자유롭게 기여해 주세요.

문서에 대한 GitHub 링크

복사

문서의 Markdown을 클립보드에 복사

Intlayer에서 `지역별` 콘텐츠 선언 방법

Intlayer는 다국어 콘텐츠를 선언하는 두 가지 방식을 지원합니다:

모든 번역을 포함한 단일 파일
지역별로 하나씩 파일을 나누는 방식 (지역별 형식)

이 유연성은 다음을 가능하게 합니다:

다른 i18n 도구에서의 손쉬운 마이그레이션
자동 번역 워크플로우 지원
번역을 별도의 지역별 파일로 명확하게 조직화

여러 번역을 포함한 단일 파일

이 형식은 다음에 적합합니다:

코드 내 빠른 반복 작업
CMS와의 원활한 통합

대부분의 사용 사례에 권장되는 접근 방식입니다. 번역을 중앙 집중화하여 반복 작업과 CMS 통합을 쉽게 만듭니다.

hello-world.content.ts

코드 복사

코드를 클립보드에 복사

import { t, type Dictionary } from "intlayer";

const helloWorldContent = {
  key: "hello-world",
  content: {
    multilingualContent: t({
      en: "Title of my component",
      es: "Título de mi componente",
    }),
  },
} satisfies Dictionary;

export default helloWorldContent;

권장: 이 형식은 Intlayer의 시각적 편집기를 사용하거나 코드 내에서 직접 번역을 관리할 때 가장 적합합니다.

로케일별 파일에 대한 전역 설정

intlayer.config.ts 파일에 다음을 추가하여 로케일별 파일에 대한 전역 설정을 구성할 수 있습니다:

코드 복사

코드를 클립보드에 복사

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  dictionary: {    locale: Locales.ENGLISH,  },};export default config;

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  dictionary: {    locale: Locales.ENGLISH,  },};export default config;

로케일별 형식

이 형식은 다음과 같은 경우에 유용합니다:

번역을 독립적으로 버전 관리하거나 재정의하려는 경우.
기계 번역 또는 인간 번역 워크플로우를 통합하는 경우.

로케일 필드를 지정하여 번역을 개별 로케일 파일로 분리할 수도 있습니다:

hello-world.es.content.ts

코드 복사

코드를 클립보드에 복사

import { t, Locales, type Dictionary } from "intlayer";

const helloWorldContent = {
  key: "hello-world",
  locale: Locales.SPANISH, // 중요
  content: { multilingualContent: "Título de mi componente" },
} satisfies Dictionary;

export default helloWorldContent;

중요: locale 필드가 정의되어 있는지 반드시 확인하세요. 이 필드는 Intlayer에 해당 파일이 어떤 언어를 나타내는지 알려줍니다.

참고: 두 경우 모두, 콘텐츠 선언 파일은 Intlayer에서 인식되기 위해 *.content.{ts,tsx,js,jsx,mjs,cjs,json} 명명 패턴을 따라야 합니다. .[locale] 접미사는 선택 사항이며 명명 규칙으로만 사용됩니다.

형식 혼합

동일한 콘텐츠 키에 대해 두 가지 선언 방식을 결합할 수 있습니다. 예를 들어:

index.content.ts와 같은 파일에서 기본 콘텐츠를 정적으로 선언합니다.
index.fr.content.ts 또는 index.content.json과 같은 별도의 파일에서 특정 번역을 추가하거나 덮어씁니다.

이 설정은 특히 다음과 같은 경우에 유용합니다:

코드에서 초기 콘텐츠 구조를 정의하려는 경우.
나중에 CMS 또는 자동화 도구를 사용하여 번역을 보완하거나 완성하려는 경우.

bash

코드 복사

코드를 클립보드에 복사

.└── Components    └── MyComponent        ├── index.content.ts        ├── index.content.json        └── index.ts

.└── Components    └── MyComponent        ├── index.content.ts        ├── index.content.json        └── index.ts

예시

다국어 콘텐츠 선언 파일 예시:

Components/MyComponent/index.content.ts

코드 복사

코드를 클립보드에 복사

import { t, type Dictionary } from "intlayer";const helloWorldContent = {  key: "hello-world",  locale: Locales.ENGLISH,  content: {    multilingualContent: "내 컴포넌트의 제목",    projectName: "내 프로젝트",  },} satisfies Dictionary;export default helloWorldContent;

import { t, type Dictionary } from "intlayer";const helloWorldContent = {  key: "hello-world",  locale: Locales.ENGLISH,  content: {    multilingualContent: "내 컴포넌트의 제목",    projectName: "내 프로젝트",  },} satisfies Dictionary;export default helloWorldContent;

Components/MyComponent/index.content.json

코드 복사

코드를 클립보드에 복사

{  "$schema": "https://intlayer.org/schema.json",  "key": "hello-world",  "content": {    "multilingualContent": {      "nodeType": "translation",      "translation": {        "fr": "Titre de mon composant",        "es": "Título de mi componente"      }    }  }}

{  "$schema": "https://intlayer.org/schema.json",  "key": "hello-world",  "content": {    "multilingualContent": {      "nodeType": "translation",      "translation": {        "fr": "Titre de mon composant",        "es": "Título de mi componente"      }    }  }}

Intlayer는 다국어 및 로케일별 파일을 자동으로 병합합니다.

Components/MyComponent/index.ts

코드 복사

코드를 클립보드에 복사

import { getIntlayer, Locales } from "intlayer";const intlayer = getIntlayer("hello-world"); // 기본 로케일은 ENGLISH이므로 ENGLISH 콘텐츠를 반환합니다.console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "내 컴포넌트의 제목",//  "projectName": "내 프로젝트"// }const intlayer = getIntlayer("hello-world", Locales.SPANISH);console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "Título de mi componente",//  "projectName": "내 프로젝트"// }const intlayer = getIntlayer("hello-world", Locales.FRENCH);console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "Titre de mon composant",//  "projectName": "내 프로젝트"// }

import { getIntlayer, Locales } from "intlayer";const intlayer = getIntlayer("hello-world"); // 기본 로케일은 ENGLISH이므로 ENGLISH 콘텐츠를 반환합니다.console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "내 컴포넌트의 제목",//  "projectName": "내 프로젝트"// }const intlayer = getIntlayer("hello-world", Locales.SPANISH);console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "Título de mi componente",//  "projectName": "내 프로젝트"// }const intlayer = getIntlayer("hello-world", Locales.FRENCH);console.log(JSON.stringify(intlayer, null, 2));// 결과:// {//  "multilingualContent": "Titre de mon composant",//  "projectName": "내 프로젝트"// }

자동 번역 생성

intlayer CLI를 사용하여 선호하는 서비스를 기반으로 누락된 번역을 자동으로 채우세요.

함수 가져오기

컴파일러

버전 기록

Intlayer에서 지역별 콘텐츠 선언 방법

여러 번역을 포함한 단일 파일

로케일별 파일에 대한 전역 설정

로케일별 형식

형식 혼합

예시

자동 번역 생성

버전 기록

Intlayer에서 지역별 콘텐츠 선언 방법

여러 번역을 포함한 단일 파일

로케일별 파일에 대한 전역 설정

로케일별 형식

형식 혼합

예시

자동 번역 생성

Intlayer에서 `지역별` 콘텐츠 선언 방법

Intlayer에서 `지역별` 콘텐츠 선언 방법