Communitygithub.com

ASoudy/AGS

Modèles d'internationalisation et de localisation. Détection des chaînes codées en dur, gestion des traductions, fichiers de locale, support RTL.

Qu'est-ce que AGS ?

Cette compétence fournit une expertise complète en internationalisation (i18n) et localisation (L10n) pour les projets de développement logiciel. Elle guide les développeurs dans la détection des chaînes de caractères codées en dur, la gestion des fichiers de traduction, l'implémentation du support RTL (langues de droite à gauche) et l'utilisation des bonnes pratiques comme les clés de traduction, la pluralisation et le formatage des dates/nombres par locale. La compétence prend en charge les frameworks populaires tels que React (react-i18next), Next.js (next-intl) et Python (gettext), avec des exemples de code directement exploitables. Elle inclut également un script utilitaire `scripts/i18n_checker.py` pour détecter automatiquement les chaînes codées en dur et les traductions manquantes dans un projet. Utile autant pour les applications publiques que pour les produits SaaS, elle aide à structurer les fichiers de locale par fonctionnalité et à anticiper les contraintes RTL dès la conception.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/i18n-localization

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

i18n et Localisation

Bonnes pratiques pour l'internationalisation (i18n) et la localisation (L10n).


1. Concepts Fondamentaux

TermeSignification
i18nInternationalisation – rendre l'application traduisible
L10nLocalisation – traductions effectives
LocaleLangue + Région (en-US, tr-TR)
RTLLangues de droite à gauche (arabe, hébreu)

2. Quand Utiliser i18n

Type de Projeti18n Nécessaire ?
Application web publique✅ Oui
Produit SaaS✅ Oui
Outil interne⚠️ Peut-être
Application mono-région⚠️ À considérer pour l'avenir
Projet personnel❌ Optionnel

3. Patrons d'Implémentation

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(_("Bienvenue dans notre application"))

4. Structure des Fichiers

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

5. Bonnes Pratiques

À FAIRE ✅

  • Utiliser des clés de traduction, pas du texte brut
  • Espaces de noms pour les traductions par fonctionnalité
  • Gérer la pluralisation
  • Adapter le format des dates/nombres par locale
  • Planifier le support RTL dès le départ
  • Utiliser le format de message ICU pour les chaînes complexes

À ÉVITER ❌

  • Coder en dur des chaînes dans les composants
  • Concaténer des chaînes traduites
  • Supposer la longueur du texte (l'allemand est 30% plus long)
  • Oublier la mise en page RTL
  • Mélanger les langues dans le même fichier

6. Problèmes Courants

ProblèmeSolution
Traduction manquanteRepli vers la langue par défaut
Chaînes codées en durUtiliser un linter / script de vérification
Format de dateUtiliser Intl.DateTimeFormat
Format de nombreUtiliser Intl.NumberFormat
PluralisationUtiliser le format de message ICU

7. Support RTL

/* Propriétés CSS logiques */
.container {
  margin-inline-start: 1rem;  /* Pas margin-left */
  padding-inline-end: 1rem;   /* Pas padding-right */
}

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

8. Liste de Vérification

Avant de livrer :

  • Toutes les chaînes visibles par l'utilisateur utilisent des clés de traduction
  • Des fichiers de locale existent pour toutes les langues supportées
  • Le formatage des dates/nombres utilise l'API Intl
  • La mise en page RTL a été testée (si applicable)
  • La langue de repli est configurée
  • Aucune chaîne codée en dur dans les composants

Script

ScriptObjectifCommande
scripts/i18n_checker.pyDétecter les chaînes codées en dur et les traductions manquantespython scripts/i18n_checker.py <chemin_du_projet>

Quand Utiliser

Cette compétence est applicable pour exécuter le flux de travail ou les actions décrits dans la présentation générale.

Limitations

  • Utiliser cette compétence uniquement lorsque la tâche correspond clairement au champ d'application décrit ci-dessus.
  • Ne pas considérer la sortie comme un substitut à une validation, un test ou une revue d'expert spécifique à l'environnement.
  • Arrêtez-vous et demandez des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont manquants.

Individual skills in this repo

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

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

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.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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

Skills associés