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

mattnigh/skills_collection0installs24stars

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 mattnigh

spring-framework-patterns logo
mattnigh/skills_collection

spring-framework-patterns

Comprehensive Spring Framework and Spring Boot best practices including dependency injection patterns, bean lifecycle and scopes, REST API development, Spring Data JPA, service layer design, Spring Security, testing strategies, caching, AOP, async processing, error handling, and common anti-patte...

24 0
View

TypeScript厳格モードによる型安全性設計を専門とするスキル。 📖 参照書籍: - 『Effective TypeScript』(Dan Vanderkam): 型設計 📚 リソース参照: - `resources/Level1_basics.md`: レベル1の基礎ガイド - `resources/Level2_intermediate.md`: レベル2の実務ガイド - `resources/Level3_advanced.md`: レベル3の応用ガイド - `resources/Level4_expert.md`: レベル4の専門ガイド - `resources/di...

24 0
View
deploying-cloud-k8s logo
mattnigh/skills_collection

deploying-cloud-k8s

Deploys applications to cloud Kubernetes (AKS/GKE/DOKS) with CI/CD pipelines. Use when deploying to production, setting up GitHub Actions, troubleshooting deployments. Covers build-time vs runtime vars, architecture matching, and battle-tested debugging.

24 0
View
moai-alfred-agent-guide logo
mattnigh/skills_collection

moai-alfred-agent-guide

19-agent team structure, decision trees for agent selection, Haiku vs Sonnet model selection, and agent collaboration principles. Use when deciding which sub-agent to invoke, understanding team responsibilities, or learning multi-agent orchestration.

24 0
View
mermaid-diagram-generator logo
mattnigh/skills_collection

mermaid-diagram-generator

Converts architecture descriptions, module specs, or workflow docs into Mermaid diagrams. Use when visualizing brick module relationships, workflows (DDD, investigation), or system architecture. Supports: flowcharts, sequence diagrams, class diagrams, state machines, entity relationship diagrams,...

24 0
View
pre-flight-check logo
mattnigh/skills_collection

pre-flight-check

INVOKE FIRST before any code work. Validates git workflow (branch, issue, worklog) and checks approach. Use at START of every task and END before completing. Prevents skipped steps.

24 0
View
browser-dev-tools logo
mattnigh/skills_collection

browser-dev-tools

This skill should be used when working with browser-rendered artifacts (i.e. Bun, React/React Native) to proactively validate that development work on localhost is being built appropriately and to support debugging browser-rendered content. Use this skill after making frontend changes to verify t...

24 0
View
lead-dev logo
mattnigh/skills_collection

lead-dev

Lead Développeur - Coordination technique opérationnelle, code review, mentoring et livraison. Pair de web-dev-process au niveau OPÉRATIONS.

24 0
View
worker-monitor logo
mattnigh/skills_collection

worker-monitor

Monitor Docker workers, RQ queue health, and auto-scale workers (max 4). Use when: checking job progress, monitoring queue depth, scaling workers up/down, diagnosing slow processing, or waiting for jobs to complete. Referenced by data-quality skill during reprocessing.

24 0
View
quality-advisor logo
mattnigh/skills_collection

quality-advisor

Proactive quality guidance system that monitors artifact creation and provides real-time feedback on documentation quality

24 0
View
bump-version logo
mattnigh/skills_collection

bump-version

This skill should be used when the user wants to bump the version number in the workspace. It updates versions across all pyproject.toml files (root, tde, and tda packages) and the CHANGELOG.md to keep them synchronized.

24 0
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