翻译系统

翻译系统 是一个多语言支持的翻译工具，旨在帮助用户将网页或数据内容翻译成多种语言，以便实现跨语言的信息交流。该系统能够自动检测原始文本或网页内容，并将其翻译为用户选择的目标语言。无论是纯文本、HTML 内容，还是动态数据，用户都能通过简便的操作将其转换为多种常见语言，如英语、中文、西班牙语、法语等，从而帮助用户在全球范围内提供本地化的服务和信息。

翻译系统配置指南

1. 配置站点模板

在安装完成后，首先需要在系统中配置站点模板。具体步骤如下：

1. 增加相关语言的设备在设备管理模块中新增设备，并填写以下信息：

   • 设置名：为该设备命名（如“英语站点”）。
   • 访问域名：绑定该语言对应的访问域名（如 en.example.com）。
   • 设备模板：选择对应的语言模板。

   注意：如果使用二级目录方式访问（如 example.com/en），需要在“设备识别符”字段中填写 DIR。

   

2. 开启伪静态

伪静态配置

3. 设置翻译系统

翻译系统的配置分为三个核心部分：页面翻译配置、翻译设置和接口配置。

翻译系统依赖于站点设备模块的支持，确保“站点设备”已启用并正确关联到翻译系统。

graph TD;
主菜单-->辅助-->翻译系统;
翻译系统-->翻译设置;
翻译设置-->翻译设置选项;
翻译设置-->页面翻译配置;
翻译设置-->翻译接口配置;

3.1 配置翻译接口

翻译接口是实现多语言翻译的核心组件，需正确配置以支持自动翻译功能。

• 进入“翻译接口”配置页面，填写以下信息：
  • 接口类型：选择支持的翻译服务提供商（如Google Translate、DeepL等）。
  • API密钥：输入从翻译服务提供商获取的API密钥。

提示：确保API密钥具有足够的权限，并定期检查其有效性。

3.2 配置页面翻译

完成接口配置后，需进一步设置页面翻译，以确保系统能够根据用户访问的语言自动加载翻译内容。

• 绑定需要翻译的页面或模块。

4. 验证配置

完成上述配置后，访问相关语言的域名或路径（如 en.example.com或 example.com/en），系统将自动根据用户的语言偏好加载翻译内容。

注意事项：

• 确保所有语言模板已正确上传并匹配。
• 定期检查翻译接口的可用性和性能。
• 对于重要页面，建议优先使用人工翻译以提高准确性。

其它设置

1. 不需要翻译的内容

如果某些内容不需要被翻译，可以通过以下方式标记：

<!--{'不需要翻译的内容'|keep}-->

上述代码会确保该部分内容在多语言环境下保持原样，不会被替换为其他语言的翻译内容。

2. 使用模板语言包

在模板中使用语言包时，可以通过以下语法调用翻译内容：

<!--{'site_name'|lang}-->

• site_name 是语言包中的键名。
• |lang 是模板引擎的过滤器，用于根据当前语言环境自动加载对应的翻译内容。

3. 语言包的存放位置

语言包文件存放在模板目录下的 lang 文件夹中。根据需求，可以选择将所有语言集中存放在一个文件中，或者为每种语言单独创建一个文件。

3.1 所有语言集中存放

将所有语言的翻译内容统一存放在以下路径中：

\iCMS8\template\模板目录\lang\ALL.json

格式示例：

{
    "zh": {
        "site_name": "iCMS 演示站点",
        "option": "其它"
    },
    "en": {
        "site_name": "iCMS Demo Site",
        "option": "Other"
    },
    "ja": {
        "site_name": "iCMSデモサイト",
        "option": "その他"
    },
    "fr": {
        "site_name": "Site de démonstration iCMS",
        "option": "Autre"
    },
    "ru": {
        "site_name": "Демонстрационный сайт iCMS",
        "option": "Другое"
    }
}

• 说明：
  • 每个语言的翻译内容以语言代码（如 zh, en, ja 等）作为顶层键。
  • 每个语言下的键值对表示具体的翻译内容。

3.2 单独设置某个语言的语言包

如果需要为特定语言单独创建语言包文件，可以按照以下路径存放：

\iCMS8\template\模板目录\lang\en.json

格式示例：

{
    "site_name": "iCMS Demo Site",
    "option": "Other"
}

• 说明：
  • 文件名为语言代码（如 en.json 表示英语）。
  • 文件内容直接包含该语言的所有翻译键值对。

4. 语言包加载优先级

系统会根据以下顺序加载语言包：

1. 单独语言包优先： 如果存在单独的语言包文件（如 en.json），系统会优先加载该文件。
2. 集中语言包备用： 如果未找到单独的语言包文件，则从 ALL.json 中加载对应语言的翻译内容。

5. 注意事项

• 键名一致性： 确保语言包中的键名与模板中使用的键名完全一致，否则可能导致翻译内容无法正确加载。
• 默认语言： 如果某语言的翻译内容缺失，系统会回退到默认语言（通常为 zh 或系统配置的默认语言）。
• 避免重复定义： 在 ALL.json 和单独语言包中不要重复定义相同的键，以免造成混淆。

6. 示例完整流程

假设当前模板需要支持中、英、日三种语言，以下是实现步骤：

1. 创建语言包文件：

   • 集中语言包 ALL.json：

     {
         "zh": {
             "site_name": "iCMS 演示站点",
             "option": "其它"
         },
         "en": {
             "site_name": "iCMS Demo Site",
             "option": "Other"
         },
         "ja": {
             "site_name": "iCMSデモサイト",
             "option": "その他"
         }
     }

   • 英语单独语言包 en.json（可选）：

     {
         "site_name": "iCMS Demo Site",
         "option": "Other"
     }

2. 在模板中调用翻译内容：

   <h1><!--{'site_name'|lang}--></h1>
   <p><!--{'option'|lang}--></p>

3. 运行效果：

   • 当前语言为 zh 时，页面显示：

     iCMS 演示站点
     其它

   • 当前语言为 en 时，页面显示：

     iCMS Demo Site
     Other

多语言国际站点SEO优化与语言切换功能实现

为了提升多语言站点的国际化体验和搜索引擎优化（SEO）效果，以下提供了两种关键功能的实现说明：多语言SEO优化和页面语言切换功能。通过合理的配置，您可以轻松实现站点的多语言支持，并确保用户和搜索引擎都能准确识别不同语言版本的内容。

1. 多语言SEO优化

在多语言站点中，hreflang 标签是搜索引擎识别页面语言版本的重要工具。通过以下代码片段，可以动态生成 hreflang 标签，帮助搜索引擎正确索引每种语言的页面内容。

<!--{$hreflangs}--> 是一个全局标签，用于存储当前页面对应的所有语言版本信息。

<!--{if $hreflangs}-->
    <!--{foreach value="hl" from="$hreflangs"}-->
    <link rel="alternate" hreflang="<!--{$hl.lang}-->" href="<!--{$hl.url}-->" />
    <!--{/foreach}-->
<!--{/if}-->

说明：

• $hreflangs 是一个全局变量，包含了当前页面所有语言版本的信息。
• 每个语言版本通过 hreflang 属性指定语言代码（如 en、zh），并提供对应的页面链接（href）。
• 该代码会根据 $hreflangs 的内容动态生成 <link> 标签，确保搜索引擎能够识别并正确索引每种语言的页面。

2. 页面语言切换功能

为了让用户能够方便地在不同语言版本之间切换，可以通过以下代码实现一个下拉菜单式的语言切换功能：

<select onchange="window.location.href = this.options[this.selectedIndex].value;">
    <!--{foreach value="hl" from="$hreflangs"}-->
    <option value="<!--{$hl.url}-->"><!--{$hl.title|keep}--></option>
    <!--{/foreach}-->
</select>

说明：

• 下拉菜单 (<select>) 动态生成了所有可用的语言选项。
• 每个 <option> 的值为对应语言版本的页面链接（$hl.url），显示文本为该语言的标题（$hl.title）。
• 当用户选择某个语言时，onchange 事件会触发页面跳转，将用户引导至所选语言的页面。

通过上述步骤，您可以轻松完成翻译系统的配置，快速实现多语言站点的自动化翻译功能。
借助模板语言包功能，不仅能够便捷地支持多语言切换，还可以灵活管理各类翻译内容，确保语言表达的准确性和一致性。
如在操作过程中有任何疑问，欢迎随时查阅官方文档，或联系我们的技术支持团队获取专业协助！

案例

网站名称：美食小吃排行榜

网址：https://www.toplll.com/

语言：中文、英语、日语、俄语、韩语、西班牙语、法语等10种语言