import { Locales, type Dictionary } from "intlayer";const exampleContent = {  key: "example",  locale: Locales.ENGLISH,  autoFill: "./example.content.json",  content: {    contentExample: "이것은 콘텐츠의 예시입니다",  },} satisfies Dictionary;export default exampleContent;

다음은 autoFill 지시어를 사용한 로케일별 콘텐츠 선언 파일입니다.

그런 다음, 다음 명령어를 실행하면:

bash

코드 복사

코드를 클립보드에 복사

npx intlayer fill --file 'src/components/example/example.content.ts'

Intlayer는 메인 파일에 아직 선언되지 않은 모든 로케일을 채워 src/components/example/example.content.json에 파생 선언 파일을 자동으로 생성합니다.

src/components/example/example.content.json

코드 복사

코드를 클립보드에 복사

{  "key": "example",  "content": {    "contentExample": {      "nodeType": "translation",      "translation": {        "fr": "Ceci est un exemple de contenu",        "es": "Este es un ejemplo de contenido",      },    },  },}

그 후, 두 선언 파일은 단일 사전으로 병합되어 표준 useIntlayer("example") 훅(react) / 컴포저블(vue)을 통해 접근할 수 있습니다.

자동 채워진 파일 형식

자동 채워진 선언 파일에 권장되는 형식은 JSON으로, 형식 제약을 피하는 데 도움이 됩니다. 그러나 Intlayer는 .ts, .js, .mjs, .cjs 및 기타 형식도 지원합니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "./example.filled.content.ts",  content: {    // 여기에 내용을 작성하세요  },};

이렇게 하면 다음 위치에 파일이 생성됩니다:

plaintext

코드 복사

코드를 클립보드에 복사

src/components/example/example.filled.content.ts

.js, .ts 및 유사한 파일 생성은 다음과 같이 작동합니다:

파일이 이미 존재하는 경우, Intlayer는 AST(추상 구문 트리)를 사용하여 각 필드를 찾아 누락된 번역을 삽입합니다.
파일이 존재하지 않는 경우, Intlayer는 기본 콘텐츠 선언 파일 템플릿을 사용하여 파일을 생성합니다.

절대 경로

autoFill 필드는 절대 경로도 지원합니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "/messages/example.content.json",  content: {    // 여기에 콘텐츠 작성  },};

이렇게 하면 다음 위치에 파일이 생성됩니다:

plaintext

코드 복사

코드를 클립보드에 복사

/messages/example.content.json

로케일별 콘텐츠 선언 파일 자동 생성

autoFill 필드는 로케일별 콘텐츠 선언 파일 생성을 지원합니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",    es: "./example.es.content.json",  },  content: {    // 귀하의 콘텐츠  },};

이렇게 하면 두 개의 별도 파일이 생성됩니다:

src/components/example/example.fr.content.json
src/components/example/example.es.content.json

이 경우, 객체에 모든 로케일이 포함되어 있지 않으면 Intlayer는 나머지 로케일의 생성을 건너뜁니다.

특정 로케일 자동 채우기 필터링

autoFill 필드에 객체를 사용하면 필터를 적용하여 특정 로케일 파일만 생성할 수 있습니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",  },  content: {    // 귀하의 콘텐츠  },};

이렇게 하면 프랑스어 번역 파일만 생성됩니다.

경로 변수

autoFill 경로 내에서 변수를 사용하여 생성된 파일의 대상 경로를 동적으로 해결할 수 있습니다.

사용 가능한 변수:

{{locale}} – 로케일 코드 (예: fr, es)
{{fileName}} – 파일 이름 (예: index)
{{key}} – 사전 키 (예: example)

src/components/example/index.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "/messages/{{locale}}/{{key}}.content.json",  content: {    // 여기에 내용을 작성하세요  },};

이 코드는 다음 파일들을 생성합니다:

/messages/fr/example.content.json
/messages/es/example.content.json

src/components/example/index.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "./{{fileName}}.content.json",  content: {    // 여기에 내용을 작성하세요  },};

이 코드는 다음 파일들을 생성합니다:

./index.content.json
./index.content.json

컴파일러

테스트

생성:2025-03-13마지막 업데이트:2025-09-20

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

ChatGPT

Claude

DeepSeek

Google AI mode Gemini

Perplexity Mistral

Grok

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

버전 기록

"전역 구성 추가"
v6.0.02025. 9. 20.
"`{{fileName}}` 변수 추가"
v6.0.02025. 9. 17.
"이력 초기화"
v5.5.102025. 6. 29.

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

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

문서 수정

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

문서에 대한 GitHub 링크

복사

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

자동 채우기 콘텐츠 선언 파일 번역

자동 채우기 콘텐츠 선언 파일은 개발 워크플로우를 가속화하는 방법입니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

import { Locales, type Dictionary } from "intlayer";const exampleContent = {  key: "example",  locale: Locales.ENGLISH,  autoFill: "./example.content.json",  content: {    contentExample: "이것은 콘텐츠의 예시입니다",  },} satisfies Dictionary;export default exampleContent;

import { Locales, type Dictionary } from "intlayer";const exampleContent = {  key: "example",  locale: Locales.ENGLISH,  autoFill: "./example.content.json",  content: {    contentExample: "이것은 콘텐츠의 예시입니다",  },} satisfies Dictionary;export default exampleContent;

다음은 autoFill 지시어를 사용한 로케일별 콘텐츠 선언 파일입니다.

그런 다음, 다음 명령어를 실행하면:

bash

코드 복사

코드를 클립보드에 복사

npx intlayer fill --file 'src/components/example/example.content.ts'

npx intlayer fill --file 'src/components/example/example.content.ts'

Intlayer는 메인 파일에 아직 선언되지 않은 모든 로케일을 채워 src/components/example/example.content.json에 파생 선언 파일을 자동으로 생성합니다.

src/components/example/example.content.json

코드 복사

코드를 클립보드에 복사

{  "key": "example",  "content": {    "contentExample": {      "nodeType": "translation",      "translation": {        "fr": "Ceci est un exemple de contenu",        "es": "Este es un ejemplo de contenido",      },    },  },}

{  "key": "example",  "content": {    "contentExample": {      "nodeType": "translation",      "translation": {        "fr": "Ceci est un exemple de contenu",        "es": "Este es un ejemplo de contenido",      },    },  },}

그 후, 두 선언 파일은 단일 사전으로 병합되어 표준 useIntlayer("example") 훅(react) / 컴포저블(vue)을 통해 접근할 수 있습니다.

자동 채워진 파일 형식

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "./example.filled.content.ts",  content: {    // 여기에 내용을 작성하세요  },};

const exampleContent = {  key: "example",  autoFill: "./example.filled.content.ts",  content: {    // 여기에 내용을 작성하세요  },};

이렇게 하면 다음 위치에 파일이 생성됩니다:

plaintext

코드 복사

코드를 클립보드에 복사

src/components/example/example.filled.content.ts

src/components/example/example.filled.content.ts

.js, .ts 및 유사한 파일 생성은 다음과 같이 작동합니다:

파일이 이미 존재하는 경우, Intlayer는 AST(추상 구문 트리)를 사용하여 각 필드를 찾아 누락된 번역을 삽입합니다.
파일이 존재하지 않는 경우, Intlayer는 기본 콘텐츠 선언 파일 템플릿을 사용하여 파일을 생성합니다.

절대 경로

autoFill 필드는 절대 경로도 지원합니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "/messages/example.content.json",  content: {    // 여기에 콘텐츠 작성  },};

const exampleContent = {  key: "example",  autoFill: "/messages/example.content.json",  content: {    // 여기에 콘텐츠 작성  },};

이렇게 하면 다음 위치에 파일이 생성됩니다:

plaintext

코드 복사

코드를 클립보드에 복사

/messages/example.content.json

/messages/example.content.json

로케일별 콘텐츠 선언 파일 자동 생성

autoFill 필드는 로케일별 콘텐츠 선언 파일 생성을 지원합니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",    es: "./example.es.content.json",  },  content: {    // 귀하의 콘텐츠  },};

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",    es: "./example.es.content.json",  },  content: {    // 귀하의 콘텐츠  },};

이렇게 하면 두 개의 별도 파일이 생성됩니다:

src/components/example/example.fr.content.json
src/components/example/example.es.content.json

이 경우, 객체에 모든 로케일이 포함되어 있지 않으면 Intlayer는 나머지 로케일의 생성을 건너뜁니다.

특정 로케일 자동 채우기 필터링

autoFill 필드에 객체를 사용하면 필터를 적용하여 특정 로케일 파일만 생성할 수 있습니다.

src/components/example/example.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",  },  content: {    // 귀하의 콘텐츠  },};

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",  },  content: {    // 귀하의 콘텐츠  },};

이렇게 하면 프랑스어 번역 파일만 생성됩니다.

경로 변수

autoFill 경로 내에서 변수를 사용하여 생성된 파일의 대상 경로를 동적으로 해결할 수 있습니다.

사용 가능한 변수:

{{locale}} – 로케일 코드 (예: fr, es)
{{fileName}} – 파일 이름 (예: index)
{{key}} – 사전 키 (예: example)

src/components/example/index.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "/messages/{{locale}}/{{key}}.content.json",  content: {    // 여기에 내용을 작성하세요  },};

const exampleContent = {  key: "example",  autoFill: "/messages/{{locale}}/{{key}}.content.json",  content: {    // 여기에 내용을 작성하세요  },};

이 코드는 다음 파일들을 생성합니다:

/messages/fr/example.content.json
/messages/es/example.content.json

src/components/example/index.content.ts

코드 복사

코드를 클립보드에 복사

const exampleContent = {  key: "example",  autoFill: "./{{fileName}}.content.json",  content: {    // 여기에 내용을 작성하세요  },};

const exampleContent = {  key: "example",  autoFill: "./{{fileName}}.content.json",  content: {    // 여기에 내용을 작성하세요  },};

이 코드는 다음 파일들을 생성합니다:

./index.content.json
./index.content.json

컴파일러

테스트