Communitygithub.com

David-Li0406/meta-skill-evloving

Localisez les modèles, formulaires et contenus dans B2C Commerce. Utilisez-le pour ajouter des traductions, travailler avec des bundles de ressources (fichiers .properties), utiliser Resource.msg, ou implémenter le support multi-locale. Couvre les dossiers de locale, l'externalisation des chaînes, et le formatage des dates et devises.

Qu'est-ce que meta-skill-evloving ?

Cette compétence guide le développeur dans la localisation de boutiques B2C Commerce pour plusieurs langues et régions. Elle est essentielle pour rendre un site e-commerce accessible à un public international, en suivant les meilleures pratiques de la plateforme Salesforce Commerce Cloud. La compétence détaille comment structurer les bundles de ressources (fichiers .properties) dans des dossiers par locale (ex: /fr, /de, /fr_CA), comment utiliser les fonctions Resource.msg() et Resource.msgf() dans les modèles ISML pour afficher du texte traduit, et comment gérer la cascade de fallback (locale spécifique → langue → défaut). Elle couvre également la localisation des fichiers statiques (images, CSS), des formulaires (labels d'attributs via resource bundles), des emails, ainsi que le formatage des dates et des monnaies en fonction de la locale. Enfin, elle fournit des exemples pour construire un sélecteur de langue et implémenter une logique métier locale-spécifique dans les contrôleurs.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/David-Li0406/meta-skill-evloving/tree/HEAD/skill-flow/data/skills-refined-36k/skillsmp/b2c-localization

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

meta-skill-evloving preview

Documentation

Compétence de Localisation

Cette compétence vous guide dans la localisation de vitrines B2C Commerce pour plusieurs langues et régions.

Aperçu

B2C Commerce prend en charge la localisation via :

ComposantApproche
ModèlesEnsemble de modèles unique + bundles de ressources
FormulairesDéfinitions partagées + libellés spécifiques à la locale
Contenu statiqueDossiers spécifiques à la locale
Données produitAttributs localisables

Format de Locale

Les locales suivent les normes ISO : {langue}_{pays}

FormatExempleDescription
enAnglaisLangue uniquement
en_USAnglais/États-UnisLangue + pays
fr_CAFrançais/CanadaLangue + pays
de_DEAllemand/AllemagneLangue + pays

Bundles de Ressources

Structure des Répertoires

/cartridge
    /templates
        /resources
            account.properties          # Défaut (Anglais)
            checkout.properties
            /fr
                account.properties      # Français
                checkout.properties
            /de
                account.properties      # Allemand
                checkout.properties
            /fr_CA
                account.properties      # Français Canadien

Format du Fichier de Propriétés

account.properties (défaut) :

##############################################
# Pages de Compte
##############################################
account.title=Mon Compte
account.greeting=Bon retour
account.logout=Déconnexion

# Tableau de Bord
dashboard.title=Tableau de bord
dashboard.orders=Historique des commandes
dashboard.addresses=Carnet d'adresses
dashboard.wishlist=Liste de souhaits

# Profil
profile.title=Profil
profile.firstName=Prénom
profile.lastName=Nom
profile.email=Adresse e-mail
profile.save=Enregistrer les modifications

account_fr.properties (Français) :

account.title=Mon compte
account.greeting=Bon retour
account.logout=Se déconnecter

dashboard.title=Tableau de bord
dashboard.orders=Historique des commandes
dashboard.addresses=Carnet d'adresses
dashboard.wishlist=Liste de souhaits

profile.title=Profil
profile.firstName=Prénom
profile.lastName=Nom
profile.email=Adresse e-mail
profile.save=Enregistrer les modifications

Utilisation des Ressources dans les Modèles

<!-- Message simple -->
<h1>${Resource.msg('account.title', 'account', null)}</h1>

<!-- Avec valeur de repli -->
<p>${Resource.msg('account.greeting', 'account', 'Bienvenue')}</p>

<!-- Avec paramètres -->
<p>${Resource.msgf('cart.items', 'cart', null, cartCount)}</p>

Paramètres Resource.msg() :

  1. Nom de la clé
  2. Nom du bundle (nom du fichier sans extension)
  3. Valeur par défaut (null = utiliser la clé si non trouvée)

Messages Paramétrés

Propriété :

cart.itemCount=Vous avez {0} articles dans votre panier
greeting.personalized=Bonjour, {0} {1}!
order.confirmation=Commande #{0} passée le {1}

Modèle :

${Resource.msgf('cart.itemCount', 'cart', null, itemCount)}
${Resource.msgf('greeting.personalized', 'common', null, firstName, lastName)}

Repli de Locale

B2C Commerce utilise une chaîne de repli : fr_CA → fr → défaut

Exemple : Demande fr_CA :

  1. Chercher dans /resources/fr_CA/account.properties
  2. Si non trouvé, chercher dans /resources/fr/account.properties
  3. Si non trouvé, chercher dans /resources/account.properties

Fichiers Statiques

Structure des Répertoires

/cartridge
    /static
        /default
            /css
                style.css
            /images
                logo.png
                buttons/
                    submit.png
            /js
                main.js
        /fr
            /images
                buttons/
                    submit.png      # Texte français sur le bouton
        /de
            /images
                buttons/
                    submit.png      # Texte allemand sur le bouton

Référencement des Fichiers Statiques

<!-- Utilise la version spécifique à la localité si disponible -->
<img src="${URLUtils.staticURL('/images/buttons/submit.png')}" alt="Soumettre"/>

<!-- CSS (généralement non localisé) -->
<link rel="stylesheet" href="${URLUtils.staticURL('/css/style.css')}"/>

Localisation des Formulaires

Définition du Formulaire

<?xml version="1.0" encoding="UTF-8"?>
<form xmlns="http://www.demandware.com/xml/form/2008-04-19">
    <field formid="email" label="form.email.label" type="string"
           mandatory="true"
           missing-error="form.email.required"
           parse-error="form.email.invalid"/>
</form>

Bundle de Ressources

forms.properties :

form.email.label=Adresse e-mail
form.email.required=L'email est requis
form.email.invalid=Veuillez entrer une adresse e-mail valide

forms_fr.properties :

form.email.label=Adresse e-mail
form.email.required=L'email est requis
form.email.invalid=Veuillez entrer une adresse e-mail valide

Localisation des URLs

URLs Sensibles à la Locale

<!-- URL actuelle de la locale -->
<a href="${URLUtils.url('Product-Show', 'pid', 'ABC123')}">Voir le produit</a>

<!-- URL spécifique à la locale -->
<a href="${URLUtils.url(new URLAction('Product-Show', 'MySite', 'fr'))}">
    Voir le produit
</a>

Sélecteur de Langue

<isscript>
    var Site = require('dw/system/Site');
    var URLAction = require('dw/web/URLAction');
    var URLUtils = require('dw/web/URLUtils');
    var Locale = require('dw/util/Locale');
</isscript>

<ul class="language-switcher">
    <isloop items="${Site.current.allowedLocales}" var="localeId">
        <isscript>
            var locale = new Locale(localeId);
            var url = URLUtils.url(new URLAction('Home-Show', Site.current.ID, localeId));
        </isscript>
        <li class="${request.locale == localeId ? 'active' : ''}">
            <a href="${url}">${locale.displayLanguage}</a>
        </li>
    </isloop>
</ul>

Localisation des Contrôleurs

Accès à la Locale Courante

var Locale = require('dw/util/Locale');

server.get('Show', function (req, res, next) {
    var currentLocale = Locale.getLocale(req.locale.id);

    res.render('mytemplate', {
        locale: req.locale.id,
        language: currentLocale.language,
        country: currentLocale.country,
        displayLanguage: currentLocale.displayLanguage,
        displayCountry: currentLocale.displayCountry
    });
    next();
});

Logique Spécifique à la Locale

server.get('Checkout', function (req, res, next) {
    var locale = req.locale.id;

    // Format de date spécifique à la locale
    var dateFormat = locale.startsWith('en_US') ? 'MM/dd/yyyy' : 'dd/MM/yyyy';

    // Contenu spécifique à la locale
    var termsContentId = 'terms-' + locale.replace('_', '-').toLowerCase();

    res.render('checkout', {
        dateFormat: dateFormat,
        termsContentId: termsContentId
    });
    next();
});

Modèles d'Email

Définition de la Locale

var Template = require('dw/util/Template');
var HashMap = require('dw/util/HashMap');
var Mail = require('dw/net/Mail');

function sendOrderConfirmation(order, locale) {
    var template = new Template('mail/orderconfirmation', locale);
    var model = new HashMap();
    model.put('order', order);

    var content = template.render(model).text;

    var mail = new Mail();
    mail.addTo(order.customerEmail);
    mail.setFrom('[email protected]');
    mail.setSubject(Resource.msg('email.order.subject', 'email', null));
    mail.setContent(content, 'text/html', 'UTF-8');
    mail.send();
}

Formatage de la Monnaie

La monnaie est liée à la locale :

var Money = require('dw/value/Money');
var StringUtils = require('dw/util/StringUtils');

// Formater avec la locale
var price = new Money(99.99, 'USD');
var formatted = StringUtils.formatMoney(price);  // Utilise la locale courante

// Dans le modèle
<isprint value="${product.priceModel.price}" style="CURRENCY"/>

Formatage des Dates

var StringUtils = require('dw/util/StringUtils');
var Calendar = require('dw/util/Calendar');

var date = new Calendar();
var formatted = StringUtils.formatCalendar(date, 'yyyy-MM-dd');  // Format ISO
var localized = StringUtils.formatCalendar(date, 'MMMM d, yyyy');  // Sensible à la locale

Bonnes Pratiques

  1. Utilisez UTF-8 pour tous les fichiers de propriétés (obligatoire pour les caractères non ASCII)
  2. Organisez les bundles par page/fonctionnalité pas par langue
  3. Gardez les clés descriptives - account.profile.firstName pas label1
  4. Utilisez des paramètres pour les valeurs dynamiques - ne concaténez pas les chaînes
  5. Testez toutes les locales - assurez-vous que le repli fonctionne correctement
  6. Ne codez pas en dur le texte dans les modèles ou les scripts

Référence Détaillée

Individual skills in this repo

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

David-Li0406/meta-skill-evloving

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.

David-Li0406/meta-skill-evloving

Create technical diagrams using Mermaid syntax for architecture, sequences, ERDs, flowcharts, and state machines. Use for visualizing system design, data flows, and processes. Triggers: diagram, mermaid, architecture diagram, sequence diagram, flowchart, ERD, entity relationship, state diagram, C4 model, component diagram, visualize, draw.

David-Li0406/meta-skill-evloving

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

David-Li0406/meta-skill-evloving

Complete color manipulation and green screen effects system. PROACTIVELY activate for: (1) Green screen/chromakey removal, (2) Color grading with LUTs, (3) Color correction (levels, curves, white balance), (4) Colorkey/color removal effects, (5) Hue/saturation manipulation, (6) Color space conversions (BT.709, BT.2020, HDR), (7) Color isolation effects, (8) Teal and orange look, (9) Vintage/film looks, (10) Color keying for transparency. Provides: chromakey and colorkey filters, LUT application (lut3d), curves and levels adjustment, color balance, selective color manipulation, color space handling, HDR tone mapping, professional color grading chains.

David-Li0406/meta-skill-evloving

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

David-Li0406/meta-skill-evloving

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

David-Li0406/meta-skill-evloving

Build with OpenAI's stateless APIs - Chat Completions (GPT-5, GPT-4o), Embeddings, Images (DALL-E 3), Audio (Whisper + TTS), and Moderation. Includes Node.js SDK and fetch-based approaches for Cloudflare Workers. Use when: implementing chat completions with GPT-5/GPT-4o, streaming responses with SSE, using function calling/tools, creating structured outputs with JSON schemas, generating embeddings for RAG (text-embedding-3-small/large), generating images with DALL-E 3, editing images with GPT-Image-1, transcribing audio with Whisper, synthesizing speech with TTS (11 voices), moderating content (11 safety categories), or troubleshooting rate limits (429), invalid API keys (401), function calling failures, streaming parse errors, embeddings dimension mismatches, or token limit exceeded.

David-Li0406/meta-skill-evloving

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

David-Li0406/meta-skill-evloving

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

David-Li0406/meta-skill-evloving

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

David-Li0406/meta-skill-evloving

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

David-Li0406/meta-skill-evloving

Best practices for Remotion - Video creation in React

David-Li0406/meta-skill-evloving

Provides bidirectional translation (Chinese/English), grammar checking, and sentence polishing. Supports specific tense constraints, context-aware tone adjustment, and natural expression optimization. Outputs direct text without formatting.

David-Li0406/meta-skill-evloving

指导如何通过自定义注解(如@Unicom)标识Dubbo接口,利用BeanDefinitionRegistryPostProcessor在启动时扫描并动态注册ReferenceBean,实现RPC调用的封装。

David-Li0406/meta-skill-evloving

生成Python脚本,利用FFmpeg将图片序列按3x3布局合并,或将合并图拆分。要求使用subprocess模块执行命令,并支持用户交互式输入路径。

David-Li0406/meta-skill-evloving

SOP for extracting and analyzing promotional activity details, handling time formatting, location mapping, payment logic, and step-by-step process validation.

David-Li0406/meta-skill-evloving

Specializes in creating TikTok short video scripts using an anthropomorphic 'Chef' perspective to explain wildlife food chains and survival environments, utilizing real field footage.

David-Li0406/meta-skill-evloving

针对TikTok平台,以拟人化视角(如动物作为厨师)创作系列短视频脚本。重点介绍野生动物、食物链及生态环境,要求使用野外实拍素材,风格幽默且具有教育意义。

David-Li0406/meta-skill-evloving

Generates KWL (Know, Want to know, Learned) charts for educational videos, specifically BrainPOP, using simple 7th-grade language and short, concise bullet points.

David-Li0406/meta-skill-evloving

Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides persistent memory that survives conversation compaction. Use when work spans multiple sessions, has complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like "create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or "update status".

Skills associés