Communitygithub.com

i18n & Lokalisierung

Internationalisierungs- und Lokalisierungsmuster. Erkennung von hartcodierten Zeichenketten, Verwaltung von Übersetzungen, Lokalisierungsdateien, RTL-Unterstützung.

Was ist i18n & Lokalisierung?

Dieses Skill beschreibt bewährte Verfahren für die Internationalisierung (i18n) und Lokalisierung (L10n) von Softwareanwendungen. Es hilft Entwicklern, ihre Anwendungen mehrsprachig zu gestalten, hartcodierte Zeichenketten zu vermeiden und Lokalisierungsdateien korrekt zu verwalten. Der Skill unterstützt gängige Frameworks wie React (react-i18next), Next.js (next-intl) und Python (gettext) und bietet klare Implementierungsmuster. Ein besonderer Fokus liegt auf RTL-Unterstützung (z. B. für Arabisch oder Hebräisch) sowie auf der Handhabung von Pluralisierung, Datums- und Zahlenformaten. Die mitgelieferte Prüfskript-Datei `scripts/i18n_checker.py` hilft, hartcodierte Zeichenketten und fehlende Übersetzungen automatisiert zu erkennen. Dieses Skill ist ideal für Projekte wie öffentliche Web-Apps, SaaS-Produkte oder jede mehrsprachige Anwendung, die eine saubere Lokalisierungsstrategie benötigt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/i18n-localization

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht i18n & Lokalisierung?

Internationalisierungs- (i18n) und Lokalisierungs- (L10n) Best Practices.


1. Kernkonzepte

BegriffBedeutung
i18nInternationalisierung – die App übersetzbar machen
L10nLokalisierung – die eigentlichen Übersetzungen
LocaleSprache + Region (de-DE, tr-TR)
RTLRechts-nach-links-Sprachen (Arabisch, Hebräisch)

2. Wann i18n verwenden?

Projekttypi18n nötig?
Öffentliche Web-App✅ Ja
SaaS-Produkt✅ Ja
Internes Tool⚠️ Vielleicht
App für eine Region⚠️ Zukunft bedenken
Persönliches Projekt❌ Optional

3. Implementierungsmuster

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Welcome() {
  const { t } = useTranslation();
  return <h1>{t('welcome.title')}</h1>;
}

Next.js (next-intl)

import { useTranslations } from 'next-intl';

export default function Page() {
  const t = useTranslations('Home');
  return <h1>{t('title')}</h1>;
}

Python (gettext)

from gettext import gettext as _

print(_("Willkommen in unserer App"))

4. Dateistruktur

locales/
├── de/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── tr/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

5. Best Practices

TUN ✅

  • Übersetzungsschlüssel verwenden, keinen Rohtext
  • Übersetzungen nach Funktionen benennen
  • Pluralisierung unterstützen
  • Datums-/Zahlenformate pro Locale handhaben
  • RTL von Anfang an einplanen
  • ICU-Nachrichtenformat für komplexe Zeichenketten verwenden

NICHT TUN ❌

  • Zeichenketten in Komponenten hartcodieren
  • Übersetzungsstrings konkatenieren
  • Textlänge ignorieren (Deutsch ist 30% länger)
  • RTL-Layout vergessen
  • Sprachen in derselben Datei mischen

6. Häufige Probleme

ProblemLösung
Fehlende ÜbersetzungFallback auf Standardsprache
Hartcodierte ZeichenkettenLinter/Prüfskript verwenden
DatumsformatIntl.DateTimeFormat verwenden
ZahlenformatIntl.NumberFormat verwenden
PluralisierungICU-Nachrichtenformat verwenden

7. RTL-Unterstützung

/* CSS Logical Properties */
.container {
  margin-inline-start: 1rem;  /* Nicht margin-left */
  padding-inline-end: 1rem;   /* Nicht padding-right */
}

[dir="rtl"] .icon {
  transform: scaleX(-1);
}

8. Checkliste

Vor dem Ausliefern:

  • Alle benutzerseitigen Zeichenketten verwenden Übersetzungsschlüssel
  • Lokalisierungsdateien für alle unterstützten Sprachen vorhanden
  • Datums-/Zahlenformatierung verwendet Intl-API
  • RTL-Layout getestet (falls zutreffend)
  • Fallback-Sprache konfiguriert
  • Keine hartcodierten Zeichenketten in Komponenten

Skript

SkriptZweckBefehl
scripts/i18n_checker.pyErkennung hartcodierter Zeichenketten & fehlender Übersetzungenpython scripts/i18n_checker.py <Projektpfad>

Wann dieses Skill verwenden?

Dieses Skill ist geeignet, um den im Überblick beschriebenen Workflow oder die beschriebenen Aktionen auszuführen.

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

Desesbraker/agentes-vip

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Desesbraker/agentes-vip

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Desesbraker/agentes-vip

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

Desesbraker/agentes-vip

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Desesbraker/agentes-vip

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

Desesbraker/agentes-vip

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

Verwandte Skills