Communitygithub.com

AlperTuncOrtak/pipeline-donnees-crypto

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

Qu'est-ce que pipeline-donnees-crypto ?

Cette compétence fournit un guide complet pour implémenter l'internationalisation (i18n) et la localisation (L10n) dans vos applications. Elle couvre les concepts essentiels comme les locales (langue + région), le support des langues de droite à gauche (RTL comme l'arabe ou l'hébreu), et les bonnes pratiques pour éviter les chaînes codées en dur. La compétence propose des exemples de code concrets pour les frameworks populaires (React avec react-i18next, Next.js avec next-intl, Python avec gettext) ainsi qu'une structure de fichiers recommandée pour organiser les traductions par fonctionnalité. Elle inclut également une checklist de vérification avant déploiement et un script utilitaire pour détecter automatiquement les chaînes non traduites et les traductions manquantes dans votre projet.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlperTuncOrtak/crypto-data-pipeline/tree/HEAD/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 clés

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⚠️ Penser au futur
Projet personnel❌ Optionnel

3. Patterns 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(_("Welcome to our app"))

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
  • Organiser les traductions par fonctionnalité (namespaces)
  • Supporter la pluralisation
  • Gérer les formats de date/nombre par locale
  • Prévoir le RTL dès le départ
  • Utiliser le format de message ICU pour les chaînes complexes

À NE PAS FAIRE ❌

  • Ne pas coder en dur les chaînes dans les composants
  • Ne pas concaténer les chaînes traduites
  • Ne pas supposer la longueur du texte (l'allemand est 30% plus long)
  • Ne pas oublier la mise en page RTL
  • Ne pas 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 logiques CSS */
.container {
  margin-inline-start: 1rem;  /* Pas margin-left */
  padding-inline-end: 1rem;   /* Pas padding-right */
}

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

8. Checklist

Avant de livrer :

  • Toutes les chaînes visibles par l'utilisateur utilisent des clés de traduction
  • Les 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 workflow ou les actions décrites dans la présentation.

Limitations

  • Utilisez cette compétence uniquement lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
  • Ne considérez pas le résultat comme un substitut à une validation spécifique à l'environnement, à des tests ou à une revue experte.
  • Arrêtez-vous et demandez des clarifications si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.

Individual skills in this repo

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

Best practices for Remotion - Video creation in React

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

Skills associés