Communitygithub.com

B2C Commerce 本地化技能

用于本地化 B2C 商务系统中的模板、表单和内容。在添加翻译、处理资源包(*.properties 文件)、使用 Resource.msg 或实现多区域支持时使用。涵盖区域设置文件夹、字符串外部化以及日期/货币格式化。

B2C Commerce 本地化技能 是什么?

该技能提供了一套完整的指南,用于在 Salesforce B2C Commerce 中实现多语言和多区域支持。它详细介绍了如何通过资源包、表单定义、静态文件、控制器逻辑以及 URL 处理来管理本地化内容。支持的平台包括 B2C Commerce 开发环境(如 Demandware 的 Storefront Reference Architecture)。技能的核心在于利用 ISO 标准区域格式(如 en_US、fr_CA)和层级化的资源包目录结构,并遵循区域回退链(例如 fr_CA → fr → 默认)以确保翻译的可用性。此外,它还涵盖了 Resource.msg 和 Resource.msgf 等 API 的使用、参数化消息、货币和时间日期格式化(通过 StringUtils 和 Calendar),以及最佳实践(如使用 UTF-8 编码、保持键名描述性)。对于开发者和 AI Agent 用户,该技能是实现可扩展、可维护的多语言商店前端的关键参考。

兼容平台~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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

B2C Commerce 本地化技能 preview

文档

本地化技能

本技能指导您如何为 B2C 商务系统实现多语言和多区域商店前端的本地化。

概述

B2C 商务通过以下组件支持本地化:

组件方法
模板单一模板集 + 资源包
表单共享定义 + 特定区域标签
静态内容特定区域文件夹
产品数据可本地化属性

区域格式

区域遵循 ISO 标准:{语言}_{国家}

格式示例描述
en英语仅语言
en_US英语/美国语言 + 国家
fr_CA法语/加拿大语言 + 国家
de_DE德语/德国语言 + 国家

资源包

目录结构

/cartridge
    /templates
        /resources
            account.properties          # 默认(英语)
            checkout.properties
            /fr
                account.properties      # 法语
                checkout.properties
            /de
                account.properties      # 德语
                checkout.properties
            /fr_CA
                account.properties      # 加拿大法语

属性文件格式

account.properties(默认):

##############################################
# 账户页面
##############################################
account.title=我的账户
account.greeting=欢迎回来
account.logout=退出登录

# 账户仪表盘
dashobard.title=仪表盘
dashobard.orders=订单历史
dashobard.addresses=地址簿
dashobard.wishlist=心愿单

# 资料
profile.title=资料
profile.firstName=名
profile.lastName=姓
profile.email=电子邮件地址
profile.save=保存更改

account_fr.properties(法语):

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

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

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

在模板中使用资源

<!-- 简单消息 -->
<h1>${Resource.msg('account.title', 'account', null)}</h1>

<!-- 带后备值 -->
<p>${Resource.msg('account.greeting', 'account', '欢迎')}</p>

<!-- 带参数 -->
<p>${Resource.msgf('cart.items', 'cart', null, cartCount)}</p>

Resource.msg() 参数:

  1. 键名
  2. 包名(不带扩展名的文件名)
  3. 默认值(null = 如果未找到则使用键名)

参数化消息

属性:

cart.itemCount=您的购物车中有 {0} 件商品
greeting.personalized=你好, {0} {1}!
order.confirmation=订单 #{0} 于 {1} 下单

模板:

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

区域回退

B2C 商务使用回退链:fr_CA → fr → 默认

示例: 请求 fr_CA:

  1. 在 /resources/fr_CA/account.properties 中查找
  2. 如果未找到,则在 /resources/fr/account.properties 中查找
  3. 如果仍未找到,则在 /resources/account.properties 中查找

静态文件

目录结构

/cartridge
    /static
        /default
            /css
                style.css
            /images
                logo.png
                buttons/
                    submit.png
            /js
                main.js
        /fr
            /images
                buttons/
                    submit.png      # 按钮上有法语文本
        /de
            /images
                buttons/
                    submit.png      # 按钮上有德语文本

引用静态文件

<!-- 如果可用,则使用特定区域版本 -->
<img src="${URLUtils.staticURL('/images/buttons/submit.png')}" alt="提交"/>

<!-- CSS(通常不本地化) -->
<link rel="stylesheet" href="${URLUtils.staticURL('/css/style.css')}"/>

表单本地化

表单定义

<?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>

资源包

forms.properties:

form.email.label=电子邮件地址
form.email.required=电子邮件为必填项
form.email.invalid=请输入有效的电子邮件地址

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

URL 本地化

区域感知 URL

<!-- 当前区域 URL -->
<a href="${URLUtils.url('Product-Show', 'pid', 'ABC123')}">查看产品</a>

<!-- 特定区域 URL -->
<a href="${URLUtils.url(new URLAction('Product-Show', 'MySite', 'fr'))}">
    Voir le produit
</a>

语言切换器

<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>

控制器本地化

访问当前区域

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();
});

区域特定逻辑

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

    // 区域特定的日期格式
    var dateFormat = locale.startsWith('en_US') ? 'MM/dd/yyyy' : 'dd/MM/yyyy';

    // 区域特定的内容
    var termsContentId = 'terms-' + locale.replace('_', '-').toLowerCase();

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

电子邮件模板

设置区域

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();
}

货币格式化

货币与区域绑定:

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

// 使用区域格式化
var price = new Money(99.99, 'USD');
var formatted = StringUtils.formatMoney(price);  // 使用当前区域

// 在模板中
<isprint value="${product.priceModel.price}" style="CURRENCY"/>

日期格式化

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

var date = new Calendar();
var formatted = StringUtils.formatCalendar(date, 'yyyy-MM-dd');  // ISO 格式
var localized = StringUtils.formatCalendar(date, 'MMMM d, yyyy');  // 区域感知

最佳实践

  1. 对所有属性文件使用 UTF-8(非 ASCII 字符必需)
  2. 按页面/功能组织包,不按语言组织
  3. 保持键名描述性 - 使用 account.profile.firstName 而不是 label1
  4. 对动态值使用参数 - 不要拼接字符串
  5. 测试所有区域 - 确保回退功能正常工作
  6. 不要在模板或脚本中硬编码文本

详细参考

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".

相关技能