Intlayer를 사용하여 i18next JSON 번역 자동화하는 방법

Intlayer란 무엇인가요?

Intlayer는 전통적인 i18n 솔루션의 한계를 극복하기 위해 설계된 혁신적이고 오픈 소스인 국제화 라이브러리입니다. JavaScript 애플리케이션에서 현대적인 콘텐츠 관리를 제공합니다.

i18next와의 구체적인 비교는 저희 블로그 게시물 next-i18next vs. next-intl vs. Intlayer에서 확인할 수 있습니다.

왜 Intlayer와 i18next를 함께 사용해야 할까요?

Intlayer는 훌륭한 독립형 i18n 솔루션을 제공하지만(자세한 내용은 Next.js 통합 가이드를 참조), 다음과 같은 여러 이유로 i18next와 함께 사용하고자 할 수 있습니다:

1. 기존 코드베이스: 이미 구축된 i18next 구현이 있으며 Intlayer의 향상된 개발자 경험으로 점진적으로 이전하고자 할 때.
2. 레거시 요구사항: 프로젝트가 기존 i18next 플러그인 또는 워크플로우와의 호환성을 필요로 할 때.
3. 팀 친숙도: 팀이 i18next에 익숙하지만 더 나은 콘텐츠 관리를 원할 때.

이를 위해 Intlayer는 i18next의 어댑터로 구현되어 CLI 또는 CI/CD 파이프라인에서 JSON 번역 자동화, 번역 테스트 등 다양한 작업을 지원할 수 있습니다.

이 가이드는 i18next와의 호환성을 유지하면서 Intlayer의 우수한 콘텐츠 선언 시스템을 활용하는 방법을 보여줍니다.

목차

i18next와 함께 Intlayer 설정 단계별 가이드

1단계: 의존성 설치

필요한 패키지를 설치하세요:

npm install intlayer @intlayer/sync-json-plugin

패키지 설명:

• intlayer: 국제화 관리, 콘텐츠 선언 및 빌드를 위한 핵심 라이브러리
• @intlayer/sync-json-plugin: Intlayer 콘텐츠 선언을 i18next 호환 JSON 형식으로 내보내는 플러그인

2단계: JSON을 래핑하기 위한 Intlayer 플러그인 구현

지원하는 로케일을 정의하기 위해 Intlayer 구성 파일을 만드세요:

i18next용 JSON 사전도 내보내고 싶다면, syncJSON 플러그인을 추가하세요:

import { Locales, type IntlayerConfig } from "intlayer";import { syncJSON } from "@intlayer/sync-json-plugin";const config: IntlayerConfig = {  internationalization: {    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],    defaultLocale: Locales.ENGLISH,  },  plugins: [    syncJSON({      source: ({ key, locale }) => `./intl/messages/${locale}/${key}.json`,    }),  ],};export default config;

syncJSON 플러그인은 JSON을 자동으로 래핑합니다. 콘텐츠 구조를 변경하지 않고 JSON 파일을 읽고 씁니다.

만약 JSON과 intlayer 콘텐츠 선언 파일(.content 파일)을 공존시키고 싶다면, Intlayer는 다음과 같이 처리합니다:

1. JSON과 콘텐츠 선언 파일을 모두 로드하여 intlayer 사전(dictionary)으로 변환합니다.

2. JSON과 콘텐츠 선언 파일 간에 충돌이 있을 경우, Intlayer는 모든 사전을 병합하는 과정을 진행합니다. 이는 플러그인의 우선순위와 콘텐츠 선언 파일의 우선순위에 따라 결정되며(모두 구성 가능합니다).

CLI를 사용하여 JSON을 번역하거나 CMS를 통해 변경 사항이 발생하면, Intlayer는 새로운 번역으로 JSON 파일을 업데이트합니다.

Git 구성

자동 생성된 Intlayer 파일을 무시하는 것이 권장됩니다:

# Intlayer에서 생성된 파일 무시.intlayer

이 파일들은 빌드 과정 중에 다시 생성될 수 있으므로 버전 관리에 커밋할 필요가 없습니다.

VS Code 확장 프로그램

개발자 경험을 향상시키기 위해 공식 Intlayer VS Code 확장 프로그램을 설치하세요:

VS Code 마켓플레이스에서 설치하기

2. JSON과 콘텐츠 선언 파일 간에 충돌이 있는 경우, Intlayer는 모든 사전을 병합하여 처리합니다. 플러그인의 우선순위와 콘텐츠 선언 파일의 우선순위에 따라 달라집니다(모두 구성 가능).

CLI를 사용하여 JSON을 번역하거나 CMS를 사용하여 변경 사항이 이루어지면, Intlayer는 새로운 번역으로 JSON 파일을 업데이트합니다.

Git 구성

자동 생성된 Intlayer 파일을 무시하는 것이 권장됩니다:

# Intlayer에서 생성된 파일 무시.intlayer

이 파일들은 빌드 과정 중에 다시 생성될 수 있으므로 버전 관리에 커밋할 필요가 없습니다.

VS Code 확장 프로그램

개발자 경험 향상을 위해 공식 Intlayer VS Code 확장 프로그램을 설치하세요:

VS Code 마켓플레이스에서 설치하기