#I18n 국제화

NocoBase 플러그인에서는 프런트엔드와 백엔드 모두 다국어 국제화(i18n)를 지원합니다. 통일된 메커니즘을 통해 플러그인에서 다국어 콘텐츠를 쉽게 구현할 수 있습니다.

#다국어 파일 관리

플러그인의 다국어 파일은 src/locale 디렉터리에 일괄적으로 저장됩니다. 언어 파일 이름으로 지정하는 것을 권장합니다. 예를 들어:

|- /plugin-hello
  |- /src
    |- /locale
      |- en-US.json   # 영어
      |- zh-CN.json   # 중국어

각 언어 파일은 해당 언어의 모든 번역 항목을 포함하는 JSON 객체를 내보냅니다. 예를 들어:

// zh-CN.json
{
  "Hello": "你好",
  "World": "世界",
  "Enter your name": "请输入你的名字",
  "Your name is {{name}}": "你的名字是 {{name}}"
}

// en-US.json
{
  "Hello": "Hello",
  "World": "World",
  "Enter your name": "Enter your name",
  "Your name is {{name}}": "Your name is {{name}}"
}

언어 파일을 처음 추가할 때, 애플리케이션을 재시작해야 적용됩니다. API를 통해 번역 항목이 적용되었는지 확인할 수 있습니다: http://localhost:13000/api/app:getLang?locale=zh-CN

#i18n 관련 API

#ctx.i18n

#ctx.t(text, options)

#plugin.t()

#useT()

#tExpr(text)

#useTranslation(ns)

#withTranslation(ns)