Communitygithub.com

BEKO2210/Firstbrain

Internationalisierungs- und Lokalisierungsmuster. Erkennung hartcodierter Zeichenfolgen, Verwaltung von Übersetzungen, Gebietsschemadateien und RTL-Unterstützung.

Was ist Firstbrain?

Dieses Skill bietet umfassende Richtlinien und Implementierungsmuster für Internationalisierung (i18n) und Lokalisierung (L10n) in Softwareprojekten. Es richtet sich an Entwickler, die mehrsprachige Anwendungen erstellen oder bestehende Anwendungen für den globalen Markt vorbereiten möchten. Das Skill unterstützt gängige Frameworks wie React (react-i18next), Next.js (next-intl) und Python (gettext) und behandelt Kernkonzepte wie Locales, RTL-Unterstützung (Right-to-Left) und Pluralisierungsregeln. Es enthält bewährte Vorgehensweisen, eine Checkliste, eine empfohlene Dateistruktur für Übersetzungsdateien sowie ein Skript (`scripts/i18n_checker.py`) zur Erkennung hartcodierter Zeichenfolgen und fehlender Übersetzungen. Der Nutzen liegt in der Vermeidung typischer Fehler wie hartcodierter Texte, fehlerhafter Datums- oder Zahlenformatierung und unzureichender RTL-Unterstützung, was die Wartbarkeit und Benutzerfreundlichkeit globaler Anwendungen erhöht.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/i18n-localization

In Ihrer bevorzugten KI fragen

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

Dokumentation

i18n & Lokalisierung

Best Practices für Internationalisierung (i18n) und Lokalisierung (L10n).


1. Kernkonzepte

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

2. Wann i18n verwendet werden sollte

Projekttypi18n erforderlich?
Öffentliche Web-App✅ Ja
SaaS-Produkt✅ Ja
Internes Tool⚠️ Eventuell
Einregionen-App⚠️ 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/
├── en/
│   ├── 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 Funktion benennen
  • Pluralisierung unterstützen
  • Datums-/Zahlenformate pro Locale behandeln
  • RTL von Anfang an einplanen
  • ICU-Nachrichtenformat für komplexe Zeichenfolgen verwenden

NICHT TUN ❌

  • Zeichenfolgen in Komponenten hartcodieren
  • Übersetzte Zeichenfolgen verketten
  • Textlänge annehmen (Deutsch ist 30 % länger)
  • RTL-Layout vergessen
  • Sprachen in derselben Datei mischen

6. Häufige Probleme

ProblemLösung
Fehlende ÜbersetzungFallback auf Standardsprache
Hartcodierte ZeichenfolgenLinter/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 benutzersichtbaren Zeichenfolgen verwenden Übersetzungsschlüssel
  • Gebietsschemadateien für alle unterstützten Sprachen vorhanden
  • Datums-/Zahlenformatierung verwendet Intl-API
  • RTL-Layout getestet (falls zutreffend)
  • Fallback-Sprache konfiguriert
  • Keine hartcodierten Zeichenfolgen in Komponenten

Skript

SkriptZweckBefehl
scripts/i18n_checker.pyHartcodierte Zeichenfolgen und fehlende Übersetzungen erkennenpython scripts/i18n_checker.py <project_path>

Verwendung

Dieses Skill kann angewendet werden, um den im Überblick beschriebenen Workflow oder die Aktionen auszuführen.

Verknüpfungen

  • Domain: [[Software Entwicklung]]
  • Kategorie: [[Software Architektur]]
  • Dateien:
    • scripts/i18n_checker.py
  • Navigation: [[Skills Uebersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

Verwandte Skills