Skip to content

多语言连接中心 本项目主打一个一处配置多语言,多处使用的想法。

License

Notifications You must be signed in to change notification settings

fanslead/LinguaNex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LinguaNex

多语言连接中心 本项目主打一个一处配置多语言,多处使用的想法。让项目方便快捷实现国际化(多语言)。

可配关联项目,主项目关联其他项目即可获取其他项目的多语言资源,相同Key则优先取主项目中的资源(即覆盖)。

批量导入已存在项目多语言资源。

自动翻译,翻译效果根据不同翻译Provider效果不一致。

测试环境

http://47.119.20.111

http://47.119.20.111/swagger/index.html

应用场景

通过API/SDK拉取多语言资源加载,可选WebSocket对接实现即时更新多语言资源。

  • API后端项目响应内容,如错误码对应的Message国际化多语言处理。
  • Web项目国际化多语言集成,可导出多语言文件编译,或对接API/SDK即时获取加载数据。
  • APP项目与Web基本一致。
  • 骚操作:实现一个短Key完成长文章多语言显示。

运行环境

  • .NET 8
  • Redis
  • RabbitMQ(可选)
  • EF Core SQLLite(可自行替换数据库)

OpenApi接入

请求地址:/api/OpenApi/Resources/{ProjectId}?cultureName=&all=

  • ProjectId表示项目ID
  • cultureName 可选参数,不传则默认当前请求环境语言资源。
  • all 可选参数,默认false,cultureName为空时,true则返回所有语言资源

响应结构如下:

[
  {
    "cultureName": "zh-Hans",
    "resources": {
      "Hello": "你好"
    }
  },
  {
    "cultureName": "en",
    "resources": {
      "Hello": "Hello"
    }
  }
]

SignalR接入(c#例子)

var connection = new HubConnectionBuilder()
    .WithUrl($"{linguaNexApiUrl}/hubs/LinguaNex?project={project}", Microsoft.AspNetCore.Http.Connections.HttpTransportType.WebSockets)
    .AddJsonProtocol()
    .WithAutomaticReconnect()
    .Build();

connection.On<LinguaNexResources>("CreateOrUpdateResource", obj => 
{
    if (_resourcesCache.TryGetValue(obj.CultureName, out var value))
    {
        foreach (var resource in obj.Resources)
        {
            value[resource.Key] = resource.Value;
        }
        _resourcesCache[obj.CultureName] = value;
    }else
    {
        _resourcesCache[obj.CultureName] = new ConcurrentDictionary<string, string>(obj.Resources);
    }
});

connection.StartAsync();

//拉取资源 参数跟OpenApi接口一致
connection.InvokeAsync<List<LinguaNexResources>>("GetResources", projectId, cultureName,all);

.NET SDK 接入

builder.Services.AddLinguaNexLocalization(options =>
{
    options.LinguaNexApiUrl = builder.Configuration["LinguaNex:ApiUrl"];
    options.Project = builder.Configuration["LinguaNex:Project"];
    options.UseWebSocket = true;
});
builder.Services.AddLocalization();

app.UseRequestLocalization();

Java SDK 接入

public static void main(String[] args) {
        ResourceBundleMessageSource source = new RemoteSourceBundle();
        GlobalProp.initFromYaml(null);
        Locale locale = new Locale("zh-Hans");
        BundleTest test = new BundleTest();
        System.out.println(source.getMessage("40004", null, locale));
    }

JS SDK 接入

const { initLinguaNex, setLocale, getLocale, getAllLocale, L } = linguanex
initLinguaNex({
    baseUrl: 'http://47.119.20.111',
    locales: ["zh-CN", "en"],
    defaultLocale: 'zh-CN',
    project: 'C96755D0-C22C-4DAD-9620-AF64C4C3D9D7'
})
.then(() => {
    console.log(L('Hello'));
    setLocale('aa')
    .then(() => {
        console.log(L('Hello'));
        console.log(getAllLocale());
    })
    console.log(getLocale("zh-CN"));
})

效果图

image

image

image

image

image

image

image

image

RoadMap

  • Project项目管理API
  • Project项目关联API
  • Culture地区管理API
  • Resouce多语言资源管理API
  • OpenApi获取多语言资源
  • SignalR获取多语言资源与实时推送更新多语言资源
  • 自动同步资源到不同Culture
  • 自动翻译资源到不同Culture
  • 集成三方翻译API (目前支持百度,有道,腾讯,阿里机器翻译API)
  • 集成AI翻译
  • 导出JSON多语言文件
  • 导出Toml多语言文件
  • 导出messages.properties多语言文件
  • 导出xml多语言文件
  • 导出TS多语言文件
  • 批量导入多语言配置(JSON)
  • .NET SDK
  • JS SDK
  • JAVA SDK
  • GO SDK
  • PY SDK
  • UI管理界面

About

多语言连接中心 本项目主打一个一处配置多语言,多处使用的想法。

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published