Communitygithub.com

ComeOnOliver/skillshub

Utilisez pour localiser des applications, utiliser des catalogues de chaînes, générer des symboles type-safe (Xcode 26+), gérer les pluriels, les mises en page RTL, le formatage adapté à la locale, ou migrer depuis des fichiers .strings – modèles d'i18n complets pour Xcode 15-26.

Qu'est-ce que skillshub ?

Cette compétence fournit un guide complet pour la localisation et l'internationalisation des applications Apple, en se concentrant sur l'utilisation des catalogues de chaînes (`.xcstrings`) introduits dans Xcode 15. Elle couvre la configuration des catalogues de chaînes, les API de localisation pour SwiftUI et UIKit, la gestion des formes plurielles, le support des langues s'écrivant de droite à gauche (RTL), le formatage tenant compte de la locale, et les stratégies de migration depuis les formats hérités `.strings` et `.stringsdict`. La compétence est utile pour les développeurs qui souhaitent rendre leurs applications accessibles à un public mondial, comme l'exigent les lauréats de l'Apple Design Award pour l'inclusivité. Elle prend en charge les versions d'Xcode allant de 15 à 26 et les systèmes d'exploitation iOS 15 et ultérieurs, avec des détails sur les fonctionnalités comme la génération automatique de symboles et la génération de commentaires assistée par IA dans Xcode 26+. Les utilisateurs apprendront à configurer leurs projets, à gérer les variations de pluriels complexes, à tester les mises en page RTL, et à formater correctement les dates, les devises et les mesures pour différentes régions. La compétence inclut également des exemples pratiques pour les App Shortcuts et les App Intents, garantissant que les composants système comme les noms d'applications et les descriptions de permissions sont correctement localisés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-localization

Demander à votre IA préférée

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

Documentation

Localisation et Internationalisation

Guide complet pour la localisation d'applications à l'aide des catalogues de chaînes. Les lauréats de l'Apple Design Award pour l'inclusivité prennent toujours en charge plusieurs langues avec un excellent support RTL (Right-to-Left).

Aperçu

Les catalogues de chaînes (.xcstrings) sont le format unifié d'Xcode 15 pour gérer la localisation des applications. Ils remplacent les fichiers .strings et .stringsdict hérités par un format unique basé sur JSON, plus facile à maintenir, à différencier et à intégrer avec les workflows de traduction.

Cette compétence couvre les catalogues de chaînes, les API de localisation SwiftUI/UIKit, la gestion des pluriels, le support RTL, le formatage adapté à la locale, et les stratégies de migration depuis les formats hérités.

Quand utiliser cette compétence

  • Configuration de catalogues de chaînes dans Xcode 15+
  • Localisation d'applications SwiftUI et UIKit
  • Gestion correcte des formes plurielles (essentielle pour de nombreuses langues)
  • Prise en charge des langues RTL (arabe, hébreu)
  • Formatage des dates, nombres et devises par locale
  • Migration depuis les fichiers .strings/.stringsdict hérités
  • Préparation des App Shortcuts et App Intents pour la localisation
  • Débogage des traductions manquantes ou des formes plurielles incorrectes

Configuration système requise

  • Xcode 15+ pour les catalogues de chaînes (.xcstrings)
  • Xcode 26+ pour la génération automatique de symboles, la macro #bundle et la génération de commentaires assistée par IA
  • iOS 15+ pour LocalizedStringResource
  • iOS 16+ pour la localisation des App Shortcuts
  • Les versions antérieures d'iOS utilisent les fichiers .strings hérités

Partie 1 : Catalogues de chaînes (WWDC 2023/10155)

Création d'un catalogue de chaînes

Méthode 1 : Navigateur Xcode

  1. Fichier → Nouveau → Fichier
  2. Choisir « String Catalog »
  3. Nommez-le (par exemple, Localizable.xcstrings)
  4. Ajouter à la cible

Méthode 2 : Extraction automatique

Xcode 15 peut extraire automatiquement les chaînes depuis :

  • Vues SwiftUI (littéraux de chaîne dans Text, Label, Button)
  • Code Swift (String(localized:))
  • Objective-C (NSLocalizedString)
  • C (CFCopyLocalizedString)
  • Fichiers Interface Builder (.storyboard, .xib)
  • Valeurs Info.plist
  • Phrases des App Shortcuts

Paramètres de build requis :

  • « Use Compiler to Extract Swift Strings » → Oui
  • « Localization Prefers String Catalogs » → Oui

Structure du catalogue de chaînes

Chaque entrée comporte :

  • Clé : Identifiant unique (par défaut : la chaîne anglaise)
  • Valeur par défaut : Valeur de repli si la traduction manque
  • Commentaire : Contexte pour les traducteurs
  • Table de chaînes : Conteneur d'organisation (par défaut : « Localizable »)

Exemple de JSON .xcstrings :

{
  "sourceLanguage" : "en",
  "strings" : {
    "Merci d'avoir fait vos achats chez nous !" : {
      "comment" : "Étiquette au-dessus du bouton de paiement",
      "localizations" : {
        "en" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "Merci d'avoir fait vos achats chez nous !"
          }
        },
        "es" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "¡Gracias por comprar con nosotros!"
          }
        }
      }
    }
  },
  "version" : "1.0"
}

États de traduction

Xcode suit l'état de chaque traduction :

  • Nouveau (⚪) - La chaîne n'a pas encore été traduite
  • Nécessite une révision (🟡) - La source a changé, la traduction peut être obsolète
  • Révisé (✅) - Traduction approuvée et à jour
  • Obsolète (🔴) - La chaîne n'est plus trouvée dans le code source

Workflow :

  1. Le développeur ajoute une chaîne → Nouveau
  2. Le traducteur ajoute une traduction → Révisé
  3. Le développeur modifie la source → Nécessite une révision
  4. Le traducteur met à jour → Révisé
  5. Le développeur supprime le code → Obsolète

Partie 2 : Localisation SwiftUI

LocalizedStringKey (Automatique)

Les vues SwiftUI avec des paramètres String prennent automatiquement en charge la localisation :

// ✅ Automatiquement localisable
Text("Bienvenue à la WWDC !")
Label("Merci d'avoir fait vos achats avec nous !", systemImage: "bag")
Button("Paiement") { }

// Xcode extrait ces chaînes vers le catalogue de chaînes

Comment cela fonctionne : SwiftUI utilise LocalizedStringKey en interne, qui recherche les chaînes dans les catalogues de chaînes.

String(localized:) avec commentaires

Pour une localisation explicite dans le code Swift :

// Basique
let title = String(localized: "Bienvenue à la WWDC !")

// Avec commentaire pour les traducteurs
let title = String(localized: "Bienvenue à la WWDC !",
                   comment: "Titre de la bannière de notification")

// Avec table personnalisée
let title = String(localized: "Bienvenue à la WWDC !",
                   table: "WWDCNotifications",
                   comment: "Titre de la bannière de notification")

// Avec valeur par défaut (clé ≠ texte anglais)
let title = String(localized: "WWDC_NOTIFICATION_TITLE",
                   defaultValue: "Bienvenue à la WWDC !",
                   comment: "Titre de la bannière de notification")

Bonne pratique : Incluez toujours un comment pour donner du contexte aux traducteurs.

LocalizedStringResource (Localisation différée)

Pour passer des chaînes localisables à d'autres fonctions :

import Foundation

struct CardView: View {
    let title: LocalizedStringResource
    let subtitle: LocalizedStringResource

    var body: some View {
        ZStack {
            RoundedRectangle(cornerRadius: 10.0)
            VStack {
                Text(title)      // Résolu au moment du rendu
                Text(subtitle)
            }
            .padding()
        }
    }
}

// Utilisation
CardView(
    title: "Achats récents",
    subtitle: "Articles que vous avez commandés la semaine dernière."
)

Différence clé : LocalizedStringResource diffère la recherche jusqu'à son utilisation, permettant aux vues personnalisées d'être entièrement localisables.

AttributedString avec Markdown

// Le formatage Markdown est préservé à travers les localisations
let subtitle = AttributedString(localized: "Texte **gras** et _italique_")

Partie 3 : UIKit & Foundation

Macro NSLocalizedString

// Basique
let title = NSLocalizedString("Achats récents", comment: "Titre du bouton")

// Avec table
let title = NSLocalizedString("Achats récents",
                             tableName: "Shopping",
                             comment: "Titre du bouton")

// Avec bundle
let title = NSLocalizedString("Achats récents",
                             tableName: nil,
                             bundle: .main,
                             value: "",
                             comment: "Titre du bouton")

Bundle.localizedString

let customBundle = Bundle(for: MyFramework.self)
let text = customBundle.localizedString(forKey: "Bienvenue",
                                        value: nil,
                                        table: "MyFramework")

Macros personnalisées

// Objective-C
#define MyLocalizedString(key, comment) \
    [myBundle localizedStringForKey:key value:nil table:nil]

Localisation d'Info.plist

Localisez le nom de l'application, les autorisations, etc. :

  1. Sélectionnez Info.plist
  2. Éditeur → Ajouter une localisation
  3. Créez InfoPlist.strings pour chaque langue :
// InfoPlist.strings (Espagnol)
"CFBundleName" = "Mi Aplicación";
"NSCameraUsageDescription" = "La aplicación necesita acceso a la cámara para tomar fotos.";

Partie 4 : Pluriel

Différentes langues ont des règles de pluriel différentes :

  • Anglais : 2 formes (un, autre)
  • Russe : 3 formes (un, peu, plusieurs)
  • Polonais : 3 formes (un, peu, autre)
  • Arabe : 6 formes (zéro, un, deux, peu, plusieurs, autre)

Gestion du pluriel dans SwiftUI

// Xcode crée automatiquement des variations plurielles
Text("\(count) articles")

// Avec formatage personnalisé
Text("\(visitorCount) Visiteurs récents")

Dans le catalogue de chaînes :

{
  "strings" : {
    "%lld Visiteurs récents" : {
      "localizations" : {
        "en" : {
          "variations" : {
            "plural" : {
              "one" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Visiteur récent"
                }
              },
              "other" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Visiteurs récents"
                }
              }
            }
          }
        }
      }
    }
  }
}

Format d'exportation XLIFF

Lors de l'exportation pour traduction (Fichier → Exporter les localisations) :

Hérité (stringsdict) :

<trans-unit id="/%lld Visiteurs récents:dict/NSStringLocalizedFormatKey:dict/:string">
    <source>%#@recentVisitors@</source>
</trans-unit>

<trans-unit id="/%lld Visiteurs récents:dict/recentVisitors:dict/one:dict/:string">
    <source>%lld Visiteur récent</source>
    <target>%lld Visitante Recente</target>
</trans-unit>

Catalogue de chaînes (plus propre) :

<trans-unit id="%lld Visiteurs récents|==|plural.one">
    <source>%lld Visiteur récent</source>
    <target>%lld Visitante Recente</target>
</trans-unit>

<trans-unit id="%lld Visiteurs récents|==|plural.other">
    <source>%lld Visiteurs récents</source>
    <target>%lld Visitantes Recentes</target>
</trans-unit>

Substitutions avec variables plurielles

// Plusieurs variables avec différentes formes plurielles
let message = String(localized: "\(songCount) chansons sur \(albumCount) albums")

Xcode crée des variations pour la forme plurielle de chaque variable :

  • songCount : un, autre
  • albumCount : un, autre
  • Total des combinaisons : 2 × 2 = 4 entrées de traduction

Partie 5 : Variations d'appareil et de largeur

Chaînes spécifiques à l'appareil

Texte différent pour différentes plateformes :

// Même code, chaînes différentes par appareil
Text("Boutique de nourriture pour oiseaux")

Variations dans le catalogue de chaînes :

{
  "Boutique de nourriture pour oiseaux" : {
    "localizations" : {
      "en" : {
        "variations" : {
          "device" : {
            "applewatch" : {
              "stringUnit" : {
                "value" : "Nourriture pour oiseaux"
              }
            },
            "other" : {
              "stringUnit" : {
                "value" : "Boutique de nourriture pour oiseaux"
              }
            }
          }
        }
      }
    }
  }
}

Résultat :

  • iPhone/iPad : « Boutique de nourriture pour oiseaux »
  • Apple Watch : « Nourriture pour oiseaux » (plus court pour les petits écrans)

Variations de largeur

Pour le texte dynamique et les classes de taille :

Text("Paramètres de l'application")

Le catalogue de chaînes peut fournir un texte plus court pour les largeurs étroites.


Partie 6 : Support RTL

Mise en miroir de la disposition

SwiftUI met automatiquement en miroir les dispositions pour les langues RTL :

// ✅ Se met automatiquement en miroir pour l'arabe/l'hébreu
HStack {
    Image(systemName: "chevron.right")
    Text("Suivant")
}

// iPhone (Anglais) : [>] Suivant
// iPhone (Arabe) :  Suivant [<]

leading/trailing vs gauche/droite

Utilisez toujours les directions sémantiques :

// ✅ Correct - se met en miroir automatiquement
.padding(.leading, 16)
.frame(maxWidth: .infinity, alignment: .leading)

// ❌ Faux - ne se met pas en miroir
.padding(.left, 16)
.frame(maxWidth: .infinity, alignment: .left)

Images et icônes

Marquez les images qui doivent / ne doivent pas être retournées :

// ✅ Directionnel - se met en miroir pour RTL
Image(systemName: "chevron.forward")

// ✅ Non directionnel - jamais en miroir
Image(systemName: "star.fill")

// Images personnalisées
Image("backButton")
    .flipsForRightToLeftLayoutDirection(true)

Test en mode RTL

Schéma Xcode :

  1. Modifier le schéma → Exécuter → Options
  2. Langue de l'application : Arabe / Hébreu
  3. OU : Langue de l'application → Pseudo-langue droite-à-gauche

Simulateur : Réglages → Général → Langue et région → Ordre des langues préférées

Aperçu SwiftUI :

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
            .environment(\.layoutDirection, .rightToLeft)
            .environment(\.locale, Locale(identifier: "ar"))
    }
}

Partie 7 : Formatage adapté à la locale

DateFormatter

let formatter = DateFormatter()
formatter.locale = Locale.current  // ✅ Utilisez la locale actuelle
formatter.dateStyle = .long
formatter.timeStyle = .short

let dateString = formatter.string(from: Date())

// US : "January 15, 2024 at 3:30 PM"
// France : "15 janvier 2024 à 15:30"
// Japon : "2024年1月15日 15:30"

Ne codez jamais en dur les chaînes de format de date :

// ❌ Faux - cassé dans d'autres locales
formatter.dateFormat = "MM/dd/yyyy"

// ✅ Correct - s'adapte à la locale
formatter.dateStyle = .short

NumberFormatter pour la devise

let formatter = NumberFormatter()
formatter.locale = Locale.current
formatter.numberStyle = .currency

let priceString = formatter.string(from: 29.99)

// US : "$29.99"
// UK : "£29.99"
// Japon : "¥30" (arrondit à l'entier)
// France : "29,99 €" (virgule décimale, espace avant le symbole)

MeasurementFormatter

let distance = Measurement(value: 100, unit: UnitLength.meters)

let formatter = MeasurementFormatter()
formatter.locale = Locale.current

let distanceString = formatter.string(from: distance)

// US : "328 ft" (convertit en impérial)
// Pays métriques : "100 m"

Tri adapté à la locale

let names = ["Ångström", "Zebra", "Apple"]

// ✅ Tri adapté à la locale
let sorted = names.sorted { (lhs, rhs) in
    lhs.localizedStandardCompare(rhs) == .orderedAscending
}

// Suède : ["Ångström", "Apple", "Zebra"]  (Å vient en premier en suédois)
// US : ["Ångström", "Apple", "Zebra"]      (Å traité comme A)

Partie 8 : Localisation des App Shortcuts

Phrases avec paramètres

import AppIntents

struct ShowTopDonutsIntent: AppIntent {
    static var title: LocalizedStringResource = "Afficher les meilleurs donuts"

    @Parameter(title: "Période")
    var timeframe: Timeframe

    static var parameterSummary: some ParameterSummary {
        Summary("\(.applicationName) Tendances pour \(\.$timeframe)") {
            \.$timeframe
        }
    }
}

Le catalogue de chaînes extrait automatiquement :

  • Le titre de l'intention
  • Les noms des paramètres
  • Les modèles de phrases avec espaces réservés

Phrases localisées :

Anglais : "Food Truck Trends for this week"
Espagnol : "Tendencias de Food Truck para esta semana"

Localisation d'AppShortcutsProvider

struct FoodTruckShortcuts: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: ShowTopDonutsIntent(),
            phrases: [
                "\(.applicationName) Tendances pour \(\.$timeframe)",
                "Afficher les

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés