Communitygithub.com

AbobakrDiara61/railway-system

Patrones de internacionalización y localización. Detección de cadenas fijas, gestión de traducciones, archivos de configuración regional y soporte para RTL.

¿Qué es railway-system?

Esta habilidad proporciona una guía completa sobre internacionalización (i18n) y localización (L10n) para aplicaciones de software. Es útil para desarrolladores que necesitan preparar su aplicación para soportar múltiples idiomas y regiones, incluyendo soporte para escritura de derecha a izquierda (RTL) como árabe o hebreo. La habilidad cubre desde conceptos básicos hasta patrones de implementación concretos en frameworks modernos como React (react-i18next), Next.js (next-intl) y Python (gettext), además de ofrecer una estructura de archivos recomendada, mejores prácticas, problemas comunes y una lista de verificación para asegurar una correcta implementación. También incluye un script automatizado para detectar cadenas fijas y traducciones faltantes, lo que facilita la integración en flujos de trabajo de desarrollo. Está diseñada para ser utilizada en proyectos que requieran soporte multilingüe, ya sean aplicaciones web públicas, productos SaaS o herramientas internas con potencial de expansión global.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

i18n y Localización

Mejores prácticas de Internacionalización (i18n) y Localización (L10n).


1. Conceptos Básicos

TérminoSignificado
i18nInternacionalización - hacer que la aplicación sea traducible
L10nLocalización - traducciones reales
LocaleIdioma + Región (en-US, tr-TR)
RTLIdiomas de derecha a izquierda (árabe, hebreo)

2. Cuándo Usar i18n

Tipo de Proyecto¿i18n Necesario?
Aplicación web pública✅ Sí
Producto SaaS✅ Sí
Herramienta interna⚠️ Quizás
Aplicación de una sola región⚠️ Considerar futuro
Proyecto personal❌ Opcional

3. Patrones de Implementación

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Bienvenida() {
  const { t } = useTranslation();
  return <h1>{t('bienvenida.titulo')}</h1>;
}

Next.js (next-intl)

import { useTranslations } from 'next-intl';

export default function Pagina() {
  const t = useTranslations('Inicio');
  return <h1>{t('titulo')}</h1>;
}

Python (gettext)

from gettext import gettext as _

print(_("Bienvenido a nuestra aplicación"))

4. Estructura de Archivos

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

5. Mejores Prácticas

HACER ✅

  • Usar claves de traducción, no texto sin formato
  • Agrupar las traducciones por funcionalidad
  • Soporte para pluralización
  • Manejar formatos de fecha/número por locale
  • Planificar para RTL desde el inicio
  • Usar formato de mensaje ICU para cadenas complejas

NO HACER ❌

  • Escribir cadenas fijas en componentes
  • Concatenar cadenas traducidas
  • Asumir la longitud del texto (el alemán es un 30% más largo)
  • Olvidar el diseño RTL
  • Mezclar idiomas en el mismo archivo

6. Problemas Comunes

ProblemaSolución
Traducción faltanteRecurrir al idioma predeterminado
Cadenas fijasUsar un script de linting/verificación
Formato de fechaUsar Intl.DateTimeFormat
Formato de númeroUsar Intl.NumberFormat
PluralizaciónUsar formato de mensaje ICU

7. Soporte RTL

/* Propiedades Lógicas CSS */
.contenedor {
  margin-inline-start: 1rem;  /* No margin-left */
  padding-inline-end: 1rem;   /* No padding-right */
}

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

8. Lista de Verificación

Antes de publicar:

  • Todas las cadenas visibles para el usuario usan claves de traducción
  • Existen archivos de locale para todos los idiomas compatibles
  • El formato de fecha/número usa la API Intl
  • Diseño RTL probado (si aplica)
  • Idioma de respaldo configurado
  • Sin cadenas fijas en componentes

Script

ScriptPropósitoComando
scripts/i18n_checker.pyDetectar cadenas fijas y traducciones faltantespython scripts/i18n_checker.py <ruta_del_proyecto>

Cuándo Usar

Esta habilidad es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la descripción general.

Limitaciones

  • Use esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trate la salida como un sustituto de la validación específica del entorno, las pruebas o la revisión por expertos.
  • Deténgase y solicite aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

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

Skills relacionados