Files

T

Antigravity Agent f8b21af4be Wiki cleanup: error-doc removal, dedup merge, link normalization

10_Wiki/Topics 대규모 정리:
- 오류 캡처/미완성 stub 문서 227개 제거
- 교차폴더 중복 43클러스터 병합 (63파일 → redirect)
- 링크명 정규화: 깨진 링크 수정·redirect 직결·개념 매핑 ~2,400건
- 카테고리 MOC 6개 신규 생성
- Graph 섹션 미해결 related-keyword 링크 10,058건 제거

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-20 23:52:15 +09:00

4.2 KiB

Raw Blame History

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

title

i18n

"1 item / 5 items" 가 모든 언어에 통하지 않음 (러시아어 1/2-4/5+, 아랍어 0/1/2/few/many/other). ICU MessageFormat 표준. react-i18next / react-intl (FormatJS) / lingui.

📖 핵심 개념

ICU MessageFormat: {count, plural, one {# item} other {# items}}.
Locale = 언어+지역 (en-US, pt-BR).
RTL: 아랍어/히브리어 — 화면 좌우 반전.
Lazy loading: 큰 번역 파일은 lang 별로 로딩.

💻 코드 패턴

react-i18next

// i18n.ts
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
import HttpBackend from 'i18next-http-backend';

i18n.use(HttpBackend).use(initReactI18next).init({
  fallbackLng: 'en',
  supportedLngs: ['en', 'ko', 'ja', 'ar'],
  interpolation: { escapeValue: false }, // React 자체 escape
  backend: { loadPath: '/locales/{{lng}}/{{ns}}.json' },
});

// public/locales/en/common.json
{
  "greeting": "Hello, {{name}}",
  "items": "{count, plural, one {# item} other {# items}}",
  "lastSeen": "Last seen {date, date, medium}"
}

import { useTranslation } from 'react-i18next';

function Hello({ name, count }: { name: string; count: number }) {
  const { t } = useTranslation();
  return <p>{t('greeting', { name })}: {t('items', { count })}</p>;
}

FormatJS / react-intl

import { FormattedMessage, useIntl } from 'react-intl';

<FormattedMessage
  id="cart.items"
  defaultMessage="{count, plural, one {# item} other {# items}}"
  values={{ count: 3 }}
/>

Lingui (compile-time, 작은 bundle)

import { Trans, t } from '@lingui/macro';

<Trans>Hello {name}</Trans>;
const msg = t`You have ${n} items`;
// macro 가 build 시 catalog 추출

날짜 / 숫자

new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }).format(1234.5);
// $1,234.50

new Intl.DateTimeFormat('ko-KR', { dateStyle: 'medium' }).format(new Date());
// 2026. 5. 9.

new Intl.RelativeTimeFormat('en').format(-3, 'day'); // 3 days ago
new Intl.ListFormat('en').format(['A', 'B', 'C']);  // A, B, and C

RTL

import { useTranslation } from 'react-i18next';

const { i18n } = useTranslation();
const dir = i18n.dir(); // 'rtl' | 'ltr'

return <html dir={dir}>...</html>;

/* logical properties (RTL 자동) */
.box { padding-inline-start: 1rem; }  /* LTR=left, RTL=right */
.icon { margin-inline-end: 0.5rem; }

복수형 cases

{count, plural,
  =0 {No items}
  one {One item}
  few {# items}     // 슬라브 언어 등
  many {# items}    // 러시아어 등
  other {# items}}

Type-safe key

import type { TFunction } from 'i18next';

type Keys = 'greeting' | 'items' | 'lastSeen';
type SafeT = (k: Keys, opts?: Record<string, unknown>) => string;

또는 i18next-typescript / typesafe-i18n 사용.

🤔 의사결정 기준

상황	추천
Next.js 프로젝트	next-intl 또는 next-i18next
가벼운 / 작은 앱	i18next
강력 type 안전 + 작은 bundle	Lingui
Apple 표준	Apple FormatJS / NSLocalizedString
Plural / gender / select 복잡	ICU MessageFormat 필수
Translation memory	Crowdin / Lokalise / Phrase

❌ 안티패턴

문장 concat: "Hello " + name + "!" — 문장 순서가 언어마다 다름.
숫자 + 단위 직접 결합: ICU plural.
Hard-coded date format: Intl.DateTimeFormat.
px margin 으로 RTL 깨짐: logical properties.
번역 미완료 = {key} 노출: fallback + 자동화 (Lokalise PR).
런타임 detection 만: SSR 시 UA / Accept-Language.
모든 언어 한 번에 로드: lazy load lang별.

🤖 LLM 활용 힌트

ICU MessageFormat 강력 권장.
Intl API 표준 (NumberFormat, DateTimeFormat, RelativeTimeFormat).
RTL = dir + logical properties.

🔗 관련 문서

Frontend_A11y_Testing

4.2 KiB Raw Blame History