Communitygithub.com

AbobakrDiara61/railway-system

Internationalisierungs- und Lokalisierungsmuster. Erkennung von hartcodierten Zeichenfolgen, Verwaltung von Übersetzungen, Locale-Dateien, RTL-Unterstützung.

Was ist railway-system?

Diese Fertigkeit bietet eine umfassende Einführung in Internationalisierung (i18n) und Lokalisierung (L10n) für Softwareprojekte. Sie definiert Kernkonzepte wie Locale und RTL und zeigt anhand von Codebeispielen für React, Next.js und Python, wie Übersetzungsframeworks wie react-i18next, next-intl und gettext integriert werden. Die Fertigkeit empfiehlt eine bestimmte Dateistruktur für Übersetzungsdateien, betont Best Practices wie die Verwendung von Übersetzungsschlüsseln und Namespaces und warnt vor häufigen Fehlern wie hartcodierten Zeichenfolgen und Annahmen über die Textlänge. Sie enthält außerdem eine Checkliste für die Auslieferung, eine Diskussion von RTL-Layouts mit CSS Logical Properties und ein Skript zur Erkennung fehlender oder hartcodierter Zeichenfolgen. Unterstützte Plattformen sind React, Next.js und Python, wobei der Schwerpunkt auf reiner Frontend- und Backend-Internationalisierung liegt. Die Anwendung eignet sich für öffentliche Web-Apps, SaaS-Produkte und Mehrsprachenprojekte. Einschränkungen sind, dass die Fertigkeit nur bei klar passenden Aufgaben angewendet werden sollte und keine umgebungsspezifische Validierung oder Tests ersetzt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/skills/i18n-localization

In Ihrer bevorzugten KI fragen

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

Dokumentation

i18n & Lokalisierung

Internationalisierung (i18n) und Lokalisierung (L10n) – Best Practices.


1. Kernkonzepte

BegriffBedeutung
i18nInternationalisierung – App übersetzbar machen
L10nLokalisierung – tatsächliche Übersetzungen
LocaleSprache + Region (en-US, tr-TR)
RTLRechts-nach-links-Sprachen (Arabisch, Hebräisch)

2. Wann i18n verwendet werden sollte

Projekttypi18n nötig?
Öffentliche Web-App✅ Ja
SaaS-Produkt✅ Ja
Internes Tool⚠️ Vielleicht
Einregionale 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(_("Welcome to our 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 Feature benennen
  • Pluralisierung unterstützen
  • Datums-/Zahlenformate pro Locale behandeln
  • Von Anfang an für RTL planen
  • 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/Checker-Skript 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
  • Locale-Dateien existieren für alle unterstützten Sprachen
  • 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 & fehlende Übersetzungen erkennenpython scripts/i18n_checker.py <Projektpfad>

Wann es verwendet werden sollte

Diese Fertigkeit ist anwendbar, um den im Überblick beschriebenen Workflow oder die Aktionen auszuführen.

Einschränkungen

  • Verwenden Sie diese Fertigkeit nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
  • Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachliche Überprüfung.
  • Bitten Sie um Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.

Individual skills in this repo

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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 悬停效果

AbobakrDiara61/railway-system

Best practices for Remotion - Video creation in React

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

Verwandte Skills