Intlayer 문서

공식 Intlayer 문서에 오신 것을 환영합니다! 여기에서는 Next.js, React, Vite, Express 또는 기타 자바스크립트 환경에서 작업하든, 모든 국제화(i18n) 요구 사항을 위해 Intlayer를 통합, 구성 및 마스터하는 데 필요한 모든 정보를 찾을 수 있습니다.

소개

Intlayer란 무엇인가요?

Intlayer는 자바스크립트 개발자를 위해 특별히 설계된 국제화 라이브러리입니다. 코드 어디에서나 콘텐츠를 선언할 수 있도록 허용합니다. 다국어 콘텐츠 선언을 구조화된 사전(dictionary)으로 변환하여 코드에 쉽게 통합할 수 있게 합니다. TypeScript를 사용하여, Intlayer는 개발을 더욱 견고하고 효율적으로 만듭니다.

Intlayer는 또한 콘텐츠를 쉽게 편집하고 관리할 수 있는 선택적 시각적 편집기를 제공합니다. 이 편집기는 콘텐츠 관리를 위한 시각적 인터페이스를 선호하는 개발자나, 코드를 신경 쓰지 않고 콘텐츠를 생성하는 팀에게 특히 유용합니다.

사용 예시

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

import { t, type Dictionary } from "intlayer";const componentContent = {  key: "component-key",  content: {    myTranslatedContent: t({      en: "Hello World",      es: "Hola Mundo",      fr: "Bonjour le monde",    }),  },} satisfies Dictionary;export default componentContent;

import type { FC } from "react";import { useIntlayer } from "react-intlayer";export const MyComponent: FC = () => {  const { myTranslatedContent } = useIntlayer("component-key");  return <span>{myTranslatedContent}</span>;};

주요 기능

Intlayer는 현대 웹 개발의 요구에 맞춘 다양한 기능을 제공합니다. 아래는 주요 기능과 각 기능에 대한 자세한 문서 링크입니다:

• 국제화 지원: 내장된 국제화 지원으로 애플리케이션의 글로벌 도달 범위를 확장하세요.
• 비주얼 에디터: Intlayer를 위해 설계된 에디터 플러그인으로 개발 워크플로우를 향상시키세요. 비주얼 에디터 가이드를 확인하세요.
• 구성 유연성: 구성 가이드에 자세히 설명된 광범위한 구성 옵션으로 설정을 맞춤화하세요.
• 고급 CLI 도구: Intlayer의 명령줄 인터페이스를 사용하여 프로젝트를 효율적으로 관리하세요. CLI 도구 문서에서 기능을 탐색할 수 있습니다.

핵심 개념

사전(Dictionary)

다국어 콘텐츠를 코드 가까이에 정리하여 모든 것을 일관되고 유지 관리하기 쉽게 만드세요.

• 시작하기
  Intlayer에서 콘텐츠를 선언하는 기본 사항을 배우세요.

• 번역
  번역이 어떻게 생성되고 저장되며 애플리케이션에서 활용되는지 이해하세요.

• 열거
  여러 언어에 걸쳐 반복되거나 고정된 데이터 집합을 쉽게 관리하세요.

• 조건
  Intlayer에서 조건 논리를 사용하여 동적 콘텐츠를 만드는 방법을 배우세요.

• 삽입
  삽입 자리 표시자를 사용하여 문자열에 값을 삽입하는 방법을 알아보세요.

• 함수 페칭
  프로젝트 워크플로우에 맞게 맞춤 로직으로 동적으로 콘텐츠를 가져오는 방법을 확인하세요.

• 마크다운
  Intlayer에서 마크다운을 사용하여 풍부한 콘텐츠를 만드는 방법을 배우세요.

• 파일 임베딩
  Intlayer에서 외부 파일을 임베딩하여 콘텐츠 편집기에서 사용하는 방법을 알아보세요.

• 중첩
  Intlayer에서 콘텐츠를 중첩하여 복잡한 구조를 만드는 방법을 이해하세요.

환경 및 통합

Intlayer는 유연성을 염두에 두고 설계되어, 인기 있는 프레임워크와 빌드 도구와의 원활한 통합을 제공합니다:

• Next.js 15와 함께 사용하는 Intlayer
• Next.js 14 (앱 라우터)와 함께 사용하는 Intlayer
• Next.js 페이지 라우터와 함께 사용하는 Intlayer
• React CRA와 함께 사용하는 Intlayer
• Vite + React와 함께 사용하는 Intlayer
• React Native와 Expo와 함께 사용하는 Intlayer
• Lynx와 React와 함께 사용하는 Intlayer
• Express와 함께 사용하는 Intlayer

각 통합 가이드에는 서버 사이드 렌더링, 동적 라우팅, 또는 클라이언트 사이드 렌더링과 같은 Intlayer 기능을 사용하는 모범 사례가 포함되어 있어, 빠르고 SEO 친화적이며 매우 확장 가능한 애플리케이션을 유지할 수 있습니다.

기여 및 피드백

우리는 오픈 소스와 커뮤니티 주도 개발의 힘을 소중히 여깁니다. 개선 사항을 제안하거나, 새로운 가이드를 추가하거나, 문서의 문제를 수정하고 싶다면 언제든지 Pull Request를 제출하거나 GitHub 저장소에서 이슈를 열어 주세요.

더 빠르고 효율적으로 애플리케이션을 번역할 준비가 되셨나요? 지금 바로 문서를 탐색하여 Intlayer를 사용해 보세요. 콘텐츠를 체계적으로 관리하고 팀의 생산성을 높이는 강력하고 간소화된 국제화 방식을 경험할 수 있습니다.

문서 이력

• 5.5.10 - 2025-06-29: 초기 이력