Statamic CMS 国际化：如何翻译默认字典数据

在Statamic CMS内容管理系统中，当用户使用非英语界面时，系统内置的预设字典（如国家列表和货币列表）的标签仍然显示为英文。本文将探讨如何为这些预设字典实现多语言支持。

问题背景

Statamic CMS的字典字段类型允许用户选择预设数据，如国家列表和货币列表。然而，这些数据的标签目前仅提供英文版本，当后台界面切换到其他语言时，标签不会自动翻译，影响非英语用户的使用体验。

解决方案设计

翻译文件结构

建议采用模块化的翻译文件结构，将字典翻译与常规界面翻译分离：

1. 为每种语言创建专门的字典翻译文件
2. 按照字典类型分类存储（国家、货币等）
3. 使用标准化的命名空间（如statamic::dictionary-{type}）

实现示例

以国家字典为例，翻译文件可设计如下：

// resources/lang/{locale}/dictionary-countries.php
return [
    'regions' => [
        'africa' => '非洲',
        'americas' => '美洲',
        // 其他大洲翻译...
    ],
    'subregions' => [
        'southern_asia' => '南亚',
        // 其他子区域翻译...
    ],
    'names' => [
        'AFG' => '某国',
        // 其他国家名称翻译...
    ],
];

字典数据调用

在字典数据类中，通过Laravel的翻译函数动态获取对应语言的标签：

protected function getItems(): array
{
    return [
        [
            'name' => __('statamic::dictionary-countries.names.AFG'),
            'iso3' => 'AFG',
            'iso2' => 'AF',
            'region' => __('statamic::dictionary-countries.regions.asia'),
            'subregion' => __('statamic::dictionary-countries.subregions.southern_asia'),
            'emoji' => '🇦🇫'
        ],
        // 其他国家的数据...
    ];
}

技术考量

1. 性能优化：翻译结果会被Laravel自动缓存，不会影响性能
2. 维护性：翻译文件与代码逻辑分离，便于后期维护和更新
3. 扩展性：此方案可轻松扩展到其他类型的预设字典
4. 兼容性：完全兼容Statamic现有的国际化机制

实施建议

1. 优先翻译常用字典（国家、货币）
2. 保持翻译键名与原始数据一致
3. 为每种语言提供完整的翻译文件
4. 考虑使用自动化工具辅助翻译过程

通过这种结构化、模块化的翻译方案，可以显著提升Statamic CMS在多语言环境下的用户体验，同时保持代码的整洁和可维护性。