多语言智能翻译插件

副标题
无需密钥，前台一键切换，支持自定义语言代码、SVG 图标、忽略词保护与主题适配

产品简介
多语言智能翻译插件是一款面向站点前台的多语言切换解决方案，基于 xnx3/translate 实现，无需填写微软密钥或额外翻译账号，即可快速为网站接入多语言能力。插件支持前台导航栏入口、自定义 SVG 图标、语言启用/关闭/删除/新增、忽略词保留、翻译加载白条占位、主题自适应等能力，适合内容站、社区站、技术站、博客、论坛等场景使用。

它不是一个简单的“翻译按钮”，而是一套可以真正落地的多语言前台组件。你可以根据自己站点的需求定义语言代码、翻译代码和展示名称，也可以灵活决定插件出现在导航栏的哪个位置，让它自然融入你的网站。

---

核心亮点

1. 无需密钥，部署后即可使用
   插件采用 xnx3/translate 免费翻译接口，不需要你额外申请微软或其他翻译服务密钥。

2. 前台直接切换语言
   用户在前台导航栏点击即可切换语言，操作直观，适合站点快速国际化。

3. 支持自定义 SVG 图标
   你可以替换成自己的 SVG 图标，让语言切换入口和站点风格统一。

4. 语言可自由管理
   支持新增语言、关闭语言、删除语言、修改显示名称和本地名称。

5. 语言代码可自定义
   你可以按自己的习惯定义语言代码，比如 cs、ct、jp、kr、vn 等，而翻译实际使用的代码也可以独立配置。

6. 忽略词保护
   可以设置品牌名、站点名、专有名词不参与翻译，避免内容被误翻。

7. 翻译时白条占位
   翻译切换过程中，文字会显示白条加载效果，避免页面出现“中文闪一下再变英文”的突兀感。

8. 主题自适应
   适配浅色和深色主题，前台入口不会遮挡内容，也不会破坏排版。

---

适合哪些用户

• 想给网站加多语言切换的站长
• 做内容站、论坛、技术社区的人
• 需要把站点卖给海外用户的人
• 想让自己的网站更专业、更像正式产品的人
• 不想折腾翻译密钥和复杂配置的人

---

功能说明

1. 前台多语言切换
插件会在站点前台导航栏中显示语言入口，用户可直接切换到对应语言版本。切换后页面内容会自动翻译，并尽量保持原有排版和主题风格。

2. 后台语言管理
后台可管理每个语言项的启用状态、语言代码、translate.js 代码、显示名称和本地名称。你可以按自己的业务习惯自由定义，不必被固定语言列表限制。

3. 自定义图标
支持替换为自定义 SVG 图标，方便与你的网站品牌视觉统一。

4. 忽略词配置
你可以输入不需要翻译的词，例如品牌名、站点名、用户专有名词等，避免翻译结果失真。

5. 翻译占位效果
在语言切换期间，文本内容会出现白条占位，不会出现大面积内容错位或中文残留闪烁。

6. 主题适配
插件会尽量适配站点当前主题，不会硬生生插入一个突兀的组件，也不会遮挡页面正文。

---

使用场景

• 中文站点快速接入英文、日文、韩文、越南文等语言
• 技术社区做海外用户适配
• SaaS 产品或工具站做基础国际化
• 论坛、博客、内容平台做多语言入口
• 需要把网站包装得更专业、更适合售卖的项目

---

产品优势

• 上手快，安装后即可使用
• 不需要你再去申请翻译密钥
• 后台可配置，灵活度高
• 适合多语言展示，也适合做商业化售卖
• 兼顾可用性、排版和视觉一致性
• 对站点内容和主题影响较小

---

如果你现在的网站已经有内容，但还没有多语言能力，这个插件可以直接补上“国际化入口”这块能力。对于准备卖站、做海外流量、或提升站点专业度的用户来说，这是一个很实用的增值功能。

---

常见问题

Q1：需要微软密钥吗？
不需要，插件使用的是 xnx3/translate 免费翻译接口。

Q2：语言代码能不能自己改？
可以。语言代码、翻译代码、展示名称都支持配置，你可以按自己的方式定义。

Q3：会不会把品牌词翻译掉？
不会，只要你把它加入忽略词，插件就会保留原样。

Q4：翻译时页面会不会乱？
插件会使用白条占位和主题适配策略，尽量避免内容闪烁和排版错乱。

Q5：能不能放到导航栏指定位置？
可以，插件支持前台导航栏入口展示。