前端国际化之痛点(三):上线后修改翻译内容

前言

VoerkaI18n是一款非常优秀的前端国际化解决方案,其开发的出发点是为了解决现存多语言的一些痛点,接下来几篇文章将分别进行分析

-->点击进入项目官网<--

现有痛点

在实际应用中,我们经常会在应用上线后,有没有经常碰到这样的问题:

  • 发现应用中的翻译错误
  • 不同的客户可能会一些用词提出不同的要求
  • 甚至有些客户要求能自定义一些显示用语

一般解决方案是重新打包应用重新发布,显然这是比较麻烦的解决方案。

解决痛点

voerkai18n的语言包补丁特性针对此问题,提供了完美的解决方案,您就可以随时修复翻译错误,而不需要重新打包应用。

基本思路:应用上线后发现翻译错误时,可以在服务器上约定位置放置语言包补丁,应用会自动进行更新修复,很实用的一个特性。

基本方法如下:

准备

为说明如何使用语言包补丁特性支持,我们将假设以下的应用:

应用chat,依赖于usermanagerlog等三个库,均使用了voerkiai18n作为多语言解决方案。

其拟支持zhende共三种语言。

当执行完voerkai18n compile后,项目结构大概如下:

javascript 复制代码
chat
  |-- languages
  | |-- index.js
  | |-- idMap.js   
  | |-- runtime.js
  | |-- settings.json                  
  | |-- zh.js
  | |-- en.js
  | |-- formatters
  |     |-- zh.js
  |     |-- en.js
  | |-- translates
  |       |-- default.json
  |-- index.js
  |-- package.json                  //name=chat

打开languages/index.js,大概如下:

javascript 复制代码
// ....
const scope = new i18nScope({
    id: "chat",                          // 当前作用域的id,自动取当前工程的package.json的name
    messages:{ 
        "en" : ()=>import("./en.js"),
        "de" : ()=>import("./de.js")
    },
    //.....
}) 
/// ....
  • 可以看到在languages/index.js中创建了一个以当前工程package.jsonnameidi18nScope实例,其会自动注册到全局voerkaI18n实例中。

第一步:注册默认的语言加载器

voerkiai18n是采用语言加载器来加载语言包的,为了从服务器上远程加载语言包补丁,需要注册一个加载器。

需要在应用中(例如app.jsmain.js等)导入i18nScope实例或者直接在languages/index.js中并注册一个默认的语言加载器。

javascript 复制代码
// 从当前工程导入`scope`实例
import { i18nScope } from "./languages"

// 注册默认的语言加载器
// 在此向服务器发起请求,请返回翻译后的其他语言文本
i18nScope.registerDefaultLoader(async (language,scope)=>{
    // language: 要切换到此语言
    // scope: 语言作用域实例   
    return await (await fetch(`/languages/${scope.id}/${language}.json`)).json()
})

第二步:编写语言包补丁文件

假设我们发现zh语言的翻译错误,这就需要在服务器上生成一个对应的zh语言包补丁文件。

方法很简单,打开languages/zh.js文件,该文件大概如下:

javascript 复制代码
module.exports = {
    "1": "支持的语言",
    "2": "默认语言",
    "3": "激活语言",
    "4": "名称空间s",
    ....
}

复制一份修改和更名为zh.json,其中仅保留需要修复的条目,内容大概如下:

javascript 复制代码
{
    "1": "支持的语言",       
}

然后将zh.json复制到languages/chat/zh.json即可。

同样地,我们如果要修复usermanagerlog等三个库的翻译错误,如法泡制,生成语言包文件languages/user/de.json,languages/manager/de.json,languages/log/de.json

第三步:组织语言包补丁文件

在上面中,我们通过fetch(/languages/${scope.id}/${language}.json)来读取语言包(您可以使用任意您喜欢的方式,如axios),这意味着我们需要在web服务器上根据此URL来组织语言包补丁,以便可以下载到语言包补丁。需要将语言包补丁保存在服务器的指定位置,如下:

javascript 复制代码
webroot
  |-- languages
    <chat>          
       |-- zh.json        
    <user>               
       |-- zh.json    
    <manager>                 
       |-- zh.json   
    <log>                 
       |-- zh.json               

完成:自动打语言包补丁

至此,语言包补丁功能已配置完毕。当应用启动时就会自动加载该补丁合并到线上应用的语言包中。

小结

利用VoerkaI18n的此特性,产品上线的翻译内容更新和修复变得非常容易,强列推荐。

-->点击进入项目官网<--

相关推荐
懒大王爱吃狼21 分钟前
Python教程:python枚举类定义和使用
开发语言·前端·javascript·python·python基础·python编程·python书籍
小牛itbull1 小时前
ReactPress:重塑内容管理的未来
react.js·github·reactpress
逐·風4 小时前
unity关于自定义渲染、内存管理、性能调优、复杂物理模拟、并行计算以及插件开发
前端·unity·c#
Devil枫5 小时前
Vue 3 单元测试与E2E测试
前端·vue.js·单元测试
Yaml45 小时前
Spring Boot 与 Vue 共筑二手书籍交易卓越平台
java·spring boot·后端·mysql·spring·vue·二手书籍
尚梦5 小时前
uni-app 封装刘海状态栏(适用小程序, h5, 头条小程序)
前端·小程序·uni-app
GIS程序媛—椰子6 小时前
【Vue 全家桶】6、vue-router 路由(更新中)
前端·vue.js
前端青山6 小时前
Node.js-增强 API 安全性和性能优化
开发语言·前端·javascript·性能优化·前端框架·node.js
毕业设计制作和分享7 小时前
ssm《数据库系统原理》课程平台的设计与实现+vue
前端·数据库·vue.js·oracle·mybatis
清灵xmf9 小时前
在 Vue 中实现与优化轮询技术
前端·javascript·vue·轮询