Skip to content
i18n-translator logo

i18n Translator Skill

i18n-translator

Manage i18n translations for Note Sage plugin. Use when: (1) Adding new translation keys, (2) Updating existing translations, (3) Maintaining consistency across 11 languages (en, ko, ja, es, fr, de, pt, zh, ar, ru, hi), (4) Finding missing translations

SKILL.md

Full skill instructions

i18n Translator Skill

Note Sage Obsidian 플러그인의 다국어(i18n) 번역 관리 전담 스킬입니다.

지원 언어 (11개)

코드언어방향파일
enEnglishLTR기준 언어, 타입 정의 포함
ko한국어LTR
ja日本語LTR
esEspañolLTR
frFrançaisLTR
deDeutschLTR
ptPortuguêsLTR
zh简体中文LTR
arالعربيةRTL오른쪽에서 왼쪽
ruРусскийLTR
hiहिन्दीLTR

파일 구조

src/​i18n/
├── index.ts                 # i18n 핵심 모듈 (t() 함수, setLanguage() 등)
└── locales/
    ├── en.ts               # 영어 (기준) - TranslationKeys 인터페이스 정의
    ├── ko.ts               # 한국어
    ├── ja.ts               # 일본어
    ├── es.ts               # 스페인어
    ├── fr.ts               # 프랑스어
    ├── de.ts               # 독일어
    ├── pt.ts               # 포르투갈어
    ├── zh.ts               # 중국어 (간체)
    ├── ar.ts               # 아랍어
    ├── ru.ts               # 러시아어
    └── hi.ts               # 힌디어

번역 키 구조

영어 파일(en.ts)에 정의된 TranslationKeys 인터페이스를 기준으로 합니다:

export interface TranslationKeys {
  appTitle: string;
  quickAction: QuickActionTranslations;    // 빠른 액션 버튼
  commands: CommandsTranslations;           // 명령어 팔레트
  prompts: PromptsTranslations;             // 빠른 프롬프트
  settings: SettingsTranslations;           // 설정 탭
  // ... 기타 키
}

주요 섹션:

  • quickAction - 채팅 입력창 위 빠른 액션 버튼
  • commands - Obsidian 명령어 팔레트
  • prompts - AI 프롬프트 템플릿
  • settings - 플러그인 설정
    • settings.builtinTools - 내장 도구
    • settings.agentOptions - Agent SDK 옵션
    • settings.mcp - MCP 서버 설정

워크플로우

1. 새 번역 키 추가

단계 1: 영어 파일에 인터페이스 및 값 추가

// src/​i18n/​locales/​en.ts

// 1. 인터페이스에 새 키 추가 (중첩된 경우)
interface NewFeatureTranslations {
  title: string;
  description: string;
}

// 2. TranslationKeys 또는 SettingsTranslations에 추가
interface SettingsTranslations {
  // ... 기존 키
  newFeature: NewFeatureTranslations;  // 새로 추가
}

// 3. 영어 값 추가
export const en: TranslationKeys = {
  settings: {
    // ... 기존 값
    newFeature: {
      title: 'New Feature',
      description: 'Description of the new feature',
    },
  },
};

단계 2: 다른 언어 파일에 동일한 구조로 번역 추가

// src/​i18n/​locales/​ko.ts
export const ko: TranslationKeys = {
  settings: {
    // ... 기존 값
    newFeature: {
      title: '새 기능',
      description: '새 기능에 대한 설명',
    },
  },
};

중요: 모든 11개 언어 파일에 동일한 구조로 추가해야 합니다!

2. 기존 번역 수정

  1. 먼저 영어 파일에서 해당 키 확인
  2. 필요한 언어 파일을 열어 값 수정
  3. 다른 언어와 일관성 유지 확인

3. 누락된 번역 탐지

# 검증 스크립트 실행
python .claude/​skills/​i18n-translator/​scripts/​validate_translations.py

코드에서 번역 사용

import { t, setLanguage, getLanguage } from './​i18n';

// 번역 텍스트 가져오기
const title = t('appTitle');                    // 단순 키
const apiKey = t('settings.apiKey');            // 중첩 키
const webSearch = t('settings.builtinTools.webSearch');  // 깊은 중첩

// 언어 변경
setLanguage('ko');

// 현재 언어 확인
const currentLang = getLanguage();  // 'ko'

체크리스트

새 번역 작업 시:

  • 영어(en.ts)에 키와 인터페이스 추가 (기준)
  • 한국어(ko.ts)에 번역 추가
  • 일본어(ja.ts)에 번역 추가
  • 스페인어(es.ts)에 번역 추가
  • 프랑스어(fr.ts)에 번역 추가
  • 독일어(de.ts)에 번역 추가
  • 포르투갈어(pt.ts)에 번역 추가
  • 중국어(zh.ts)에 번역 추가
  • 아랍어(ar.ts)에 번역 추가
  • 러시아어(ru.ts)에 번역 추가
  • 힌디어(hi.ts)에 번역 추가
  • 검증 스크립트로 누락 확인

주의사항

  1. 영어가 기준: 항상 영어 파일을 먼저 수정하고 다른 언어에 적용
  2. 타입 안전성: 인터페이스 수정 시 TypeScript 컴파일 오류 확인
  3. RTL 지원: 아랍어는 오른쪽에서 왼쪽 텍스트 방향
  4. 중첩 구조: 점(.) 표기법으로 깊은 키 접근 가능
  5. Fallback: 키를 찾지 못하면 키 경로 자체가 반환됨

참조 문서

More skills from majiayu000

xiaohongshu logo
majiayu000/claude-arsenal

xiaohongshu

xiaohongshu

286 148
View
agent-task-conductor logo
majiayu000/claude-skill-registry

agent-task-conductor

Conduct multi-agent task orchestration and workflow coordination.

663 1
View
conductor-setup logo
majiayu000/claude-skill-registry

conductor-setup

Initialize project with Conductor artifacts (product definition,

663 1
View
animation-designer logo
majiayu000/claude-skill-registry

animation-designer

Expert in web animations, transitions, and motion design using Framer Motion and CSS

663 1
View
diagramming logo
majiayu000/claude-skill-registry

diagramming

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...

663 1
View
h3-pg logo
majiayu000/claude-skill-registry-data

h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

23 1
View
conductor-development logo
majiayu000/claude-skill-registry

conductor-development

Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...

663 1
View
conductor-status logo
majiayu000/claude-skill-registry

conductor-status

Display project status, active tracks, and next actions

663 1
View
dockerization logo
majiayu000/claude-skill-registry

dockerization

Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.

663 1
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View